solidcraft-upstream/.github/release-notes.md

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:

• .solvecraft designs 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-cli remains as a deprecated alias for one release; it forwards to solidcraft-cli and prints a note. Agents: claude mcp add solidcraft -- solidcraft-cli mcp; an existing claude mcp add solvecraft -- solvecraft-cli mcp setup keeps working.
• Windows: the .msi upgrades the existing installation in place (now in Program Files\SolidCraft). Linux: the solidcraft .deb/.rpm replaces the solvecraft package. The Flatpak app ID stays ai.storyteller.solvecraft, so flatpak update just works, and existing AppImages find the update.
• macOS: quit the app, move the old SolveCraft.app to the Trash (your designs and settings stay), then drag SolidCraft.app from 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.exe runs as is. Or install the .msi, or unzip the -portable.zip (x64, x86 and arm64).
• macOS 11+ (Apple silicon and Intel): open the .dmg and drag SolidCraft.app onto Applications. The CLI is in solidcraft-cli-{version}-macos-universal.zip.
• Linux (x86_64 and aarch64, glibc 2.35+): the .AppImage (chmod +x, then run it), the .deb or .rpm, the .flatpak (flatpak install --user <file>), the .snap (sudo snap install --dangerous <file>, or sudo snap install solidcraft from 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}.zip is 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.