Files
OneCAD/.github/release-notes.md
bherbruckandClaude Opus 5.5 b5efde94c8 docs: make the release notes template version-neutral (#1074)
The template still carried the 0.9 notes, and nightlies publish it as is. Keep the introduction, the upgrade notes that hold for every version and the install instructions; the release-specific part is written for each release.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-14 08:36:03 -04:00

3.9 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).

What's new in SolidCraft {version} is listed below, and the ROADMAP lists the known limitations. Designs from every earlier version open in this one.

Upgrading from 0.7 or earlier. 0.8 changed the Linux app ID to ai.storyteller.solidcraft: flatpak update offers to replace the old app, and the .deb, .rpm and AppImage remove the old menu entry.

Upgrading from 0.5 or earlier. 0.6 renamed SolveCraft to SolidCraft and made the zip container the default save format. .solvecraft designs, old settings folders and SOLVECRAFT_* variables are still picked up, and solvecraft-cli still forwards to solidcraft-cli. Want plain JSON? Use File ▸ Save As JSON… or --save design.json. On macOS, replace SolveCraft.app with SolidCraft.app. Details: compatibility notes.

Documentation, the browser app and the Flatpak feed use the SolidCraft project Pages URLs.

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.solidcraft
flatpak run ai.storyteller.solidcraft

Flatpak installs from 0.7 or earlier use the old ID ai.storyteller.solvecraft: flatpak update --user offers to replace it with ai.storyteller.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 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.