Skip to content

Quickstart

Build Fastcart, bootstrap a store, and run the API and admin locally.

Updated

This guide takes a clean checkout to a running Fastcart API and admin UI.

Prerequisites

Fastcart needs:

  • Rust. The pinned toolchain in rust-toolchain.toml is installed automatically by rustup.
  • Node.js 22 or later and pnpm 10 for the admin, storefront, and docs apps.
  • SQLite. Fastcart creates the database files for you; no separate server is required.

Steps

  1. Install front-end dependencies

    pnpm install
  2. Build the Rust workspace

    cargo build --workspace
  3. Initialize the platform

    This creates the platform database and default configuration.

    cargo run -p fastcart-cli -- init --dir .
  4. Create the first owner

    cargo run -p fastcart-cli -- user create \
      --email owner@example.com --password 'change-me-please'
  5. Create a store

    The domain is the Host header storefront requests resolve their store from.

    cargo run -p fastcart-cli -- store create \
      --name "Demo Store" --slug demo --domain shop.example.com \
      --owner-email owner@example.com
  6. Start the API

    cargo run -p fastcart-cli -- serve
  7. Start the admin

    In a second terminal:

    pnpm dev:admin

Check it works

The API listens on http://localhost:8080 and the admin on http://localhost:5174. Sign in with the owner account you created, or choose Explore the demo store on the sign-in screen.

Next steps

Type to search…

↑↓ navigate↵ selectEsc close