LamjaCraft 3D
A SMALL 3D WORKSHOP
Debug
Internal model viewthrough the solid
objects 0 · unique solids 0 · copies 0 · V 0 · E 0 · HE 0 · L 0 · F 0
Thread diagnosticsNo run recorded
Each Thread run records its inputs, selected-rim geometry, source B-rep, CSG/B-rep seam diagnostics, validation result, and failure message. Download the JSON after a problematic run and attach it to the bug report.
Rounded Chamfer diagnosticsNo run recorded
Each Rounded Chamfer run records the selected source B-rep, cutter/Boolean counts, CSG/B-rep seam diagnostics, validation result, and failure message. Download the JSON after a problematic run and attach it to the bug report.
Texture diagnosticsNo run recorded
Each Apply records the source B-rep and traversal order, exact parameters and projection, selected faces, document history context, layout, Boolean/reconstruction diagnostics and outcome. The last four attempts remain available through Undo/Redo for comparison. Logs are kept in memory until cleared or the page closes; they are not saved in projects.
Import diagnostics (OBJ/STL)No run recorded
Each geometry check records filename, size, exact settings, stage timings, topology samples, contact work counts, reconstruction attempts and errors with worker stacks. The last four checks survive Undo/Redo. Logs stay in memory until cleared or the page closes. Download after a failure and attach the original STL/OBJ too; the log does not contain the source file.
Geometry engine
TypeScript · standard
WASM accelerates triangulation, mesh welding and BVH construction. Checked embedded sketches and prepared-solid validation can run together in one native kernel. TypeScript owns the editable model, stable IDs and history; unsupported edits use the checked reference path. Compare runs both engines and keeps the TypeScript result. Timings separate preparation, kernel and output; initialization, worker transport and drawing are separate. Enable Measure live for TypeScript timing. Existing unchanged meshes are cached; switch engines to rebuild the view. This choice lasts until the page is reloaded.
Memory diagnostics
Off
Start tracking before creating or copying objects. After a crash, reload the app and use Recover last capture before starting another one. Browsers may round and cache JavaScript heap readings. Direct buffer data is the size of the per-object data prepared for upload.
Performance profiler
Off · enable to measure tools, geometry, mesh, BVH, and snapping.
Fast Scene/Snap events below 0.25 ms are automatically aggregated and cannot push commit/geometry entries out of history.
Rule of thumb: preview should preferably stay below 16 ms. Commit below 50 ms feels fast. Anything above 100 ms should be investigated for algorithmic improvements and/or a Worker.
The debug overlay ignores the depth buffer so hidden points, edges, and construction geometry can be inspected while the model rotates. The JSON copy contains the full runtime topology and can be pasted directly into a bug report.

LIBRARY / SAVE

The project name has changed

IMPORT / GEOMETRY

Import into this project

Select one .lamjacraft.json project, SKP, STL, or OBJ with optional OBJ materials (also as one ZIP holding the OBJ and its MTL files). Import adds contents; Open replaces the project.

OBJ/STL; off by default. Detached open triangle shells are normally imported as limited Open surface objects, including non-planar shells. Enable to omit them instead. Closed shells remain fully editable; branching non-manifold contacts are still rejected. This does not silently cap holes or add thickness.

Repair changes geometry and is off by default. Unrepaired open objects are kept as limited surfaces, as in SKP import. Holes that already have walls stay open. OBJ uses one diffuse object colour; UV/image textures and per-face material assignments are not retained.

Choose scale, then check geometry.

Connected planar triangles are merged where safe; difficult regions keep their triangles. Curved facets and holes are preserved. Solids are checked for closed topology, face planarity and positive volume; limited open surfaces are not solid-editable. It does not exhaustively detect self-intersections. SKP/OBJ/STL checks automatically record an Import log in Debug. For a bug report, download the log and attach the original source file too.

Sketch Editor · 2D

SKETCH EDITOR

Sketch library

Saved sketches stay in this browser profile and site, separate from projects: the project Library never lists sketches and this list never shows projects. A sketch keeps its strokes, guides, measurements and gears for the Sketch Editor. Download all creates a ZIP of the saved sketches; extract it and use Open file in the editor to load one.

Saved sketches

3D PRINTING / REFERENCE

Build plates

Visual references at Z = 0. Plates never affect selection, snapping, modeling, Fit or exported geometry. Settings are saved with the project; changes support Undo/Redo. Opening this dialog cancels unfinished modeling previews and keeps the chosen tool.

Add a plate, then choose its size and position.

X/Y locates the center. Size and position use millimeters. Apply saves the edited fields. Each new plate starts beside the existing plates. Opacity 0% hides its fill and outline.

PLUGINS

Plugin Manager

Plugins are small designer programs: a data-only manifest.json with parameters and one JavaScript file, generator.js, packed as a .lcplugin file. Importing only reads the package; nothing runs until you enable a plugin and click Use. Plugins run in a restricted sandbox without internet, files or access to your projects, and every part they make is checked before you can add it.

Only enabled plugins appear in the left toolbar. Enable disabled plugins here to show them again. Export all downloads every installed plugin, including disabled plugins, in one ZIP. Extract it before importing the .lcplugin files.

Installed plugins

PLUGINS

Built-in examples

Example plugins that ship with this release. Installing one shows the same warning as any other plugin.

PLUGINS / SECURITY

Install plugin?

This plugin contains JavaScript code. Only enable plugins from sources you trust. LamjaCraft runs plugins in a restricted environment and limits what they can access, but no sandbox eliminates every risk. This plugin does not need internet access. You can inspect, disable or remove it at any time.

PLUGINS / SOURCE

Plugin source


PLUGINS / REFERENCE

JavaScript Plugin API


PLUGINS / PROMPT GENERATOR

AI Plugin Creator

Describe the item. LamjaCraft writes an English prompt with the exact plugin API, manifest rules and limits of this version. Paste it into ChatGPT or another AI; it should return a .lcplugin file, or manifest.json and generator.js to import together. Plugins are always JavaScript plus a data manifest, never a JSON geometry format. No data leaves LamjaCraft unless you paste it somewhere yourself.

Tip: you can also attach a photo or sketch of the item in the AI chat as a reference for its shape. Tick the box below so the prompt tells the AI to use it; the sizes still come from the plugin parameters.

PROMPT GENERATOR

AI Model Prompt

Choose what the AI should model and how. LamjaCraft writes an English prompt that asks the AI to build the model from your photo and return a ZIP with an OBJ and an MTL file, ready for Import.

Prompt

What to give the AI

  1. Use an AI that can run code and return files, then paste this prompt.
  2. Attach your photo of the object in the same message.
  3. Download the ZIP it returns (for example ceramic-soap-dispenser-obj.zip).
  4. In LamjaCraft choose Import, select the ZIP, keep units in millimetres, then Check geometry and Import objects.

A single photo gives an approximate model; known measurements under Other requests make it more accurate. If Check geometry reports a problem, send the message back to the AI and ask for a corrected ZIP. LamjaCraft does not contact any AI service or upload your photo.

OBJECT SUBTRACTION

Subtract objects

For a group: select one ungrouped target first, then Shift/Ctrl/Cmd-click the cutter group and choose Subtract selected. All group members participate, including hidden members.

The overlap is removed from the target. The cutter is consumed unless Keep cutter is checked. One Undo restores all original objects and the cutter group. If the cut separates the target, each material piece becomes a separate object. No overlap changes nothing; full coverage removes the target.

Message history

Recent messages and errors from this session. Select a message to read or copy it. The latest 100 messages are retained until this page is reloaded.

No messages yet.

OBJECT / GEOMETRY CHECK

Object check

What this check covers

All face loops and edge connections, opposite edge pairing, short edges, planar faces, loop orientation and area, triangulation, and positive finite volume. Coordinates and face planes must be finite.

This is the current geometry kernel's integrity check. It does not exhaustively test surface self-intersections or predict whether future Boolean operations will succeed. No geometry is repaired or changed.

LAMJACRAFT / ABOUT

LamjaCraft 3D

A free, offline 3D workshop

FreeMIT licensedOfflineExperimental

Created and directed by Arvid Mortensen

Developed with ChatGPT and Claude

LamjaCraft 3D is provided free of charge and the standalone HTML file can run entirely offline in a modern browser.

