indianboy-web

A Rust-built personal blog and portfolio for indianboy.sh.

The site builder compiles Markdown+ content into static HTML, feeds, metadata, and assets. A small workers-rs WebAssembly Worker runs on Cloudflare Workers and delegates generated assets to Cloudflare Static Assets.

Local build

cargo run -p site-builder

The generated site is written to dist/. All 13 current posts are migrated into content/posts/; the remaining parity work is tracked in docs/PARITY.md.

Validation

cargo fmt --all -- --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
npm ci
npx playwright install chromium

With a local Worker running, execute the HTTP and browser smoke tests:

./tests/route-smoke.sh
BASE_URL=http://localhost:8787 npm run test:browser

Publishing checklist

1. Add content/posts/<slug>.md with title, description or summary, publishedAt, tags, and optional author frontmatter.

2. Add assets/og/<slug>.png for the same slug. Use a 1200×630 image.

3. Build and validate locally:

   cargo run -p site-builder --release
   npx wrangler@4.58.0 dev --local --port 8787
   ./tests/route-smoke.sh
   BASE_URL=http://localhost:8787 npm run test:browser

4. Deploy with npx wrangler@4.58.0 deploy and verify the post, its OG image, RSS entry, sitemap entry, and redirects.

5. Commit and push the source changes. To recover a previous deployment, inspect npx wrangler@4.58.0 deployments list and roll back the intended version.

Cloudflare preview

Install worker-build and Wrangler, then run:

wrangler dev

Design

The visual direction is a quiet technical journal: one reading column, concise archive rows, editorial body text, restrained color, and no sidebar. It borrows content-first principles from the reference sites without copying their branding, artwork, wording, or layout.