SolidCraft is open-source parametric 3D CAD in Rust: sketch, constrain, extrude, and change a
parameter to watch the timeline rebuild. Documentation
· try it in the browser ·
contributing ·
issues. AI agents can model with it over MCP:
solidcraft-cli mcp (how).
What's new in SolidCraft 0.46.1 is listed below, and the
roadmap detail lists
the known limitations. Designs from every earlier version open in this one.
0.46.1 is a prerelease. 0.45.0 stays the current release until 0.46.1 is promoted. It fixes the slower opening of designs with imported STEP files in 0.46.0, and the usage-statistics notice now stays until you dismiss it: see Privacy: usage statistics below.
New app ID. The app ID is now io.tangencylabs.solidcraft (it was ai.storyteller.solidcraft): flatpak update offers to replace the old app, the
.deb, .rpm and AppImage remove the old menu entry, and settings stay. On macOS the bundle ID
changed too, so macOS asks once more for the permissions it had granted.
Old names. The zip container is the default save format. Want plain JSON? Use
File ▸ Save As JSON… or --save design.json. Designs saved by earlier versions, including
.solvecraft files, still open; the solvecraft-cli command, SOLVECRAFT_* variables and the
.solvecraft file association are gone. Details:
compatibility notes.
Documentation, the browser app and the Flatpak feed use the SolidCraft project Pages URLs.
Which file?
- Windows:
SolidCraft-0.46.1-windows-x64.exeruns as is. Or install the.msi, or unzip the
-portable.zip(x64, x86 and arm64). IT admins:solidcraft-0.46.1-windows-policy-templates.zip
holds the Intune and Group Policy templates (Managing SolidCraft in an organization). - macOS 11+ (Apple silicon and Intel): open the
.dmgand dragSolidCraft.apponto Applications.
The CLI is insolidcraft-cli-0.46.1-macos-universal.zip. - Linux (x86_64 and aarch64, glibc 2.35+): the
.AppImage(chmod +x, then run it), the
.debor.rpm, the.flatpak(flatpak install --user <file>), the.snap
(sudo snap install --dangerous <file>, orsudo snap install solidcraftfrom the Snap Store), or the.tar.gz. - FreeBSD:
tar -xzf solidcraft-0.46.1-freebsd-x86_64.tar.gz --strip-components 1 -C /usr/local. - Web:
solidcraft-web-0.46.1.zipis a static site to host yourself. SHA256SUMS.txt:sha256sum -c SHA256SUMS.txt --ignore-missing.- Files without a version in the name (
solidcraft-windows-x64.msi,solidcraft-linux-x86_64.AppImage, …)
are the same packages under fixed names, for download links that always fetch the latest release.
For Flatpak feed installation and updates, add Flathub for the required runtime before
installing SolidCraft; keep both remotes in the same user installation:
flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak remote-add --user --if-not-exists solidcraft https://docs.solidcraft.io/flatpak/solidcraft.flatpakrepo
flatpak install --user solidcraft io.tangencylabs.solidcraft
flatpak run io.tangencylabs.solidcraftA remote added from the old bherbruck.github.io address no longer finds updates: run
flatpak remote-modify --user --url=https://docs.solidcraft.io/flatpak/repo/ solidcraft, then
flatpak update --user.
Flatpak installs under the old ID ai.storyteller.solidcraft: flatpak update --user offers to replace it with io.tangencylabs.solidcraft, and settings move along.
Single-file .flatpak bundles include the runtime repository address; missing runtimes
still need an internet connection. Linux installation details.
The macOS app is signed with a Developer ID and notarized. The Windows files are not signed yet:
SmartScreen may say "Windows protected your PC": More info, then Run anyway. The other
packages are unsigned. Windows debug symbols are attached as solidcraft-0.46.1-windows-<arch>.pdb.zip.
Licences are built in (Help ▸ About ▸ Licences, solidcraft-cli licences); the packages also
install THIRD-PARTY-LICENSES.txt.
What's new in 0.46.1
0.46.1 is a patch release. It fixes the slower opening of designs with imported STEP files that came with 0.46.0, replaces the usage-statistics toast with a notice that stays until you dismiss it, and adds the fixes merged since 0.46.0. The design format is unchanged (format 64, drawings format 3): 0.46.0 opens what 0.46.1 saves.
Speed
- Opening a design with an imported STEP file is about 6× faster again, fixing the slowdown in 0.46.0. A 561-part assembly that took 126 s to read now reads in 20 s, as it did before that change (#20286).
- File ▸ Open reads a design file once instead of once per step, as the command line already does (#20440, #20397).
- Dragging a part along its joints in a large assembly stays smooth: the parts move on the GPU while you drag, and the design changes once, when you let go (one undo step; Escape cancels) (#19291).
- Fillets and chamfers built with certified sections do less than half the checking work for the same result (#19124).
Views and interface
- One view menu on view tabs and cards (right-click or Shift+F10): close other views or the ones to the right, and bring a view in another window back. Save named view layouts and apply them later, and switch the compass on or off for each 3D view (#20441).
- The window's layouts and view controls are behind one Layout button in the view tabs (#19641).
- Pop-out windows work like full windows: each has its own settings and window menu, the design ribbon (auto-hiding by default) and the workspace's panels, a top bar that appears at the edge, and its own interface size from 90% to 200% (#20479).
- Customize the app bar: right-click it and choose Customize App Bar to drag items in from a tray, reorder or hide them, or pick a preset (Default, Minimal, Full, Compact). Its spacing is simpler and slightly more compact (#19461).
- Selection mode in the navigation bar picks faces and edges, bodies, features, parts, components or sketch geometry, with a Pick filters flyout for exactly what a click can take and Rectangle or Lasso selection (#19263).
- Near-black colours look as dark as they are on displays that use an sRGB window surface (#20305).
- Translations: Arabic fills in new terms, and a system set to the old Hebrew locale tag (
iw) gets Hebrew (#20454, #19573).
Modeling and sheet metal
- Booleans and the body check use one rule for when two places are the same, so cuts in a small tolerance band no longer lose geometry or get refused (#20465).
- Healing an imported body gives each vertex a tolerance that covers its gaps (#18667).
- A boundary surface builds when some of its loop's curves were drawn in the opposite direction (#20418).
- A hole on a curved face lands on the point you sketched instead of snapping to the display mesh (#20367).
- A fold line sketched outside a moved component folds the sheet where the line is (#20469).
- Kernel failures in B-spline curves and in measuring deviation and distance now report a named cause instead of a generic failure (#20329, #20315).
Import and export
- Flat pattern DXF profiles: Export Flat Pattern as DXF takes a small profile file with your cutter's layer names, colours and linetypes for each kind of line (outline, cut-outs, bend lines, text and more). Without a profile the export is unchanged (#20404).
- ASCII STL with one named solid per face, for CFD meshers that set boundary conditions per patch (#20449).
- Circuit boards (
.kicad_pcb): a board whose outline lines miss each other by a few nanometres opens, and a back-side part with an offset 3D model lands where the board file puts it (#20456, #20455). - STL and 3MF exports stay closed after T-junctions are split (#20396).
- URDF and SDFormat export keeps parts named in Chinese, Japanese, Cyrillic or accented letters apart in their mesh file names (#20410).
Plugins and automation
- A plugin reads and writes its own files in a design as bytes, no longer as base64 text (#19891).
- A plugin can be told which linked part files changed, through the new
design.links_changedevent (#20300). - A plugin can insert designs from a parts library it may only read (#20364).
- The MCP save tool accepts
overwrite, asfile.savedoes, andappearance.replacereturns what its schema describes (#20377, #20420).
Privacy: usage statistics
In 0.46.0 the usage-statistics notice was a toast that went away by itself after 30 seconds, so many people never saw it. In 0.46.1 it is a plain notice that stays until you dismiss it (#20472):
SolidCraft shares anonymous usage statistics to help make it better: which tools you use, never your designs.
- Usage statistics are on by default and anonymous. They count which tools and commands you use, never your designs, file names or anything you type. Nothing is counted until the notice has been shown.
- Settings opens Preferences › Privacy. Dismiss (or the ×) closes the notice for good. Until you choose one, it shows again at each start. It never shows while statistics are turned off.
- Turn it off any time in Preferences › Privacy › Share anonymous usage statistics. When it is off, nothing is counted and reports still waiting are deleted.
DO_NOT_TRACK=1,SOLIDCRAFT_NO_TELEMETRY=1and theUsageStatisticsorganization policy still turn it off with no notice. - If you used 0.46.0, you see the notice once more, because 0.46.0 kept no record of a dismissal.
- Delete my data in Preferences › Privacy now confirms the request and shows the new installation ID. Clicking it several times sends one request.
The full list of what is and isn't sent is in the 0.46.0 notes and the privacy page.
Known issues
- Convert Mesh takes about twice as long as in 0.43.0 (#18458).
- A thin join extrude on a STEP-imported solid can fail with "Face has Coincident Edges" (#18848).
- Loft: matching sections can get extra cuts, and a box cut can be refused (#19098).
- Sketch: a rectangle can get locked to the origin and a projected vertex, so its dimensions can't change (#17289).
- Design format v64, drawing format 3, unchanged from 0.46.0. 0.46.1 opens designs from every earlier version.
Why a patch: fixes (the STEP open-time slowdown in 0.46.0, the usage-statistics notice) and compatible improvements; the design format is unchanged.
Contributors
Thank you to everyone who contributed to 0.46.1 (18 people):
@0rdnungsamt, @A-AL-ANAZI, @aapolipponen, @adnsv, @ancientastronauttheorist, @ashxddaga, @bherbruck, @bnoa, @CamWight, @DAmesberger, @hrb9, @kaltenbrunnermarkus, @Leocrydis, @MarkusReichart, @Nathan-Dane, @oursland, @raykholo, @Sebastion
New Contributors
Full Changelog: v0.46.0...v0.46.1