LamjaCraft 3D is an experimental direct solid-modeling workshop. Keep backups of important project files and verify exported geometry before manufacturing or printing.

File format · .lamjacraft.json

The complete native file specification: field types, required and optional values, editable geometry and references. Includes a small, complete 10 mm cube example at the end.

Read the file format specification

LamjaCraft native file format

LamjaCraft projects are editable UTF-8 JSON documents with the filename extension .lamjacraft.json and MIME type application/json. This specification describes the field types, required values and geometric constraints for compatible readers and writers.

1. Encoding and data types

The file is one UTF-8 JSON document. Comments, trailing commas, executable code, placeholders and Markdown fences are not part of the file format.

Type terminology:

  • string: JSON text.
  • number: a finite JSON number, allowing integer or decimal values. Numbers must remain finite when parsed as IEEE-754 binary64.
  • integer: a JSON number with no fractional value.
  • boolean: JSON true or false.
  • Vec3: an array of exactly three finite numbers in XYZ order.
  • array<T>: a JSON array whose elements have type T.

Do not encode numbers or booleans as strings. Do not use null for optional fields; omit them instead. All identifiers are nonempty strings, including identifiers that contain digits.

This specifies the canonical writer contract: emit the required fields described below even where the current reader provides permissive defaults.

2. Root document

The root is an object with these fields:

FieldTypeRequirement
formatstringRequired; exactly "lamjacraft-3d".
versionintegerRequired; 7, 8, 9, 10, 11, 12 or 13.
unitsstringRequired; exactly "mm".
namestringRequired; project name, at most 80 characters.
solidsarray of canonical solid objectsFormat 13 only; solids that two or more objects share (§4.1). Omit it when no solid is shared.
objectsarray of polygon-based solid or open-surface objectsRequired.
groupsarray of groupsEmit this field; use an empty array when unused.
assemblyobjectFormat 12 only; contains connectors, joints and optional anchors. Omit it when the project has no connectors and no anchors.
constructionobjectRequired; contains guides, an array of construction guides.
annotationsobjectEmit this field; contains dimensions, an array of dimension annotations.
referencesobjectOptional; contains buildPlates, an array of build plate references.

An empty project can be opened, but importing a project requires at least one object or reference to add.

Use version 7 for solid-only projects, version 8 when a construction plane includes a surface height grid, and version 9 whenever the project contains open surface objects. Use version 10 whenever any object has a nonzero shininess. Use version 11 whenever the file contains an angular dimension. Use version 12 whenever the file contains an assembly. Use version 13 whenever the file contains solids. Each version accepts every field of the lower versions. All seven versions use polygon-based geometry. File-format versions are independent of application release numbers.

Do not invent additional persistent fields. Camera state, selections, tools, clipboard contents, undo history and rendering caches are not part of this format.

3. Coordinates and transforms

Use right-handed XYZ coordinates with Z pointing upward. All positions, lengths and distances are in millimetres.

Solid vertex positions are object-local. Each object has a rigid transform:

  • position: Vec3; world translation in millimetres.
  • rotation: Vec3; XYZ Euler angles in degrees, not radians.

Rotate local coordinates around the local origin in this order: X, then Y, then Z. Apply translation last. For column vectors, the convention is world = Rz × Ry × Rx × local + position.

There is no scale or pivot field. Bake scaling into vertex coordinates. For simpler generated files, bake placement into vertices and use zero translation and rotation.

Construction guides, build plates, dimension world points and dimension fallback positions use world coordinates.

4. Solid objects

Every element of objects has these fields:

FieldTypeRequirement
idstringRequired; unique across all objects.
namestringRequired; at most 80 characters.
kindstringRequired; "solid" for closed editable material geometry, or "surface" for limited open polygon geometry (format 9 or later).
colorstringRequired; a six-digit hexadecimal color beginning with #.
shininessnumberOptional in format 10; finite value from 0 (matte) to 100 (glossy). Defaults to 0; canonical writers omit zero.
transformobjectRequired; contains required position and rotation, both Vec3.
solidcanonical solid objectRequired unless solidRef is present; described below.
solidRefstringFormat 13 only; the id of an entry in the root solids array, in place of solid (§4.1).
hiddenbooleanOptional; default false.
lockedbooleanOptional; default false.

Color and shininess belong to the whole object. Groups apply appearance edits to their members; groups carry no separate material. Shininess changes the view-dependent specular highlight in Presentation rendering and Presentation PNG exports. Hidden and locked objects still contain ordinary persistent geometry.

Each canonical solid has:

FieldTypeRequirement
schemastringRequired; exactly "poly-brep-1".
idstringRequired for generated files; solid identifier.
metadataobjectRequired for generated files; may be empty. Its supported optional descriptive field is name, a string.
verticesarray of verticesRequired.
facesarray of facesRequired.

Each vertex has:

  • id: string, required and unique within that solid’s vertices.
  • position: Vec3, required and expressed in object-local coordinates.

Each face has:

  • id: string, required and unique within that solid’s faces.
  • outer: array of strings, required; ordered vertex IDs defining its outer boundary.
  • holes: array of arrays of strings; emit an empty array when the face has no holes. Each inner array defines one hole boundary.
  • material: optional string tag.
  • boundaryGroup: optional string identifying related face boundaries.
  • provenance: optional object with required string kind and optional string label. Allowed kinds are "primitive", "pushpull", "split", "import" and "boolean".

Optional face tags can be omitted when generating new geometry. Preserve existing tags when editing existing files faithfully.

Vertex and face IDs are local to a solid and may be reused in different solids. References are vertex IDs, never numeric array indices or embedded coordinates. Array order does not establish identity.

Do not write runtime half-edges, topology loops, face planes or normals. LamjaCraft reconstructs them from the face boundaries. The internal "brep-1" representation is not the native file schema.

4.1 Shared solids (format 13)

Several objects may use the same canonical solid, each with its own id, name, kind, color, shininess, visibility, lock and transform. Such a solid is written once as an entry of the root solids array, a canonical solid object as described above, and every object that uses it has solidRef set to that entry's id instead of a solid field.

  • Every solids entry has an id that is unique within solids.
  • An object has exactly one of solid and solidRef; solidRef must name an entry of solids.
  • Every entry must be referenced by at least one object, and all objects that reference one entry have the same kind. The geometry rules of §5 apply to the entry for that kind.
  • solids and solidRef are allowed only in version 13. Writers use them only when two or more objects share a solid and keep the lowest version the file needs otherwise.

Readers check each entry once and give every referencing object the same solid. Editing one of those objects later gives it its own solid; the others are unchanged.

5. Mandatory geometry rules

Objects with kind: "solid" must represent a valid closed material boundary. Use separate objects for disconnected solid parts. Objects with kind: "surface" may contain open polygon sheets and are not editable with solid modeling tools; they are movable, rotatable, copyable, recolorable and persistable. In open surfaces a boundary edge may occur only once and face winding need not enclose a volume. Every polygon must still be planar, valid and triangulable; open surfaces cannot participate in solid boolean operations or solid-only exports.

All face boundaries must satisfy these rules:

  1. Each boundary contains at least three distinct vertices. Closure is implicit: do not repeat the first vertex at the end.
  2. Boundaries are simple, without repeated vertices, crossing edges or zero-length edges.
  3. Every referenced vertex exists, and every declared vertex is used by a face boundary.
  4. Adjacent faces share the same vertex IDs. Separate coincident vertices do not establish shared topology.
  5. Every undirected edge appears exactly twice across the solid’s boundaries, once in each direction.
  6. No T-junctions are allowed. If an edge is subdivided, subdivide it consistently on both adjoining faces.
  7. Outer boundaries wind counter-clockwise when viewed from outside the material. Hole boundaries wind oppositely. Faces around an internal cavity point into that cavity.
  8. Every face is planar, including all its hole vertices. Triangulate non-planar patches.
  9. Hole boundaries lie strictly inside their outer boundary and do not touch or intersect it or other holes.
  10. Faces and edges have usable nonzero area and length, and total signed material volume is finite and positive.

A face hole alone does not create a complete hollow solid. Include the inner walls and connecting faces needed to close the material boundary.

Avoid duplicate faces, self-intersecting surfaces, overlapping shells and zero-thickness material. Do not assume the native reader will weld, repair or reorient invalid geometry.

