Your compass and straightedge, in JavaScript.
Create line drawings using familiar constructs from geometry and drafting. Initially designated for CNC and laser cutters, Maker.js can also help you programmatically draw shapes for any purpose. It runs in both Node.js and web browsers.
2D Export formats: DXF, SVG, PDF (Requires PDFKit), Jscad CAG object (Requires @jscad/csg)
3D Export formats: Jscad Script, Jscad CSG object (Requires @jscad/csg), STL (Requires @jscad/csg & @jscad/stl-serializer)
- paths - The primitive elements of a drawing are lines, arcs, and circles.
- models - Groups of paths to compose a shape.
- layers - Organization of models, such as by color or tool type.
- chains - A series of lines and arcs that connect end-to-end continuously.
Learn more in the tutorial or API documentation.
-
Drawings are a simple JavaScript object which can be serialized / deserialized conventionally with JSON. This also makes a drawing easy to clone.
-
Other people's Models can be required the Node.js way, modified, and re-exported.
-
Models can be scaled, measured, and converted to different unit systems.
-
Paths can be distorted.
-
Find intersection points or intersection angles of paths.
-
Traverse a model tree to reason over its children.
-
Detect chains formed by paths connecting end to end.
-
Get the points along a path or along a chain of paths.
-
Easily add a curvature at the joint between any 2 paths, using a traditional or a dogbone fillet.
-
Combine models with boolean operations to get unions, intersections, or punches.
-
Expand paths to simulate a stroke thickness, with the option to bevel joints.
-
Outline model to create a surrounding outline, with the option to bevel joints.
-
Layout clones into rows, columns, grids, bricks, or honeycombs
- Belt
- Bezier Curve
- Bolt Circle
- Bolt Rectangle
- Connect the dots
- Dogbone
- Dome
- Ellipse
- Elliptic Arc
- Holes
- Oval
- OvalArc
- Polygon
- Rectangle
- Ring
- RoundRectangle
- S curve
- Slot
- Square
- Star
- Text
- Fonts (Requires opentype.js)
- SVG Path Data
- SVG Points
Visit the Maker.js Playground a sample app to edit and run JavaScript from your browser.
Each of the demos will also open in the playground so that you can explore and modify their code.
Download the browser-based version of Maker.js, then upload it to your website: https://maker.js.org/target/js/browser.maker.js
Add a script tag in your HTML:
<script src="https://maker.js.org/target/js/browser.maker.js" type="text/javascript"></script>
Note: You may also need additional libraries
In your JavaScript, use the require function to get a reference:
var makerjs = require('makerjs');
Add a script tag to your HTML:
<script src="https://cdn.jsdelivr.net/npm/makerjs@0/target/js/browser.maker.js"></script>
To work with Bezier Curves, you will also need a copy of Bezier.js by Pomax
<script src="https://cdn.jsdelivr.net/npm/bezier-js@2/bezier.js"></script>
To work with fonts, you will need both Bezier.js(above) and a copy of Opentype.js by Frederik De Bleser
<script src="https://cdn.jsdelivr.net/npm/opentype.js@0/dist/opentype.js"></script>
In your JavaScript, use the require
function to get a reference:
var makerjs = require('makerjs');
To depend on Maker.js, run this from the command line:
npm install makerjs --save
In your JavaScript, use the require
function to get a reference:
var makerjs = require('makerjs');
There are many ways to contribute to Maker.js:
- โ Star Maker.js on GitHub
- Submit bugs and feature requests on GitHub.
- Create a demo for the gallery.
- Create lessons or videos for the documentation.
- Enhance the website.
- Add features to the Playground app.
- Create a new Maker.js app, and we will link to it here.
- Find some TODO's in the core source code.
- Create unit tests for the core.
Some of these may require a contributor agreement.
Maker.js depends on:
- clone by Paul Vorbach
- bezier-js by Pomax
- graham_scan by Brian Barnett
- kdbush by Vladimir Agafonkin
Maker.js is a Microsoft Garage project. The Microsoft Garage turns fresh ideas into real projects. Learn more at http://microsoft.com/garage.