A minimal static site starter for GitHub Pages. Uses Vite + TypeScript, run entirely through Deno's Node compatibility. Works out of the box inside the provided nix flake dev shell.

• Deno 2.x (Node compat for npm specifiers)
• Vite 7 + TypeScript 5.9
• Nix flake dev shell for repeatable tooling

# enter dev shell (recommended)
nix develop

# start dev server (http://localhost:5173)
deno task dev

• deno task dev - Vite dev server
• deno task build - Production build to dist/
• deno task preview - Preview the built site
• deno task typecheck - TypeScript --noEmit
• deno task fmt - Format
• deno task lint - Lint
• deno task test - Deno tests

Run before pushing:

deno task fmt --check
deno task lint
deno task typecheck
deno task test   # optional until tests exist
deno task build

1. deno task build (outputs to dist/).
2. Publish dist/ to a gh-pages branch (example):

git worktree add -B gh-pages dist
cd dist && git add . && git commit -m "Publish" && git push origin gh-pages
cd .. && git worktree remove dist

3. In repository settings, configure Pages to serve from the gh-pages branch root.