Curved solid surfaces are faceted approximations made from planar polygons or triangles. The solid schema does not store analytic cylinders, spheres, splines or NURBS surfaces.

The importer checks topology, edge pairing, coordinates, planarity, loop orientation, triangulation and positive volume. It does not exhaustively detect every surface self-intersection or guarantee that later Boolean operations will succeed. Validate generated geometry independently.

6. Groups

Each group has:

  • id: string, required and unique across groups.
  • name: string, required for generated files; at most 80 characters.
  • objectIds: array of strings, required; at least two different existing object IDs.

A group cannot contain groups. Each object can belong to at most one group. Groups organize objects without changing geometry or adding a transform.

6.1 Connectors and joints (format 12)

Connectors and joints link rigid bodies; a body is a group, or an ungrouped object. They never change geometry or transforms. assembly.connectors and assembly.joints are arrays; use an empty joints array when no connector is linked. Optional assembly.anchors lists object IDs whose bodies stay in place when joints move; each ID appears once and names an existing object, and anchoring one member of a group anchors the whole group.

Each connector has:

  • id: string, required and unique across connectors.
  • objectId: string, required; an existing object ID.
  • pole: string, required; "north" or "south". A north connector attaches to a south connector.
  • frame: object, required, in the object's local coordinates: origin (Vec3), z (Vec3, the outward axis, nonzero) and x (Vec3, the twist reference, not parallel to z). Writers emit unit, perpendicular z and x; readers normalize them.
  • type: string, required on north connectors and absent on south connectors; "fixed", "revolute" (hinge) or "prismatic" (slide).
  • symmetry: integer, optional on north connectors only; 1 to 360 equal twist steps used when snapping.
  • label: string, optional; at most 80 characters.

Each joint has:

  • id: string, required and unique across joints.
  • north, south: strings, required; IDs of a north and a south connector on different objects. A connector belongs to at most one joint.
  • type: string, required; "fixed", "revolute" or "prismatic".
  • placement: object, required; twist (number, degrees) and offset (number, mm). The south frame is seated at joint value 0 when, in north frame coordinates, it equals a translation of offset along z, then a rotation of twist about z, then a half turn about x: origins meet, axes face each other.
  • limits: object, required; optional min and max numbers with min not above max. Hinge limits are degrees from -180 to 180, slide limits are millimetres, and a fixed joint has no limits.

A hinge value is the twist beyond placement.twist; a slide value is the offset beyond placement.offset. Values are derived from object transforms and are not stored. A joint whose frames no longer match its motion, for example after one part was moved alone, is still valid. Both connectors of a joint may belong to one group; such a joint is inactive while grouped.

7. Construction guides

Every guide has a required nonempty string id, unique across guides, and a required string kind. All guide kinds support an optional string label.

The supported kinds and their fields are:

  • "point": required point, Vec3.
  • "line": required point, Vec3, and direction, Vec3. Optional planeNormal, Vec3, describes a support plane and must be perpendicular to the direction.
  • "circle": required center, Vec3; normal, Vec3; and radius, number. Radius must be at least 0.00001 mm.
  • "plane": required origin, Vec3, and normal, Vec3. Optional axis, Vec3, specifies an in-plane direction. Optional surface, a height-grid object, requires file version 8.

Emit unit-length direction and normal vectors. A plane axis must be perpendicular to its normal. Lines and flat planes are infinite references. Guides do not themselves create solid geometry.

For a plane containing surface, both normal and axis are required perpendicular unit vectors, with length and perpendicularity errors no greater than 1e-7.

The surface object has:

  • width: number, required; from 1 to 10,000 mm.
  • height: number, required; from 1 to 10,000 mm.
  • columns: integer, required; from 2 to 30 grid points.
  • rows: integer, required; from 2 to 30 grid points.
  • heights: array of numbers, required; exactly columns × rows entries, each from -10,000 to 10,000 mm.

Grid heights are stored in row-major order, with column varying fastest. Let u = axis, n = normal and v = cross(n,u).

For zero-based column c and row r, entry index is r × columns + c. Its world position is:

origin + u × (c × width / (columns−1) − width/2) + v × (r × height / (rows−1) − height/2) + n × heights[index].

Each grid cell is divided along the diagonal from its lower-left to upper-right corner. Its triangles are lower-left/lower-right/upper-right and lower-left/upper-right/upper-left. This creates a piecewise planar height field. Outside the grid footprint, edge heights continue along the in-plane axes; corner heights remain constant.

8. Dimension annotations

Each dimension has:

  • id: string, required and unique across dimensions.
  • kind: string, required; "linear", or "angular" in format 11.
  • label: optional string, at most 80 characters.

A linear dimension also has:

  • a: required endpoint anchor.
  • b: required endpoint anchor.

An angular dimension (format 11) also has:

  • mode: string, required; one of "corner", "faces", "lines", "line-plane" or "planes".
  • anchors: required array of anchors; its length and meaning depend on mode:

- corner, 3: the vertex, then one point on each arm. The angle between the two rays, 0–180°. - faces, 4: two points on the shared edge, then one point inside each face. The angle between the two half-planes, 0–180°. - lines, 6: two points on the first line, a picked point near it, two points on the second line, a picked point near it. Crossing lines give the angle of the sector that holds the picked points; parallel or skew lines give the acute angle between their directions. - line-plane, 5: two points on the line, then three non-collinear points of the plane. The angle between line and plane, 0–90°. - planes, 6: three non-collinear points of each plane. The acute angle between the planes.

Do not store a separate numeric dimension value. The application computes the world-space distance between the resolved endpoints of a linear dimension, and the angle from the resolved anchors of an angular dimension.

Each anchor has one of these forms:

  • World anchor: kind is "world"; required point is Vec3.
  • Vertex anchor: kind is "vertex"; required objectId and vertexId are strings; required fallback is Vec3.
  • Edge anchor: kind is "edge"; required objectId, vertexA and vertexB are strings; required t is a number in [0,1]; required fallback is Vec3.

Vertex anchors resolve a local vertex through its object transform. Edge anchors interpolate from vertexA to vertexB using t, then apply the object transform.

For generated files, reference existing objects and vertices; edge endpoints should belong to an actual edge. Always provide a finite world-space fallback for object-linked anchors. Missing identities resolve to the fallback; Import converts unresolved object-linked anchors into world anchors.

Do not reference runtime half-edge IDs.

9. Build plate references

The optional root references object contains buildPlates, an array. Each plate has:

  • id: string, required and unique across plates.
  • name: optional string, at most 80 characters; defaults to "Build plate".
  • width: number, required and greater than zero.
  • depth: number, required and greater than zero.
  • x: number, required.
  • y: number, required.
  • color: string, required; six-digit hexadecimal color beginning with #.
  • opacity: number, required; in [0,1].
  • visible: optional boolean; defaults to true.

A plate is a visual rectangle on world Z=0, centered at x/y. Its dimensions and position use millimetres. Its bounds must remain finite when converted to IEEE-754 float32. It is not solid geometry and cannot be a group member.

10. Size limits and interoperability

Current limits are:

  • File size: 512 MiB.
  • Objects: 5,000 (2,000 before v0.9.345).
  • Groups: 300.
  • Construction guides: 20,000.
  • Dimensions: 20,000.
  • Connectors: 10,000.
  • Joints: 5,000.
  • Build plates: 128.
  • Per solid: 1,000,000 vertices, 1,000,000 faces and 8,000,000 total boundary segments, including hole boundaries.

These are implementation ceilings, not recommended target sizes. Prefer moderate geometry and avoid excessive faceting.

Before saving or exporting, validate field types, required fields, identifier uniqueness, references, array lengths, version requirements and all geometry rules.

Open validates and replaces the current document. Import validates and appends contents using fresh document IDs, remapping group members, connectors, joints and object-linked dimension anchors while preserving placement. Local vertex and face IDs remain local to their solids. An import may overlap existing objects.

Save Project and Entire model native Export preserve objects, groups, connectors, joints, guides, dimensions and build plates. Selected native Export keeps selected objects, groups with at least two included members, connectors of selected objects, joints whose two connectors are included, and dimensions with at least one included object-linked anchor and all their object-linked anchors included. It omits guides, build plates and unrelated world-only dimensions and chooses the lowest version its contents need: 7 for solids only, 9 with open surfaces, 10 with nonzero shininess, 11 with an angular dimension, 12 with connectors and 13 when two or more included objects share a solid. Import keeps the sharing inside the added objects.

