Getting Started

Installation

Install Bun and clone this template, then run:

bun install
bun run init
bun run db:push
bun run rbac:init
bun run dev

db:push is for a fresh development database. Initialization does not copy old users, orders or credentials. Register a user through signup and assign its admin role separately.

Environment

Initialization writes .env.development with fresh signing/encryption keys. Features are enabled individually through VITE_APP_MODULE_*; there is no Full/Lite selector. Restart after editing local environment values and rebuild when changing public build-time flags.

Project structure

  • src/routes: TanStack file routes and thin HTTP endpoints.
  • src/blocks: product page sections.
  • src/components: shared UI primitives.
  • src/modules: business services.
  • src/core: auth, providers, storage and database infrastructure.
  • src/content: local posts, guides and optional landing content.
  • messages: flat Paraglide locale messages.

Development configuration

/config edits allowlisted public settings locally. Configure provider secrets through server environment variables or encrypted admin settings.