Learning Hono & Bun

I wanted to learn Hono and Bun. So I built this site with them.

This is a learning project that doubles as its own write-up: a static site pre-rendered from a Hono app and served from Cloudflare Pages, with each step explained on the pages themselves.

There are simpler and more conventional ways to reach the same result. This is the path this project took, the one that taught the most per line of configuration.

src/
toSSG
dist/
edge

What I learned How it works See the code

What you'll find here

The tools I set out to learn

Bun and Hono, used for real: routing, rendering, building, testing, deploying. Nothing else in the pipeline.

The stack →

The features are lessons

Scoped CSS, a strict CSP, layered 404s, crawler files as routes, each one something the project had to figure out.

Features →

What broke, written down

Silent build hangs, TypeScript 7 surprises, Pages' _headers matching. The notes page has them all.

Notes →