12. Small complete example

This format 7 file describes a 10 mm cube from Z=0 to Z=10, with eight shared vertices and six outward-facing planar faces. The example is a complete importable project.

{
  "format":"lamjacraft-3d", "version":7, "units":"mm",
  "name":"Native format sample",
  "objects":[{
    "id":"o1", "name":"10 mm cube", "kind":"solid", "color":"#b7cec9",
    "transform":{"position":[0,0,0],"rotation":[0,0,0]},
    "solid":{
      "schema":"poly-brep-1", "id":"s_o1", "metadata":{},
      "vertices":[
        {"id":"v1","position":[0,0,0]},
        {"id":"v2","position":[10,0,0]},
        {"id":"v3","position":[10,10,0]},
        {"id":"v4","position":[0,10,0]},
        {"id":"v5","position":[0,0,10]},
        {"id":"v6","position":[10,0,10]},
        {"id":"v7","position":[10,10,10]},
        {"id":"v8","position":[0,10,10]}
      ],
      "faces":[
        {"id":"f1","outer":["v1","v4","v3","v2"],"holes":[]},
        {"id":"f2","outer":["v5","v6","v7","v8"],"holes":[]},
        {"id":"f3","outer":["v1","v2","v6","v5"],"holes":[]},
        {"id":"f4","outer":["v2","v3","v7","v6"],"holes":[]},
        {"id":"f5","outer":["v3","v4","v8","v7"],"holes":[]},
        {"id":"f6","outer":["v4","v1","v5","v8"],"holes":[]}
      ]
    }
  }],
  "groups":[], "construction":{"guides":[]}, "annotations":{"dimensions":[]}
}

Source code

Version 0.9.395 · Copyright © 2026 Arvid Mortensen

Download the buildable TypeScript and C++ sources, including the checked WASM module, for this exact version. Tests and example models are excluded.

Included in this HTML file. No internet connection is needed.

Licenses

MIT License · application code
MIT License

Copyright (c) 2026 Arvid Mortensen

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Third-party notice · DejaVu font outlines

The embedded DejaVu outlines retain their original font license.

Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: DejaVu fonts
Upstream-Author: Stepan Roh <src@users.sourceforge.net> (original author),
                  see /usr/share/doc/fonts-dejavu-core/AUTHORS for full list
Source: https://dejavu-fonts.github.io/

Files: *
Copyright: Copyright (c) 2003 by Bitstream, Inc. All Rights Reserved. 
 Bitstream Vera is a trademark of Bitstream, Inc.
 DejaVu changes are in public domain.
License: bitstream-vera
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of the fonts accompanying this license ("Fonts") and associated
 documentation files (the "Font Software"), to reproduce and distribute the
 Font Software, including without limitation the rights to use, copy, merge,
 publish, distribute, and/or sell copies of the Font Software, and to permit
 persons to whom the Font Software is furnished to do so, subject to the
 following conditions:
 .
 The above copyright and trademark notices and this permission notice shall
 be included in all copies of one or more of the Font Software typefaces.
 .
 The Font Software may be modified, altered, or added to, and in particular
 the designs of glyphs or characters in the Fonts may be modified and
 additional glyphs or characters may be added to the Fonts, only if the fonts
 are renamed to names not containing either the words "Bitstream" or the word
 "Vera".
 .
 This License becomes null and void to the extent applicable to Fonts or Font
 Software that has been modified and is distributed under the "Bitstream
 Vera" names.
 .
 The Font Software may be sold as part of a larger software package but no
 copy of one or more of the Font Software typefaces may be sold by itself.
 .
 THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,
 TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL BITSTREAM OR THE GNOME
 FOUNDATION BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING
 ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
 WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
 THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM OTHER DEALINGS IN THE
 FONT SOFTWARE.
 .
 Except as contained in this notice, the names of Gnome, the Gnome
 Foundation, and Bitstream Inc., shall not be used in advertising or
 otherwise to promote the sale, use or other dealings in this Font Software
 without prior written authorization from the Gnome Foundation or Bitstream
 Inc., respectively. For further information, contact: fonts at gnome dot
 org.

HELP

Help

LOCAL PROJECT LIBRARY

Project library

Saved projects stay in this browser profile and site. Autosave writes a separate working copy. Use Save or Replace to update a saved project. Download keeps a portable backup.

Back up regularly. Use Download all to keep a ZIP outside the browser. Clearing site data, browser reset or automatic storage cleanup can remove this local library and its working copies. The ZIP contains saved projects only: use Save first to include your latest edits. Extract the ZIP, then use Open file to open a project.

Saved projects

Autosaved working copies

Each session keeps its own working copy. Load opens a copy without changing a saved project. Up to 10 copies are kept; autosave removes the oldest when the limit is reached.

START

What would you like to open?

LAMJACRAFT 3D / QUICK START

Direct face editing in millimetres

Use the ? beside the active tool name, Selected object or Objects for contextual instructions. Settings are in the right-hand Tool panel. LamjaCraft runs locally from this HTML file; curved forms are editable planar facets.

Tools stay active after an operation. Escape first cancels numeric entry, then the pending tool step; Escape while idle returns to Objects/groups. Ground profiles temporarily use Push/Pull for a positive height and then return to the drawing tool. Explicit toolbar/shortcut changes discard the pending operation. Orbit/pan preserves it; Undo/Redo clears transient previews and keeps the chosen tool. Native dialogs handle Escape, and a busy background job uses Escape as Cancel. New/Open project resets to Objects/groups.

Tools and shortcuts

Edit

ToolWhat to do
Objects/groups · VObjects and Groups is the default. Click or drag a frame through visible geometry. Objects selects individual visible group members; Groups ignores ungrouped objects. In Objects and Groups or Groups mode, hitting a group member selects the entire group, including hidden members. Shift/Ctrl/Cmd-click toggles a target; modifier frames add targets. Frames select through visible objects rather than just frontmost surfaces. Escape cancels a frame. Guides and dimensions can be inspected in Objects and Groups mode. Dedicated tools pick faces, edges and points.
Copy · Ctrl/Cmd+CCopy the selected objects or complete groups to the internal object clipboard. Copies retain geometry, appearance and relative placement. Copy does not change the model. The clipboard remains available after New/Open while this HTML file stays open; focused text fields keep normal text copying.
Paste · Ctrl/Cmd+VStart Move placement of the copied selection. Move the pointer and click, or use the Move axis and numeric controls. Escape cancels the placement. Complete copied groups keep their membership, including hidden members; copies are unlocked. One Undo removes the entire paste.
Delete tool · DChoose target categories in the Tool panel. Objects, Groups, Edges · flatten / trim, Points · dissolve / trim and Faces · remove default off; sketches, holes, pockets, protrusions, guide lines/circles and dimensions default on. For Points, hover a highlighted model point, wait for the checked closing-face preview and click. Convex corners are cut back; redundant/flat points keep the shape. Other points stay exact. One Undo restores the edit. Pending or rejected points do not delete another target. Only enabled targets are highlighted and deleted. Click a flat sketch region or its outline to remove the sketch without changing the solid shape. Disabled sketches and feature rims do not fall through to whole-object deletion. Groups deletes all members. Faces · remove deletes the clicked face: a closed solid becomes an open surface, and removing a surface's last face deletes the object. Keyboard Delete and property buttons still act on the selected entity.
Move · MObject (default) moves every selected object together, including multiple groups and extra objects. Click a selected object to keep the selection; an unselected target starts a new selection. Click a guide line or guide circle in Object mode to move it with the same axes, snapping and numeric distance. Point moves one highlighted corner on an ungrouped model. Only one mode is active. Click → move → click or drag → release; choose XY/X/Y/Z. Other corners stay fixed; warped faces are triangulated. Snap to grid rounds mouse displacement to the chosen mm step; typed distances and exact geometry targets remain exact. While Move is active, X/Y/Z locks an axis and A restores XY. Positive typed distances continue the mouse direction in XY or X/Y/Z; negative distances reverse it. The direction is fixed while typing. With no prior motion, a locked axis uses its positive world direction.
Rotate · QPicked face is the default: click a selected face to set its normal and center as one axis and pivot for all selected objects. World XY/XZ/YZ uses global Z/Y/X; objects, groups and mixes pivot around their own bounds center, never the world origin. The complete selection rotates as one rigid arrangement, including multiple groups and extra objects. Drag, click → move → click, or enter an exact angle. Positive typed angles continue the rotation direction chosen with the mouse; negative angles reverse it. The direction stays fixed while editing the number. Without prior motion, positive follows the chosen plane normal.
Scale · WScales the selected objects, groups or both about one pivot (bottom center, selection center or world origin). Drag in the view for a uniform scale, or type percentages or target sizes in mm per axis in the Tool panel. Uniform keeps proportions; separate X/Y/Z factors need objects that are not rotated off the world axes. One Undo step.

