Development
Requires Bun. prek comes in as a dev dependency.
bun install # also installs the git hooks
bun dev| Command | What it does |
|---|---|
bun run check | Type check |
bun run lint | Lint with Biome |
bun run lint:fix | Lint and apply fixes |
bun run format | Format TypeScript, Svelte and Markdown |
bun run test | Run the test suite |
bun run screenshots | Regenerate the screenshots in docs/images/ |
bun x prek run -a | Run every git hook against the whole repository |
The hooks format, lint, type check and test on commit, scan for secrets and typos, and require Conventional Commits messages.
Screenshots
bun run screenshots builds the app, starts it on a blank database and drives it with Playwright:
it restores a backup of common homelab apps, connects Umami, then captures the dashboard, the
search palette and Settings in light and dark. A local stand-in answers the link checks and the
Umami API, so nothing outside your machine is needed besides the weather and the icons. It only
runs when you call it. Run bunx playwright install chromium once first.
Stack
SvelteKit 3 (prerelease) on Bun with remote functions, SQLite with Drizzle ORM, Tailwind CSS and shadcn-svelte components.
This guide lives in the project repo: edit it there, and this page follows within a day.