Development

Requirements: Node 26, pnpm 12, and Rust with the Tauri prerequisites for the desktop app.

In PowerShell, at the project root:

pnpm install
pnpm dev

pnpm dev applies the database migrations, then starts the app. Open http://localhost:3000; the first visit creates the admin account. Settings go in a .env file, see .env.example and Settings.

Commands

Command	Purpose
pnpm dev	Run the app in development
pnpm build	Production build (standalone server bundle)
pnpm start	Run the production build
pnpm lint	ESLint
pnpm typecheck	TypeScript check
pnpm test	Unit tests (Vitest)
pnpm e2e	End to end tests (Playwright)
pnpm db:migrate	Apply database migrations
pnpm desktop:dev	Run the desktop app in development
pnpm desktop:build	Build the desktop installer for the current OS
pnpm docs:dev	Run this documentation site locally
pnpm docs:build	Build this documentation site

Project layout

Folder	Content
src/app	Pages and API routes (Next.js App Router)
src/core	Accounts, database, jobs, layout, themes, plugin host, security
src/modules	Built-in modules, written with the plugin API
packages/plugin-sdk	The plugin SDK
examples	Example plugins and the registry template
src-tauri	The desktop app
site	This documentation site

Documentation

The pages of this site are Markdown files in site/src/content/docs. Every push to main that changes site/ publishes the site to GitHub Pages.

The site is served at docs.holdall.site. To set it up once:

1. The repository must be public (GitHub Pages is not free for private repositories).
2. In Settings, Pages, set Source to GitHub Actions, then Custom domain to docs.holdall.site and turn on Enforce HTTPS once it is offered.
3. At your domain provider, add a CNAME record: docs pointing to toutourina0110.github.io.

The file site/public/CNAME keeps the domain on every publish.