Reference

ToolWhat to do
Guide Line · GClick two free points for a guide line. Click an edge or existing guide for a parallel offset, then move or type a distance in mm and press Enter. Show through solids affects drawing only.
Guide Circle · JClick the center on a face or ground, then choose a radius by pointer or direct numeric input. The panel uses Diameter. Center and circumference are available for snapping without changing the solid.
Measure · TClick two points on ground or model faces. The passive dimension can follow geometry anchors; it does not drive the model.
Angle · toolbarClick two references: model edges, planar faces, guide lines, guide circles or guide planes. Edges that meet at a corner give the corner angle. Faces that share an edge give the angle between them, for example 90° on a box or 135° on a 45° chamfer. Other pairs give the acute angle and its supplement. The angle is stored as a passive dimension in the project, like Measure, and follows the referenced model geometry. Select or Delete it like any dimension.
Face Center · toolbarHover a planar face and click to add two crossing guide lines through its center. Auto finds the exact center of a round face or a round hole (gear bore) and otherwise uses the area centroid; Area centroid and Bounds center can be chosen in the Tool panel. One Undo step.
Build Plates · toolbarOpens Build plates: add one or more rectangular 3D-printer bed references on Z = 0 with width, depth, center, color, opacity and visibility. Plates are saved in the project and support Undo/Redo, but never affect picking, snapping, Fit, editing or export.

Sketch

ToolWhat to do
Rectangle · RDrag a rectangle or click its start, type width×height (for example 20x10) and press Enter. Draw on a face for a clipped region, or on ground followed by height selection.
Circle · CChoose 3–128 segments in the Tool panel; 6 makes a hexagon. Click center and radius or type the radius in mm. Radius reaches a polygon corner. Ground circles continue to height selection.
Arc · AStart on a face edge, choose an endpoint on an edge, then a curvature point. Start → curvature → endpoint also works. The connected face boundary closes the region; portions outside the face are clipped.
Contour · LClick points on a face or ground. Close at the start or press Enter; Backspace removes the last point. Start and finish on the same connected face boundary for an edge-to-edge region. Ground profiles continue to height.
Editor · toolbarChoose Sketch → Editor with a planar model face selected, or choose Editor and click a face. Draw in a separate 2D workspace using Line, Rectangle, Circle, three-point Arc and Text. Text places closed letter contours that you can edit as strokes. Endpoint snapping joins strokes drawn in separate steps. Guide and Measure are temporary aids. Select drags shared points or deletes strokes; Add exact enters line deltas, rectangle dimensions or circle radius after choosing the first point. Editor Undo/Redo is local. Return checks closed, non-intersecting contours; fix marked errors before continuing. Position the origin with the mouse on the source face and click to insert all contours in one model Undo step. Face clipping still applies. Escape during placement returns to editing. Drafts and construction aids are discarded when cancelled and are never saved as separate sketches.
Text · SketchHover a solid face or ground XY for a preview and click to place the lettering. On a face, switch to Push/Pull to move letter faces individually. On the ground, set a common extrusion height for the letters.

Modify

ToolWhat to do
Push/Pull · PSnap uses points visible in the viewport and ignores the active face's own sketch corners, midpoints and centers. Hovering a flat face parallel to the moving face (for example the top of another object) aligns it with that face (Face height); the height step after drawing on the ground snaps the same way. Zoom, orbit and pan preserve the current depth and update mouse scaling. Click/drag a logical face and type an exact distance, then Enter. Positive typed distances continue the chosen mouse direction; negative distances reverse it. Without prior motion, positive is outward. The panel uses + out / − in. Choose Proportional Taper to scale the whole section, including holes, or Edge angle for equal wall slopes. Taper and Twist can be combined. With both at 0°, ordinary Push/Pull previews the validated result as a wire outline; nonzero taper or twist uses a wire sweep preview and cancellable background generation. Max inset applies only to ordinary pulls.
Chamfer · H / UOne tool for bevels and rounded edges. Choose Rounded in the Tool panel; H selects a bevel and U selects rounded mode. Choose Cut for convex edges or Extend to add material at convex or concave corners. Profile angles from 2° to 178° are supported. Hover from the face that should own the base distance. Setback bias 45° gives equal distances on both faces. Distance/Base setback and bias carry across mode changes; Curve segments controls rounded faceting. Bevel hover previews the result. A normal click applies immediately. Ctrl-click selects individual straight sides. Shift-click follows connected segments turning less than 45° at each vertex. Keep Shift held to add more chains/rims on the same object; click an entirely selected chain again to remove it. Release the last modifier to apply every group in one Undo step. Escape cancels. Rounded hover highlights the side/rim; click generates the result with progress and Cancel. Ctrl side selection and Shift chain selection also work in rounded mode; release starts one combined background operation. Equal setbacks (45° bias) give a circular tangent profile; other biases use a tangent ellipse.
Smooth EdgesApply a Gaussian blur to the whole surface of one closed solid, including hole rims. Blur controls strength in millimetres. Sampling is automatic. Allow topology changes is selected by default. Apply runs in the background with Cancel. Undo restores the original object.
Engrave / Emboss Text · ModifyEnter up to four centered lines in one of three embedded fonts. Hover to preview, click the text center, then Apply Text for raised or engraved geometry. Local surface follows planar or connected faceted areas. Wrap around cylinder supports the seam and optional full-turn spacing without stretching letters. Cone/frustum and sphere wrapping follow their changing circumference and distort letters toward tips or poles. Choose the object-local axis, stay clear of caps/openings and keep depth within the wall. Generation supports progress, Cancel and one Undo. The text becomes ordinary geometry; its original string is not retained as an editable feature.
LithophaneLoad a PNG/JPEG/WebP/BMP image, use Paste image, or press Ctrl+V / Cmd+V while Lithophane is active. Click a planar solid face to place the image center. Engrave into face removes material inward (default); Raise from face builds outward. Set minimum depth/height to 0 to start directly on the face. Dark pixels retain more material by default; Reverse brightness swaps polarity independently of direction. Set width, height, rotation and U/V offsets. Lock aspect ratio preserves proportions; Mirror flips horizontally; Gamma adjusts midtones. Detail spacing supports up to 65,536 cells / 131,072 roof triangles. Dense previews are sampled; Apply includes every detail and runs in a background worker with progress and Cancel. Keep the complete image inside one face, clear of edges and holes, and engraving inside the solid. One Undo restores the original object.
Surface Texture · toolbarChoose Planar patch (13 patterns) for nearby faces, or Wrapped band (9 patterns) for periodic rows around a tapered round object. Select up to 1,000 faces on one ungrouped object. Select full ring and Add neighbors extend a band. Apply creates raised/recessed exportable geometry with progress and Cancel.
Merge Faces · toolbarClick edge-connected faces on one ungrouped object, including split triangles, then press Merge Faces or Enter. The largest selected face supplies the reference plane unless you choose another. Adjust neighboring faces may flatten a curved area and move boundary points up to Maximum adjustment; turn it off for a coplanar merge with fixed points. The checked merge is applied at once and reports any point movement and volume change. Invalid or over-limit results are rejected; one Undo restores the edit.
Add Edge · EJoin two highlighted open-boundary points of one open surface by click-click or press-drag-release. Every side of the new edge that one flat face can close is filled, with a green preview first; an edge that closes no flat side is rejected. Close non-flat openings step by step, for example with triangles. When no open edge remains the object becomes a closed solid. Ctrl/Cmd+click an open edge to insert a new point there (the midpoint snaps) for further edges. Esc clears the first point; one Undo removes each edge or point.
Carve Out · toolbarSelect one planar opening, set Wall thickness and Minimum inner detail, then Carve Out. The inset is an opening cue. Convex solids, straight-extruded concave prisms (L/U/T) and checked concave 3D offsets are supported. Straight prism offsets can consume short edges or split the cavity into several surviving pockets. Protrusions/recesses may continue into the cavity; invalid offset topology and openings with holes are rejected. Progress, Cancel and one-step Undo are available.
Split Plane · toolbarUse New plane · 2 snapped points, then drag the green move or orange tilt handle. XY/XZ/YZ and face/ground creation are also available. Choose normal, surface width/height or World X/Y/Z for movement; either surface axis or a world axis for tilt. Edit curved surface creates a 2–30 by 2–30 point grid; drag points with Influence radius, then Place / split. Beyond the grid the surface extends straight from its boundary heights. Save template / Load surface template reuses the shape independently of placement. One plane is kept at a time. Click an ungrouped solid to split; Undo restores the object and consumed plane.
Mirror · toolbarSelect objects or groups, then choose Picked face or World XY/XZ/YZ. Click any model face, including another object’s face, to define an infinite mirror plane. World planes pass through the global origin. Keep original is on by default and creates mirrored copies; turn it off to reflect the selected objects in place. Complete groups retain membership and hidden members; partial group selections create individual copies. Closed solids and unlocked targets are required. Apply Mirror or Enter commits one Undo step. Escape clears the chosen plane.
Revolve · toolbarClick a face as the profile, then a straight edge or guide line in the plane of that face as the axis. The axis may touch the face but must not cross it. Set From, To and Segments, then Apply Revolve. 0° is where the face lies, and angles turn about the axis by the right-hand rule. To goes up to 720° so that a part can pass 0°, for example 300° to 420°; one full turn is the longest. A hole in the face becomes a closed hollow inside a full turn, and a tunnel through the end faces on less than a full turn. A sketch region becomes the solid, as with Push/Pull; a face of a solid stays.
Sweep · toolbarClick a face as the profile, then another face whose outer edge is the path. The profile's centre follows that edge all the way round, so the profile can lie anywhere, for example flat on the ground. Rotate, Outward, Up and Flip place it on the path. From and To choose the part of the edge: 0° is a standard corner, 360° is the whole way round, and To goes up to 720° so that a part can pass 0°. Then Apply Sweep. A part of the edge gets two end faces. A hole in the profile becomes a closed hollow on the whole edge, and a tunnel on a part of it. A sketch region used as the profile becomes the solid, as with Push/Pull; the path face stays.

