Development Setup

Prerequisites

• Rust 1.85+ (stable toolchain)
• Node.js 22+ and npm
• SQLite 3
• sqlx-cli — cargo install sqlx-cli --features sqlite

Initial Setup

# Install frontend dependencies
make frontend-install

# Create development database and run migrations
make dev-db

# Generate sqlx offline cache
make prepare

Running in Development

Run the backend and frontend dev server simultaneously:

# Terminal 1: Backend (port 8080)
cargo run -p storeit-server

# Terminal 2: Frontend dev server (port 5173, proxies API to 8080)
make frontend-dev

Open http://localhost:5173 for hot-reloading frontend development. The Vite dev server proxies all /api requests to the Rust backend.

Without an OIDC provider configured, the mock auth provider is used automatically — any username/password works.

Git Hooks

The project includes a pre-commit hook that automatically runs cargo fmt and cargo clippy --fix before each commit. Enable it with:

git config core.hooksPath .githooks

This ensures formatting and lint issues are fixed locally before they reach CI.

Environment Variables

Copy the defaults or set these in your shell:

export DATABASE_URL="sqlite:./dev.db?mode=rwc"
export STOREIT_BIND="0.0.0.0:8080"
export STOREIT_IMAGE_PATH="./data/images"

See the Configuration page for all options.