project-init

Initialize Hono Project

Create a new Hono project with proper structure and configuration.

Workflow

Step 1: Choose Template

Ask the user which template to use:

1. Bun + Cloudflare Workers (Recommended)

   • Development with Bun's hot reload
   • Deployment to Cloudflare Workers
   • D1 database, KV, R2 support

2. Bun Standalone

   • Pure Bun runtime
   • Local development and deployment
   • Bun SQLite for database

3. Cloudflare Workers Only

   • Wrangler for dev and deploy
   • Full CF ecosystem

Step 2: Create Project

Template: Bun + Cloudflare Workers

# Create project directory
mkdir {project-name} && cd {project-name}

# Initialize with Bun
bun init -y

# Install dependencies
bun add hono @hono/zod-validator zod
bun add -d @cloudflare/workers-types wrangler typescript

package.json:

{
  "name": "{project-name}",
  "scripts": {
    "dev": "bun run --hot src/index.ts",
    "dev:cf": "wrangler dev src/index.ts",
    "deploy": "wrangler deploy",
    "test": "bun test",
    "typecheck": "tsc --noEmit"
  },
  "dependencies": {
    "hono": "^4.0.0",
    "@hono/zod-validator": "^0.4.0",
    "zod": "^3.23.0"
  },
  "devDependencies": {
    "@cloudflare/workers-types": "^4.0.0",
    "typescript": "^5.0.0",
    "wrangler": "^3.0.0"
  }
}

tsconfig.json:

{
  "compilerOptions": {
    "target": "ESNext",
    "module": "ESNext",
    "moduleResolution": "bundler",
    "strict": true,
    "skipLibCheck": true,
    "lib": ["ESNext"],
    "types": ["@cloudflare/workers-types", "bun-types"],
    "jsx": "react-jsx",
    "jsxImportSource": "hono/jsx",
    "baseUrl": ".",
    "paths": {
      "@/*": ["src/*"]
    }
  },
  "include": ["src/**/*", "tests/**/*"],
  "exclude": ["node_modules"]
}

wrangler.toml:

name = "{project-name}"
main = "src/index.ts"
compatibility_date = "2024-01-01"

[vars]
ENVIRONMENT = "production"

# Uncomment to enable D1
# [[d1_databases]]
# binding = "DB"
# database_name = "{project-name}-db"
# database_id = "your-database-id"

# Uncomment to enable KV
# [[kv_namespaces]]
# binding = "KV"
# id = "your-kv-id"

# Uncomment to enable R2
# [[r2_buckets]]
# binding = "BUCKET"
# bucket_name = "{project-name}-bucket"