Mechanical

ToolWhat to do
Involute Gear · IPlace the center and rotate the preview. Choose external teeth (optional center hole) or Internal teeth (ring with Outer Ø; 0 is automatic). Teeth, Module, Pitch circle, pressure angle and quality update during placement. Internal tooth flanks widen outward toward the roots. Ground placement continues to height; face placement creates an ordinary region with the toothed opening.
Gear Rack · KPlace the left pitch-line point, rotate its direction, then click. Module and pressure angle follow the gear convention. Settings remain live until placement; ground profiles continue to height selection.
Bolt Circle · BPlace the pattern center, rotate the first circle, then click. Face placement creates separate circle regions. Ground placement creates separate pins with one shared height gesture and one Undo step.
Slot · SPlace the center, choose direction, then click. Overall length includes the rounded ends. Length, width and curve quality remain live during placement.
Arc Slot · toolbarPlace the arc center, rotate the middle direction, then click. Centerline radius, sweep, width and curve quality remain live. Ground placement continues to height selection.
Thread · NChoose Add/Cut and click a circular hole or cylinder rim. M3–M30 presets set pitch, depth and profile; Custom unlocks those values. The source rim sets diameter and facets. Thread dimensions… lists starting radii/diameters; fit clearance is not included.

Joints

ToolWhat to do
Place connector · toolbarClick the face that should touch the other part to add a north (N, red) or south (S, blue) connector disc, or choose Two snap points: the first point places it and the arrow points toward the second. Round faces and holes use their exact center; a long dashed line shows the axis. The arrow points out of the face. North attracts south, and the north connector decides the motion: Hinge, Slide or Fixed.
Move connector · toolbarDrag a connector disc across its axis, or choose Along the axis and drag it along the dashed axis line. Across the axis it snaps onto the axis line of another shown parallel connector; other snaps are projected onto the plane or line, and a linked part follows.
Snap connectors · toolbarClick the connector that stays, then the one that moves: that part and every part linked to it turn so the arrows point at each other, and the joint is created in one Undo step. With Show joints on, Move and Paste placement also snap a free connector onto a nearby opposite pole. Confirming Paste creates the copies and joint in one Undo step. Numeric entry never mates.
Link in place · toolbarClick a face on the first part, then the second part: a north and a south connector are created at that point and linked without moving anything. Click a linked disc and Flip pair to swap north and south.
Edit connector · toolbarClick a disc, then type a position, move it along its arrow, flip its direction, point its axis along a world axis, move it to another face, flip its pole or delete it. Move joints in the Joint panel of a selected part.
Articulate · toolbarDrag a linked part toward the pointer; joints toward the base help when nearer joints cannot reach. Limits are kept. Click, move and click again also works. Type an exact joint value and press Enter; Escape cancels. The base stays put. The base stays fixed and limits are kept; collisions are not checked.

Solids

ToolWhat to do
Shapes · toolbarCreate Sphere, Ellipsoid, Cone, Frustum, Torus, Capsule, Box or Cylinder. Set dimensions and facets, click to fix the preview, adjust parameters, then Create shape. Click again to move the preview, or enter X/Y/Z. Escape releases it. Created solids use ordinary face editing.

Installed plugins appear under Solids → Generators by name and icon. Click one to open its parameters and live preview. Disabled plugins require consent before use; Create adds the validated final parts in one Undo step. Older plugins without an icon use the standard plugin symbol.

AI & Plugins

ToolWhat to do
AI Model Prompt · AI & Plugins menuChoose what to model, max height, background, level of detail, parts, colours and 3D printing, then copy the generated English prompt. Paste it into an AI that can run code and attach your photo there. It returns a ZIP with an OBJ and an MTL file; bring it in with Import. LamjaCraft does not send the photo to an AI service.
Plugin Manager · AI & Plugins menuOpen the Plugin Manager to import one or more .lcplugin files (or pair manifest.json + generator.js), review its warning and fingerprint, enable it and click Use. The parameters of the plugin appear in the sidebar; LamjaCraft runs its JavaScript in an isolated sandbox without network, files or project access, validates every part and adds them in one Undo step. Plugins run in Chromium-based browsers (Chrome, Edge); other browsers can import and export but not run them. AI Plugin Creator writes a prompt for ChatGPT or another AI that returns a plugin made only of JavaScript and a data manifest.
AI Plugin Creator · AI & Plugins menuDescribe your item and copy the generated prompt into an AI. The prompt includes the JavaScript API, preview/final guidance and the matching toolbar icon style. Import the returned plugin into Plugin Manager.

Help

ToolWhat to do
Help · toolbarOpen this guide. Its tool groups follow the left palette. Use the ? beside the active tool, Selected object or Objects for detailed instructions without changing the model.
About · toolbarView the application version, credits, native file-format reference and complete licenses. Download the matching buildable TypeScript source directly from this HTML file; no connection is required.

Ground height and twist: After drawing on ground, move upward and click, type a height and Enter, or use Height / Create. Twist angle is total rotation through the extrusion (−360° to +360°); 0° is straight. Approx. side angle shows a live equivalent-circle slope from the pull direction, using the original maximum profile width and current height; it ignores taper. Twisted pulls use a wire sweep preview and cancellable generation. Bolt Circle twists each pin around its own center. Drawing on a model face keeps the drawing tool; choose Push/Pull explicitly afterward.

Chamfer rims: The planar rim face owns the base setback, and side inclination must be consistent around the loop. Start with a small setback on thin walls. Setback bias is the distance ratio (neighbor = base × tan(bias)), separate from the automatically detected corner angle.

Objects and projects

