Getting Started

Goal

This snapshot advances Driftwood Daily by teaching you to create a minimal Hono Worker on port 8787.

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 builds a lightweight HTTP app that runs on Cloudflare Workers and local Wrangler dev.

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

Walkthrough

Return JSON from the root path on port 8787.

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

app.get('/', (c) => c.json({ message: 'Driftwood Daily is live' }))

Run and verify

Enter 01-Getting-Started, 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/01-Getting-Started
npm install
cp .env.example .env
npm run dev

Troubleshooting

If the browser cannot connect, confirm wrangler dev is listening on 8787.

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

Add a /health route that returns JSON ok: true.

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