How Partwright works

• Ready — idle, geometry rendered successfully
• Running… / Loading… — code or WASM is in flight
• Error — compilation or runtime error; click for full message

• JavaScript / manifold-3d (default) — Fast mesh booleans plus warp, levelSet, smoothing, and curve helpers.
• OpenSCAD — Standard .scad with the BOSL2 library (threaded rods, gears, rounded cuboids, and more).
• BREP (replicad / OpenCASCADE) — True boundary-representation solids with selective edge fillets and chamfers, exact surfaces, and STEP import + export. Use it two ways: call api.BREP.* inside a JavaScript session for one exact feature, or switch the whole session to the BREP language. It adds cone, torus, revolve, shell, and linear/circular patterns.
• Voxel — Model from a grid of cubes. Import an image as voxels or load a .vox file, paint individual voxels, and surface the result with rounded edges; includes cylinder, mirror, translate, and hollow operations.

const { Manifold } = api;

// Create a box and subtract a cylinder
const box = Manifold.cube([20, 20, 10], true);
const hole = Manifold.cylinder(12, 4, 4);

return box.subtract(hole);

• Interactive — Live 3D viewport. Drag to orbit, scroll to zoom, right-drag to pan.
• Gallery — Grid of saved versions. Click any thumbnail to load that version into the editor.
• Images — Attach reference photos or renderings (file upload or paste URL). Each image gets a label (Front / Right / Back / Left / Top / Perspective) for ordering and reference.
• Diff — Side-by-side comparison between any two versions: code on the left and right, plus a stats delta bar (volume, dimensions, manifold status).
• Notes — Per-session free-text log. Use it to capture requirements, decisions, and feedback as the design evolves.

• Grid — Toggle the XY ground plane grid.
• Dimensions — Toggle the bounding-box overlay with X / Y / Z extents.
• Orbit lock — Freeze camera rotation. Useful while painting, measuring, or annotating.
• Measure — Click to drop point 1, drag to point 2; the distance shows as a 3D label. Click elsewhere to clear. Orbit lock engages automatically.
• Cross-section — Toggle a horizontal clipping plane. A Z slider appears; everything above the plane is hidden and the cut face renders in red.
• Annotate — Draw freehand strokes or drop pinned text labels on the model. Annotations are saved per version and survive export to .partwright.json.
• Paint — Color regions of the model for multi-material printing (full details below).
• Palette — Manage your printer's filament slots: define, reorder, and reset the colors, build a palette from a photo (auto-detected dominant colors or a click-to-eyedrop pick), and constrain painting to those slots. Slot-aware paint regions map onto a printer's AMS slots and export to 3MF in slot order.
• Quality — Tune curvature quality and simplify or enhance the model's triangle count in one panel. Drag a slider or type an exact target, then "Apply"; "Save as version" bakes the result into a new version and "Reset" restores full detail.
• Resize — Scale the model along X / Y / Z with independent or uniform sliders, a typeable exact size, and an optional "preserve colors" pass. A live preview updates as you drag; Apply saves a new version.
• Reset view — Return the camera to its default framing. A zoom-out limit keeps the model from shrinking away into the distance.
• Surface — Apply a surface modifier: fuzzy skin (randomized printed-texture noise), smooth (round out facets), voxelize (convert the surface to a cube grid), or one of the fabric textures — V-strand knit, cable knit, waffle stitch, fur / velvet, and woven fabric, wrapped over the surface via UV unwrapping (GPU-accelerated where supported). A mesh-detail slider trades triangle count for fidelity. Apply a modifier to the whole model or to a click-selected region (additive multi-region selection, with a color-sensitivity control). Preview before committing; each apply creates an undoable new version.

• Bucket (flood-fill) — Click a face; paint propagates across connected neighbours, either by geometry (within an angle tolerance you set with a slider, 0° = "coplanar only" up to 180° = "whole connected mesh") or by color (every region sharing the clicked color). Hover for a translucent preview before committing.
• Brush — Click and drag to paint individual triangles. Release to commit the region. A Wrap tolerance slider (0–180°, default 90°) keeps a stroke from bleeding across sharp edges — paint crosses an edge only when the two faces bend by no more than the tolerance.
• Slab — Pick an X/Y/Z axis, then drag a range along the model surface; every triangle whose centroid falls inside the slab gets painted. A translucent cuboid previews the slab extent.
• Shape — Paint everything inside a positionable, rotatable, scalable 3D shape (box, sphere, cylinder, or cone).
• Replace — Click the mesh to pick a source color, then swap it for the active color across every matching region at once.
• Image — Project an image onto the surface as color regions: click to stamp it where you point (with a hover preview and rotation), or use smooth mode to subdivide the footprint so the picture conforms to curvature. Alpha-channel flood fill drops the background, and SVG inputs stamp at full vector quality.