Groups and Boolean edits: Shift/Ctrl/Cmd-click to select objects. Group selected organizes two or more ungrouped objects; groups are flat. Add selected adds extra ungrouped objects to an active group. Move, Rotate and uniform Scale affect all members; Ungroup before face/feature editing. Combine selected unions two or more selected objects or a complete group, including its hidden members, into one connected editable solid. A group plus extra objects is also supported. Selecting only open surfaces unites overlapping sheets in the same plane and stitches the rest along shared edges into one open surface, or into one closed editable solid when no open edges remain. Progress and Cancel preserve originals until one checked Undo/Redo command commits. Subtract selected cuts the first selected object with the second; Swap and Keep cutter control the direction and reuse. Separated material pieces become independent objects in one Undo step.

Snapping: Model points hidden behind a solid, outside the viewport or beyond camera clipping are excluded. Hidden guides do not snap; Guides through solids keeps displayed guide targets available. Live solid preview supplies the displayed occlusion geometry.

Build plates: Open Build Plates in the Reference group of the toolbar. Add one or more rectangular references on Z = 0; set width, depth, center X/Y, color, opacity and visibility. Apply saves the fields. Plates are saved in projects and support Undo/Redo, but never affect picking, snapping, Fit, editing or geometry export.

Object locks: Use the padlock beside an object in Objects to protect its geometry, position, size, name, color and deletion. A group padlock locks or unlocks all members; a mixed state means some members are locked. A single locked member prevents transforms or deletion of the whole group. Locked objects remain selectable, visible, measurable, snappable and exportable. Visibility and group organization remain available. Duplicate creates an unlocked copy. Lock changes support Undo/Redo and native project saving.

Visibility: Eye buttons, Hide selected, Show only selected and Show all control the viewport and support Undo/Redo. Hidden objects do not draw, pick, snap or affect Fit; attached dimensions follow their visibility. Entire model export includes hidden objects. Use Selected objects / group to limit export.

Copy and paste: Select an object, several objects or complete groups. Ctrl/Cmd+C copies them; Ctrl/Cmd+V starts Move placement for the whole copied selection. Move the pointer and click to place, use X/Y/Z or numeric distance as with Move, or press Escape to cancel. Groups retain separate membership and relative placement. Copies are unlocked; hidden members of a copied group stay hidden. One Undo removes the complete paste. The object clipboard stays available while this HTML file is open, including after New/Open. Text fields keep normal text copy/paste shortcuts.

Library, Save and downloaded files

Use Save to Library for a named project in this browser, Project → Download project for a portable editable file, and autosave for a separate recovery working copy. Browse saved projects and working copies with Project → Project Library…. Autosave never updates a saved Library project; neither Save nor autosave updates files already downloaded.

ActionWhat it does
Save to LibraryCtrl/Cmd+S updates the current linked Library project. For a project without a Library entry, it opens Library: enter a name and choose Save as new project. To rename a linked project, change the project name at the top and Save.
Project Library…Browse Saved projects and Autosaved working copies. The saved list shows names, object counts, save times and sizes, and marks the current linked project. Projects with the same name remain separate. Search saved projects by name filters the list as you type; letter case is ignored and nothing is changed or deleted.
Save current projectUpdates the current linked project, whatever the list shows or the search filters. Available only when the current model has a Library entry.
Save as new projectUses Name for a new library project to create a separate entry from the current model and make it the current linked project. It does not overwrite another project with the same name.
LoadOn a saved project row, opens its last saved version in place of the working model. Later Save updates that entry. Use an autosaved working copy instead if you need edits made after the last Save.
ReplaceOverwrites the selected saved project with the current model after confirmation. The entry keeps its name and becomes the current linked project.
DeleteOn a saved project row, removes that saved entry after confirmation. The current model, working copies and downloaded files are kept. If it was the current linked project, use Save as to save it again.
RefreshReloads the Library lists, including changes from another tab. A stale save or delete is rejected if another tab changed the entry; use Save as new project to preserve your current edits separately.
Download projectDownloads the complete current project as .lamjacraft.json, including committed edits, hidden objects and project references. It does not update Library or clear its unsaved-edits state.
Open project file…Ctrl/Cmd+O reads a native .lamjacraft.json file and replaces the working model. It does not create or update a Library entry; use Save as afterward. Use Import into project to append the file’s contents.
New projectReplaces the working model with a new project. Save to Library or Download project before replacing the working model.
Download allDownloads one ZIP containing every saved Library project. Save current edits first: unsaved models and autosaved working copies are excluded. Cancel backup stops preparation without downloading a partial ZIP.

Restore a ZIP backup: Extract it, then choose Project → Open project file… for an individual .lamjacraft.json file. Use Save as new project to put it back into Library. Unique names have no prefix; for duplicate names, the most recently saved project keeps the plain filename and older entries get -copy 1, -copy 2, and so on. Existing copy names are reserved; unsafe filename characters may be adjusted. Project names inside the files are unchanged.

Back up regularly: Keep Download files or a Download all ZIP outside the browser. Library and working copies belong to this browser profile and site; clearing site data, resetting the browser or automatic storage cleanup can remove them. File URL storage may depend on the browser and file location; private browsing or storage limits can restrict saving. If local saving fails, keep the current model open and choose Project → Download project.

Autosave and recovery

Each session has a separate working copy. Autosave records committed edits after a short idle delay, with periodic attempts during continuous editing. It waits for active tool steps or background jobs to finish and never overwrites Saved projects. Check the working-copy status to see whether the latest autosave completed; finish or cancel drafts before saving or downloading.

When a working copy exists, the start dialog What would you like to open? offers Resume where you left off for the most recent copy, Open the example (the built-in Fidget Spinner Gears model), Open from Library for another saved project or copy, Open a file, and Start with an empty model. Earlier copies remain available in Library, which also has Open example at any time.

In Library, choose Load on a row under Autosaved working copies. Recovery restores the last completed snapshot, camera and Library link, without updating the saved project. Choose Save when ready to update that linked project, or Save as new project to keep it separate. Undo history and unfinished tool steps or Sketch Editor drafts are not restored.

Delete deletes only that working copy after confirmation. The current active working copy is marked in the list and its Load and Delete actions are disabled. Library keeps up to 10 working copies; when autosave writes a new one, the oldest others are removed automatically. Autosave is a recovery aid; keep portable backups too.

Import: add to the current project

Project → Import into project… appends checked contents in one Undo step. Select a source, choose its settings, run the check, review the size and warnings, then confirm the import. Checking alone does not add anything. If the project or settings change, check again. Choose Open project file… to replace the project with a native file.

SourceWorkflow and limits
LamjaCraft JSONSelect one .lamjacraft.json file in native formats 7–10, then Check project and Import project. Objects, groups, guides, dimensions and build plates are appended with fresh IDs; native coordinates stay in millimetres.
OBJ / STLSelect one OBJ or STL. Select any MTL files together with the OBJ, or one ZIP holding the OBJ and its MTL files, to retain material colours. Choose mm, m, inches or a custom scale, then Check geometry and Import objects. Review the reported millimetre dimensions before importing. OBJ UV textures are not retained.
SketchUp SKPSelect one SKP, then Check geometry and Import objects. Direct import supports legacy SketchUp 7/8/2013/2015/2017 and 2021+ ZIP/VFF files, preserving component placement and polygon boundaries. Native inches become millimetres. Use the alternate scale only to match a previously mis-scaled STL. Materials and textures are not retained.

Mesh options: For OBJ/STL, Close simple planar openings is optional and off by default; it is not a general repair for damaged meshes. Ignore detached open surfaces is off by default, so accepted open polygons become limited surface objects. For STL, Keep touching parts separate is on by default. Closed solids support solid tools; limited open surfaces can be transformed, copied, recoloured, saved and stitched together with Combine, but cannot use solid-editing tools.

Capacity and failures: A project supports up to 2,000 objects, including objects already present before an import. The legacy SKP object graph has a separate 2,000,000-record budget for internal geometry and metadata; these are not project objects. File-size, nesting and geometry checks still apply, so the object count alone does not guarantee acceptance. A failed or cancelled check adds nothing. For a failed OBJ/STL/SKP check, the import diagnostic log is available in Debug.

STEP is export-only. For AI Model Prompt in the AI & Plugins menu, copy the generated prompt, attach your photo in your AI, then import the returned OBJ ZIP with Import.

Export: geometry or an image

Choose Project → Export model…, select a format and scope, review the summary or preview, then use its Download button. Geometry formats offer Entire model (including hidden objects) or Selected objects / group. A selected group includes its members. Objects stay separate and overlapping solids are not automatically unioned.

