> ## Documentation Index > Fetch the complete documentation index at: https://supastack.dev/llms.txt > Use this file to discover all available pages before exploring further. > For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt # Bundle and release Produce installers and keep release evidence separate from a successful build. ## Beginner walkthrough Prerequisites: Finish Desktop local setup, including Rust and the operating-system build tools. Stop the Tauri development process before building an installer; leave the Web backend running. Run each check below from the repository root and wait for it to finish before running the next. The filtered package commands work in Desktop-only and All Platforms checkouts. Quick terms: a workspace is one team's separate users, data, and settings. The server is the trusted backend; keep provider keys out of browser and phone code. A migration is a versioned database change that creates or updates tables. An AI model is the engine that answers; the model catalog is the server's list of available model IDs and prices. A provider is an outside service such as an AI, email, or billing service. An entitlement is a grant that lets a workspace use a feature. A webhook is a message one service sends to another service's URL. 1. In a local branch, ask your coding agent to inspect `apps/desktop/src-tauri/tauri.conf.json` and set the product identifier, app name, icons, and backend URL to values you own. Use a public HTTPS backend URL for release builds. 2. From the repository root, run the Desktop package checks below. Before check:release-config, set SUPASTACK_APP_URL in this terminal using the operating-system command in Desktop local setup; the public HTTPS backend must be running, and the app identifier must be your own. 3. A successful build does not sign, notarize, or publish an installer; if Rust or a system library is missing, finish Desktop local setup. For custom code, start with the supplied `prompts/README.md` and copy the closest prompt: `prompts/new-app-screen.md` for an app screen or `prompts/new-landing-page.md` for a public page. For server, database, or provider work, give your coding agent this guide's task and ask it to read `AGENTS.md`, `.ai/PROJECT_CONTEXT.md`, and matching `.ai/` mirrors; inspect the exact source files named here; list files and checks before editing; preserve workspace ownership and server-only secrets; and show you the diff. Tell it the behavior you want, input and output fields, allowed roles, expected success and errors, and the test account, provider, or device. Use sample values; never paste a real secret. [Before you start](https://supastack.dev/docs/web/before-you-start.md) [Terminal basics](https://supastack.dev/docs/web/terminal-basics.md) [Desktop local setup](https://supastack.dev/docs/desktop/ship-in-5-minutes.md) [Agent prompts & project memory](https://supastack.dev/docs/web/agents.md) ``` corepack pnpm --filter @supastack/desktop typecheck corepack pnpm --filter @supastack/desktop test corepack pnpm --filter @supastack/desktop check:release-config corepack pnpm --filter @supastack/desktop build ``` ## Configure the product shell Review `src-tauri/tauri.conf.json`, Cargo metadata, capabilities and platform identifiers. Replace app icons through the shared asset process and set the intended backend URL at build/runtime. The hosted web app must already be deployed and reachable. ## Run the native build gate These package commands run Rust typecheck and tests, validate release settings, and build the Tauri installer. Signing and distribution configuration depend on the target platform and your account/certificates; do not store signing material in source. ``` corepack pnpm --filter @supastack/desktop typecheck corepack pnpm --filter @supastack/desktop test corepack pnpm --filter @supastack/desktop check:release-config corepack pnpm --filter @supastack/desktop build ``` ## Verify the installer on the target OS Check clean install, launch, backend reachability, auth, menus/tray, hotkey registration, second instance, deep links, offline retry and uninstall. Verify each supported OS separately. A local build does not prove signed or notarized commercial distribution; signing configuration, an updater feed, and release automation are not included. [Native acceptance checklist](https://supastack.dev/docs/desktop/run.md) [Deploy the shared backend](https://supastack.dev/docs/web/deployment.md) ## Setup and configuration Run corepack pnpm --filter @supastack/desktop check:release-config before preparing an installer. It checks that SUPASTACK_APP_URL is credential-free HTTPS on a public host and that the Tauri identifier is product-specific; the check is opt-in and does not block local development. corepack pnpm --filter @supastack/desktop build runs tauri build. The bundle targets in tauri.conf.json produce the installer formats available on the host OS — build on each OS you ship. Artifacts land under apps/desktop/src-tauri/target/release/bundle/. productName, version, and identifier live in tauri.conf.json — bump the version there before cutting a release. Regenerate icons with corepack pnpm --filter @supastack/desktop icons, which rewrites src-tauri/icons from icon-source.png. ``` corepack pnpm --filter @supastack/desktop check:release-config corepack pnpm --filter @supastack/desktop icons corepack pnpm --filter @supastack/desktop build # artifacts: apps/desktop/src-tauri/target/release/bundle/ ``` ## Implementation workflow Unsigned builds install locally but trigger OS trust warnings. Code signing and Apple notarization belong in your release configuration — provision certificates through your own secret store, never in the repo. Bake the production SUPASTACK_APP_URL into release builds so installed shells point at the deployed web app rather than localhost. ## Verification and troubleshooting Install the produced bundle on each target OS and record the build, OS, and app URL used for acceptance. Verify launch, the loaded deployment, tray and hotkey behavior, and sign-in persistence — a completed tauri build alone is not release evidence. If you want to continue setup, read [Code signing](https://supastack.dev/docs/desktop/signing.md). ## Next [Code signing](https://supastack.dev/docs/desktop/signing.md)