• Inputs — Drop in a photo, or use a flat-color tile, a silhouette tile, or an imported SVG. Crop and preprocess the image, and pick a background to drop out.
• Relief modes — Smooth height-map relief, or stepped relief with Z-banded walls that print faithfully on a single nozzle (with an invert-heights toggle). A live 3D preview updates as you tune.
• Finishing — Add a tile chamfer and one or more freely-positioned keychain holes, then send the result into a session as a painted model with a color-swap guide.

• 3MF (recommended for printing) — Geometry plus native color regions, emitted in filament-slot order so the material index follows your AMS slots. Imports cleanly into Bambu Studio and other modern slicers.
• OBJ — Geometry plus color via an MTL sidecar. Delivered as a ZIP — extract before importing into a slicer.
• STL — Geometry only, no color. Universal slicer support.
• GLB — Web/preview format with vertex colors. Good for embedding online, not read by slicers.
• STEP — Exact BREP solids, available from BREP-language sessions. The CAD interchange format for downstream engineering tools.

• Session (.partwright.json) — All versions, notes, annotations, color regions, and attached images. Another Partwright user can import this and pick up where you left off. A dialog lets you choose whether to embed the thumbnail, notes, annotations, and color regions.
• Code (raw) — Just the editor contents as plain .js or .scad.

• Anthropic — Claude (Haiku / Sonnet / Opus), with prompt caching. Keys look like sk-ant-….
• OpenAI — GPT and reasoning (o-series / gpt-5) models.
• Google Gemini — Gemini models, including thinking models with a reasoning box.
• Custom (OpenAI-compatible) — Point at any self-hosted OpenAI-compatible endpoint (a llama.cpp server, vLLM, LM Studio, …) by setting its base URL and model. The API key is optional; turns are free at the API level.
• Local (WebGPU) — Runs a model fully in your browser via WebLLM. No API key, no network traffic per turn; the weights download once into the browser cache (needs a WebGPU-capable browser).

1. Click Connect AI (or the Use AI button) in the toolbar.
2. Pick a provider and paste its API key — or choose Run a local model in your browser to download a WebGPU model instead.
3. Partwright sends a tiny test request to verify a cloud key, then stores it in your browser's IndexedDB.
4. The toolbar button changes to ✦ AI and the chat panel is ready. Each provider remembers its own selected model, so switching providers keeps your previous choice.

• Claude in Chrome extension — Install the extension and Claude can control your active tab directly. Best for interactive sessions where you watch and steer.
• Chrome DevTools MCP — Enable remote debugging in Chrome, then add the MCP server to your agent. Uses your existing browser session and cookies.
• Playwright MCP — Launches a separate browser, no Chrome setup needed. Best for automated or headless workflows.

Read the AI agent instructions at https://8f71f272.mainifold.pages.dev/ai.md to understand how to use this tool.

Then navigate to https://8f71f272.mainifold.pages.dev/editor and use the window.partwright console API to:

1. Create a session called "Standard Lego Brick"
2. Build a standard 2x4 Lego brick (approximately 31.8mm x 15.8mm x 11.4mm with studs on top and hollow underside with tubes)
3. Save each major step as a version (e.g. v1 - base block, v2 - add studs, v3 - hollow underside with tubes)
4. Use assertions to verify each version is a valid manifold with maxComponents: 1
5. Give me a share link (partwright.getShareLink()) when done so I can open the design

Shortcuts adapt to your operating system (⌘ on macOS, Ctrl elsewhere).

• Ctrl + K — Open the command palette — search and run any action by name.
• ? — Open this keyboard-shortcuts cheat sheet (when not typing in a field).
• Ctrl + Z — Undo the last paint region or annotation stroke, depending on which tool is active. When the code editor is focused it uses its own built-in undo.
• Ctrl + Shift + Z or Ctrl + Y — Redo the last undone paint region or annotation stroke.
• Ctrl + S — Save the current code, geometry, paint regions, and annotations as a new version in the active session.
• Shift + Alt + F — Reformat the code in the editor.
• Shift + Alt + F — Format the code in the editor.
• Escape — Close the open dropdown, modal, paint or annotate panel, cross-section overlay, or exit the guided tour.
• Enter / → — Next step during the guided tour.
• ← — Previous step during the guided tour.
• Ctrl + Enter — Save the current notes textarea.
• Enter in input modals (e.g. Connect AI, Import Preview) — Confirm.