* 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 <noreply@anthropic.com> 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 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RjGw4gA5ZvKrU8MQP6sBgT * snap smoke: quit the app cleanly between backends Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01RjGw4gA5ZvKrU8MQP6sBgT --------- Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
63 lines
4.4 KiB
Markdown
63 lines
4.4 KiB
Markdown
SolidCraft is open-source parametric 3D CAD in Rust: sketch, constrain, extrude, and change a
|
|
parameter to watch the timeline rebuild. [Documentation](https://bherbruck.github.io/solidcraft/)
|
|
· [try it in the browser](https://bherbruck.github.io/solidcraft/app/) ·
|
|
[contributing](https://github.com/bherbruck/solidcraft/blob/main/CONTRIBUTING.md) ·
|
|
[issues](https://github.com/bherbruck/solidcraft/issues). AI agents can model with it over MCP:
|
|
`solidcraft-cli mcp` ([how](https://bherbruck.github.io/solidcraft/guide/mcp.html)).
|
|
|
|
**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](https://github.com/bherbruck/solidcraft/blob/main/docs/compatibility.md).
|
|
|
|
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:
|
|
|
|
```sh
|
|
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](https://bherbruck.github.io/solidcraft/guide/getting-started.html#linux-flatpak).
|
|
|
|
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](https://github.com/bherbruck/solidcraft/blob/main/ROADMAP.md#known-limitations).
|
|
|