Skip to main content

The stack

What I set out to learn

Two tools and a host: Bun, Hono, and Cloudflare Pages. Nothing here is exotic; each one does the part it is best at. Click any row for its docs.

There are easier stacks, and there are fancier ones. This one taught the most per line of configuration.

Bunruntime, package manager, transpiler, test runnerBun transpiles the TSX, serves the dev server, runs the build, and runs the tests. No Node, no npm, no separate compiler.bun.com/docs →Honothe app itselfRouting, JSX rendering, middleware, and the SSG helper that bakes every route to a static file. The only runtime dependency in package.json.hono.dev →Hono on Bunthe guide this project effectively starts fromThe official getting-started page shows a Hono app running on Bun, roughly the first four lines of this repository.hono.dev/docs/getting-started/bun →hono/cssscoped styles, emitted inlineA css template literal that returns a stable class name; the <Style /> component collects the styles and prints them once per page.hono.dev/docs/helpers/css →Cloudflare Pagesthe hostThe Git integration runs the build on every push and serves the output from the edge. It understands _headers and 404.html natively.developers.cloudflare.com/pages →Wranglerthe local stand-in for Pageswrangler pages dev is the only tool that reproduces the Pages shape on a laptop: real 404s, headers applied, custom 404 page working.developers.cloudflare.com/workers/wrangler →

Want every detail? The project lives in this repository, README, tests, and history included.