FormatContents and intended use
LamjaCraft JSONEditable native geometry, colours, shininess, transforms, visibility, locks and groups. Entire model includes guides, dimensions and build plates. Selected export includes only chosen objects, groups with at least two included members and object-linked dimensions whose object anchors are all included; unrelated guides and build plates are omitted. Use Import to append it or Open file to replace a project.
STLBinary triangle geometry written with millimetre coordinates, for slicers. STL contains no unit declaration or colours; verify the scale and printability in the receiving application.
3MF · Bambu StudioA standard 3D printing package with millimetre units, object names and colours, for Bambu Studio and other slicers that read 3MF components. Several objects load as one multi-part object in their modelled positions, so each part can be given its own filament for multi-colour printing. Bambu Studio maps the colours to filaments in its colour dialog; other slicers may ignore them, so check the filament of each part before slicing.
3MF · PrusaSlicerThe same parts stored the way PrusaSlicer keeps a multi-part object, so PrusaSlicer loads them as one object in their modelled positions instead of dropping each part to the bed. Each colour gets its own extruder number (first colour = extruder 1); check the extruder of each part before slicing.
OBJ + materialsA ZIP containing model.obj and model.mtl, with separate objects, flat normals and object colours. Extract both into the same folder. Coordinates are millimetres; in Blender use import Scale 0.001 for a metre-based scene. Original textures and native editing data are not included.
STEPNamed closed faceted solids with declared millimetre units. Planar faces and holes are preserved; curves remain faceted. Colours and feature history are not included.
PNGThe current camera view of Visible objects or Selected visible objects / group. Choose Modeling, Illustration or Presentation style; current, white or transparent background; Normal, 2× or 4× resolution; and optional shadows, grid/axes, guides, dimensions or build plates. The preview is the downloaded image. Resolution is subject to device limits.

Open surfaces: Use native LamjaCraft JSON to preserve limited surface objects, or PNG for a picture. STL, 3MF, OBJ and STEP export require closed solids; select only solid objects for those formats.

PNG appearance: UI, selection highlights, Debug and unfinished geometry are excluded. Finish or cancel Move/Rotate previews first. Presentation style shows shininess; smoothing and image export do not change geometry.

Messages and errors: Click a notification or the Messages button in the bottom status bar to reopen recent feedback. Message history retains the latest 100 full messages for this page session, including errors after their notification disappears. Select a row to read it, Copy history to copy all retained messages, or Clear history to discard them. This feedback is separate from model Undo and is not saved in project files.

Progress and saving: Export provides progress and Cancel. STL generation runs in the background; native JSON, 3MF, OBJ and STEP cancellation takes effect between preparation steps. Export leaves the current project and its unsaved state unchanged. Use Save to update Library, Download for the complete editable current project, or Library → Download all for saved-project backups.

Views, history and diagnostics

ToolWhat to do
Orbit · OPress O to choose Orbit, or drag with the right mouse button to orbit. Shift+right-drag or middle-drag pans; the wheel zooms toward the cursor. Navigation preserves a pending modeling operation.

Spin: Click Spin next to Explore to turn the whole view slowly around the origin, for example while demonstrating a model. The wheel still zooms, and dragging still orbits or pans; the spin pauses during a drag and continues afterwards. Click Spin again to stop. It changes only the view, never the model.

Full screen opens the entire app in full screen. Use F11 or the same button beside Spin to return to the browser window. A short Escape press still works in menus and tools. The browser can also leave full screen when Escape is held. If the app button is unavailable, use the browser’s full-screen shortcut.

Explore: Click Explore next to Fit to fly freely with WASD, Space (up), Left Shift (down), and the mouse. Arrow Up/Down or the mouse wheel adjusts flight speed; the current speed appears briefly in mm/s. The mouse is locked while exploring. Esc releases it and returns to normal modeling controls. The flight camera is perspective; movement does not edit model geometry. Pointer lock requires a supporting browser.

Display style and shininess: Modeling shows all model edges; Illustration shows sharp edges and contours; Presentation hides edge lines and shows material highlights from several light directions. Illustration and Presentation smooth lighting across gentle curves while preserving sharp creases. Set Shininess on an object or selection from 0 (matte) to 100 (glossy). Presentation PNG uses the same material setting. Shadows adds soft object and ground shadows. These display choices do not change geometry.

Views: Perspective uses perspective projection. Top, Front and Right are orthographic. Fit sits beside the camera presets. Right-drag or O controls orbit navigation. F / Fit centers visible objects and fills the viewport with a small margin, preserving the chosen camera orientation and projection. Framing adapts to the window aspect ratio. Views and navigation change the camera only.

Commands: Ctrl/Cmd+Z undoes; Ctrl/Cmd+Shift+Z or Ctrl/Cmd+Y redoes. Ctrl/Cmd+D duplicates the selected object/group. Delete removes the selected entity or all selected objects in one undoable action. Objects mode deletes only selected group members; whole-group modes delete all members of each selected group. Delete selected in the sidebar also removes a multiple-object selection; Backspace also deletes when a drawing/numeric operation is not consuming it. During Contour, Backspace removes the last point; during numeric input it removes the last digit. Tool, axis and Fit letter shortcuts use the letter alone, without Ctrl, Cmd, Alt or Shift; Caps Lock is supported. Other modified letter combinations stay available to the browser/operating system. Shift can still enter numeric symbols and separators. Shortcuts do not switch tools while a parameter field or dialog has focus.

Preview and topology: With Taper and Twist both at 0°, ordinary Push/Pull previews the validated candidate as a wire outline. Nonzero taper or twist uses a wire sweep preview and final worker validation. Coplanar sketch regions remain ordinary editable faces. Render triangles are derived data, so internal triangulation edges are not editable model edges. Check Object inspects one ungrouped solid without repairing or changing it.

Experimental WASM: Debug → Geometry engine selects TypeScript (standard), Experimental WASM (C++) or Compare results. WASM accelerates polygon triangulation, mesh point welding and BVH construction. Large surface sketches strictly inside a planar face and validation of prepared Push/Pull solids can use one combined native kernel for geometry, complete topology/plane/volume checks and mesh building. TypeScript still packs input, materializes canonical model records, owns stable IDs and history, and checks the source before commit. Crossing/touching boundaries, enclosing existing holes, unsupported sizes and unavailable kernels use the checked reference path. Compare keeps the TypeScript result and checks exact canonical geometry, mesh, volume and topology sequence; mismatches quarantine native execution until the engine is reselected. Copy measurements includes the combined kernel's packing, kernel, output and fallback counters. All modules and workers are embedded for offline use. Engine changes cancel unfinished gestures, rebuild derived display data and do not create Undo entries or change saved projects.

Debug: Open the compact Debug button at the far right of the bottom controls. The menu scrolls for long control lists. It shows topology, triangulation, picking and snap overlays, plus performance profiling. Thread, Rounded Chamfer and Texture diagnostics download source/parameter/event logs. Texture can download the last run or last four attempts; Undo/Redo retains these logs. Import diagnostics records OBJ/STL/SKP check stages, settings, work counts, topology samples and worker errors. Download the last check or last four checks and attach the source file too. Diagnostic logs are memory-only and are not project backups.

THREAD / REFERENCE

Recommended starting rim dimensions

The M-thread names use nominal major diameter. LamjaCraft's Circle tool and Thread rim use radius, so each cell shows both diameter (Ø) and radius (R). Metric coarse presets use a 60° modeling profile with radial depth 0.613434 × pitch for external cylinder threads and 0.541266 × pitch for internal hole threads. These are modeling dimensions, not machining tolerance or tap-drill data.

How Add/Cut changes the starting size: Cylinder + Cut and Hole + Add start at the nominal diameter. Cylinder + Add starts below nominal by twice the external preset depth; Hole + Cut starts below nominal by twice the internal preset depth. In both cases the generated profile reaches approximately the nominal major diameter.

ThreadPitch
mm
Nominal
Ø / R
Cylinder Add
Ø / R
Cylinder Cut
Ø / R
Hole Add
Ø / R
Hole Cut
Ø / R
⚠ 3D-print clearance: No clearance or fit tolerance is included in these values. Calculate or test the required clearance for the printer, material, layer height, and orientation, and adjust the mating male/female geometry accordingly.

READY FOR THE NEXT STEP

Export model

Objects stay separate. Overlapping objects are not unioned during export.