Opinionated React 19 + Vite 8 + TypeScript starter with ESLint (folder structure and module boundaries), i18n, and a single app façade from @/logic. See project-understanding.md for architecture and how-to.md for common tasks.
- Bun (recommended; this repo has a
bun.lock), or Node 20+ with npm/pnpm/yarn - For
bun run depgraph: Graphviz (doton yourPATH) - For
bun run preview: theserveCLI (install globally or runbun add -d serve). If you prefer not to use it, usebun run _previewafter a build (Vite’s built-in preview server)
bun installEquivalent: npm install, pnpm install, or yarn.
Run with bun run <script> (or npm run, pnpm run, yarn).
| Script | Command | Description |
|---|---|---|
| Dev server | bun run dev |
Start Vite dev server (default URL in terminal) |
| Dev (LAN) | bun run devhost |
Dev server bound to all interfaces (bunx --bun vite --host) |
| Dev (HTTPS) | bun run devhttps |
Dev server with HTTPS (USE_HTTPS=true, uses npx vite) |
| Dev (HTTPS + LAN) | bun run devhttpshost |
HTTPS + --host |
| Production build | bun run build |
tsc -b then vite build → output in dist/ |
| Preview (serve) | bun run preview |
Static server on port 4173 for ./dist (needs serve on PATH) |
| Preview (Vite) | bun run _preview |
vite preview for the built app |
| Lint | bun run lint |
ESLint on the project |
| Dependency graph | bun run depgraph |
Writes graph-dependencies.html (needs dot) and opens it in a browser |
- project-understanding.md — layout, stack, routing,
app, ESLint rules - how-to.md — routes, logic, localStorage, config, translations, ESLint structure