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 the journey 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

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 →

The mistakes, kept

The notes page is the best part: silent build hangs, TypeScript 7 surprises, Pages' _headers matching.

Notes →