| .github | ||
| .vscode | ||
| build | ||
| dev-guide | ||
| misc | ||
| modules | ||
| scripts | ||
| src-tauri | ||
| test | ||
| web | ||
| .babelrc | ||
| .editorconfig | ||
| .eslintrc.json | ||
| .gitignore | ||
| .prettierrc | ||
| .releaserc | ||
| CHANGELOG.md | ||
| cypress.json | ||
| externals.d.ts | ||
| Gruntfile.js | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| pnpm-lock.yaml | ||
| README.md | ||
| tsconfig.json | ||
| webpack.config.js | ||
JSketcher
===========
JSketcher is a parametric 2D and 3D CAD modeler written for the web. Sketch solver is completely implemented in javascript/typescript.
Please consider supporting this project by becoming a backer
==============
Current Status
==============
JSketcher is a parametric 3d modeler employing a 2D constraint solver for sketches and the feature/history metaphor to build models. The 2D constraint solver is completely written in javascript/typescript and is implemented in both the 3D CAD and the 2D sketcher. Originally developed by xibyte to make models for 3d printing. Today JSketcher provides a rich set of tools for visualizing, selecting/interacting with 3D geometry, tracking and storing model history all built on the foundation of the 2D sketcher engine and employing a custom wasm build of the OpenCascade kernel for solid modeling operations.
Major Components and features
==============
- Geometric Constraint Solver. This is a most crucial component which allows to solve a system of geometric constraints applied to a sketch.
See below the list of supported constraints.
- 2D Sketcher. Allows to design 2d sketches applying geometric constraints. Uses HTML5 canvas for rendering.
- 3D Boolean engine. OpenCascade is used to perform booleans on
BREPobjects. - Feature History. Accumulates features builds a 3d model step by step. A compare step is employed to propagate edge/face IDs forward to provide a stable and robust model.
- Export to STL, DWG and SVG formats
- Saving projects in the browser locale storage
- Repository of dimensions. For example if there is a line length constraint applied, it's not necessary to hardcode some length value.
Note
: A dimension with a symbolic name can be created and the constraint can refer to that dimension by name. Once value of dimension gets changed the sketch is resolved again accordingly to the new dimension values.
- 2D measurement tool. Allows adding dimensions on a 2D drawing(Linear, Vertical, Horizontal and Arc/Circle dimension are supported)
- No any server-side needed. Only client side Javascript and wasm.
This modeler is already used for:
- Designing of 3d models to get them 3d-printed. 3D models are based on parametric
2Dsketches. All models can be exported as an STL file and 3d-printed after. - Creating of 2d parametric sketches which could be exported to DWG or SVG format.
Supported Constraints
=====================
- Coincident
- Vertical
- Horizontal
- Parallel
- Perpendicular
- Point to Line Distance
- Point to Object Distance
- Entity Equality(radius/length)
- Tangent
- Radius
- Point On Line
- Point On Arc / Ellipse
- Point In Middle
- Angle
- Symmetry
- Lock Convexity
- Fillet Meta Constraint
Get Started With the Code
=========================
Install node.js and packages
For this step, you can use any package manager you like.
We recommend using pnpm
npm install -g pnpm
pnpm install
pnpm start
Navigate http://localhost:3000 using your browser. Tested on google chrome but known to work in firefox and edge.
Generate Tauri Build for desktop
=========================
Install Tauri Deps
Run the following command:
chmod +x ./scripts/setup_tauri_dev_linux.sh
sudo ./scripts/setup_tauri_dev_linux.sh
Build for Desktop
pnpm tauri build
The resulting binary will be placed in the dist folder that is generated.
Note
: Build targeting windows from linux requires wine to be installed.
Linux build produces app image and deb for installation.
To use the app image you must do a chmod:
chmod +x jsketcher-*.*.*.AppImage
Contributing Please see .github/CONTRIBUTING.md
=========================