* Snap package: build, test and attach a strict snap to every release packaging/linux/snap/snapcraft.yaml (core24, strict, gnome extension) repackages the release's Linux tarball like the Flatpak does. The release workflow builds it for amd64 and arm64, installs it with --dangerous, models a box in the confined app on headless X11 and Wayland, and attaches solidcraft-<version>-linux-<arch>.snap plus the version-less copy. When SNAPCRAFT_STORE_CREDENTIALS is set, nightlies go to edge and release drafts to candidate, and snap-store.yml promotes candidate to stable when a release is published. The README gets a Snap badge and install line. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01RjGw4gA5ZvKrU8MQP6sBgT * snap smoke: stop the app's whole process group, refuse a busy control port Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01RjGw4gA5ZvKrU8MQP6sBgT * snap smoke: quit the app cleanly between backends Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01RjGw4gA5ZvKrU8MQP6sBgT --------- Co-authored-by: Claude Opus 5.5 <[email protected]>
4.4 KiB
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).
Renamed to SolidCraft. Everything now uses the new name: the solidcraft and
solidcraft-cli programs, .solidcraft designs, SOLIDCRAFT_* environment variables,
settings folders, package names and the solidcraft MCP server. Upgrading from SolveCraft:
.solvecraftdesigns still open (double-click, Open, drag-drop, the CLI and MCP); new saves are.solidcraft. Builds older than this one can't open files saved by it.- Settings, preferences and recovery files are copied to the new folders on first launch; the
old folders are left in place.
SOLVECRAFT_*environment variables are still read. solvecraft-cliremains as a deprecated alias for one release; it forwards tosolidcraft-cliand prints a note. Agents:claude mcp add solidcraft -- solidcraft-cli mcp; an existingclaude mcp add solvecraft -- solvecraft-cli mcpsetup keeps working.- Windows: the
.msiupgrades the existing installation in place (now inProgram Files\SolidCraft). Linux: thesolidcraft.deb/.rpmreplaces thesolvecraftpackage. The Flatpak app ID staysai.storyteller.solvecraft, soflatpak updatejust works, and existing AppImages find the update. - macOS: quit the app, move the old
SolveCraft.appto the Trash (your designs and settings stay), then dragSolidCraft.appfrom the DMG onto Applications and pin it in the Dock. - Details: compatibility notes.
Documentation, the browser app and the Flatpak feed use the SolidCraft project Pages URLs; old-name Pages addresses are not permanent aliases.
Which file?
- Windows:
SolidCraft-{version}-windows-x64.exeruns as is. Or install the.msi, or unzip the-portable.zip(x64, x86 and arm64). - macOS 11+ (Apple silicon and Intel): open the
.dmgand dragSolidCraft.apponto Applications. The CLI is insolidcraft-cli-{version}-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-{version}-freebsd-x86_64.tar.gz --strip-components 1 -C /usr/local. - Web:
solidcraft-web-{version}.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://bherbruck.github.io/solidcraft/flatpak/solidcraft.flatpakrepo
flatpak install --user solidcraft ai.storyteller.solvecraft
flatpak run ai.storyteller.solvecraft
Single-file .flatpak bundles include the runtime repository address; missing runtimes
still need an internet connection. Linux installation details.
The builds aren't signed yet. On macOS, right-click SolidCraft.app in Applications and choose
Open the first time (or run xattr -dr com.apple.quarantine /Applications/SolidCraft.app).
On Windows, SmartScreen may say "Windows protected your PC": More info, then Run anyway.
Licences are built in (Help ▸ About ▸ Licences, solidcraft-cli licences); the packages also
install THIRD-PARTY-LICENSES.txt. Known limitations:
ROADMAP.md.