← All projects

Part 3 of this project

Layout and UI

Render Hono JSX pages with Simple.css.

Goal

This snapshot advances Driftwood Daily by teaching you to render Hono JSX pages with Simple.css.

Every numbered folder is a complete app. Run this stage independently, then compare it with the previous folder.

Prerequisites

Use Node.js 20+, npm, and the Wrangler CLI. You should recognize async functions and HTTP verbs.

Port 8787 must be free. Copy .env.example before starting database stages.

  • Node.js and npm
  • A code editor and terminal
  • Wrangler from part 4 onward

Concepts

Hono JSX escapes values by default. Shared layout components keep navigation consistent.

Keep handlers thin: routes accept input, D1 queries enforce rules, and Hono JSX escapes output by default.

Walkthrough

Define a Layout component and pass sample posts to home.

Read the example, then open the matching snapshot. The repository includes the surrounding setup and error handling.

return c.html(<Layout title="Home"><Home posts={SAMPLE} /></Layout>)

Run and verify

Enter 03-Layout-And-UI, install dependencies, copy .env.example when present, and start Wrangler on port 8787.

Open http://127.0.0.1:8787. Watch the terminal for validation and database errors.

git clone https://github.com/michaeldunga1/fcc-hono-blog.git
cd fcc-hono-blog/03-Layout-And-UI
npm install
cp .env.example .env
npm run dev

Troubleshooting

Missing JSX usually means tsconfig jsxImportSource is not hono/jsx.

For D1 failures, confirm Wrangler is running and the driftwood_NN binding matches this folder. Never commit .env or .wrangler secrets.

  • Read the first error first
  • Restart after environment changes
  • Never commit secrets

Try this

Render a friendly empty state when posts is empty.

Test a happy path and one invalid or unauthorized request.

  • Make one small change
  • Test it in the browser
  • Compare with the next snapshot only after it works

Related tutorials