Deploy Bun + Hono REST API lên Vercel miễn phí

# Kiểm tra Bun đã cài đặt
bun --version   # 1.x.x
 
# Kiểm tra Git đã cài đặt
git --version   # git version 2.x.x

bun create hono my-api

? Which template do you want to use?
  aws-lambda
  bun
  cloudflare-pages
  cloudflare-workers
  deno
  fastly
  lambda-edge
  netlify
  nextjs
❯ vercel
  ...

cd my-api
bun install

my-api/
├── api/
│   └── index.ts        # Entry point của Vercel serverless
├── src/
│   └── index.ts        # Ứng dụng Hono chính
├── package.json
├── tsconfig.json
└── .gitignore

// api/index.ts
import { handle } from 'hono/vercel'
import app from '../src/index'
 
export const config = {
  runtime: 'edge',
}
 
export default handle(app)

// src/index.ts
import { Hono } from 'hono'
 
const app = new Hono().basePath('/api')
 
app.get('/', (c) => {
  return c.json({ message: 'Hello Hono!' })
})
 
export default app

mkdir -p src/routes
touch src/routes/tasks.ts

// src/routes/tasks.ts
import { Hono } from 'hono'
import { zValidator } from '@hono/zod-validator'
import { z } from 'zod'
 
// In-memory store (thay bằng DB thực trong production)
type Task = {
  id: string
  title: string
  done: boolean
  createdAt: string
}
 
const tasks: Task[] = [
  { id: '1', title: 'Learn Bun', done: true, createdAt: new Date().toISOString() },
  { id: '2', title: 'Build with Hono', done: false, createdAt: new Date().toISOString() },
]
 
const createTaskSchema = z.object({
  title: z.string().min(1).max(200),
})
 
const tasksRouter = new Hono()
 
// GET /api/tasks - Lấy danh sách tất cả tasks
tasksRouter.get('/', (c) => {
  return c.json({ tasks, total: tasks.length })
})
 
// GET /api/tasks/:id - Lấy một task cụ thể
tasksRouter.get('/:id', (c) => {
  const task = tasks.find((t) => t.id === c.req.param('id'))
  if (!task) {
    return c.json({ error: 'Task not found' }, 404)
  }
  return c.json({ task })
})
 
// POST /api/tasks - Tạo task mới
tasksRouter.post('/', zValidator('json', createTaskSchema), (c) => {
  const { title } = c.req.valid('json')
  const newTask: Task = {
    id: String(Date.now()),
    title,
    done: false,
    createdAt: new Date().toISOString(),
  }
  tasks.push(newTask)
  return c.json({ task: newTask }, 201)
})
 
// PATCH /api/tasks/:id - Chuyển đổi trạng thái done
tasksRouter.patch('/:id', (c) => {
  const task = tasks.find((t) => t.id === c.req.param('id'))
  if (!task) {
    return c.json({ error: 'Task not found' }, 404)
  }
  task.done = !task.done
  return c.json({ task })
})
 
// DELETE /api/tasks/:id - Xóa task
tasksRouter.delete('/:id', (c) => {
  const index = tasks.findIndex((t) => t.id === c.req.param('id'))
  if (index === -1) {
    return c.json({ error: 'Task not found' }, 404)
  }
  const [deleted] = tasks.splice(index, 1)
  return c.json({ task: deleted })
})
 
export default tasksRouter

bun add @hono/zod-validator zod

// src/index.ts
import { Hono } from 'hono'
import { cors } from 'hono/cors'
import { logger } from 'hono/logger'
import tasksRouter from './routes/tasks'
 
const app = new Hono().basePath('/api')
 
// Middlewares
app.use('*', logger())
app.use('*', cors())
 
// Routes
app.route('/tasks', tasksRouter)
 
// Health check
app.get('/health', (c) => {
  return c.json({
    status: 'ok',
    runtime: 'edge',
    timestamp: new Date().toISOString(),
  })
})
 
// 404 fallback
app.notFound((c) => {
  return c.json({ error: 'Not found' }, 404)
})
 
export default app

bun run dev

# Health check
curl http://localhost:3000/api/health
 
# Lấy danh sách tasks
curl http://localhost:3000/api/tasks
 
# Tạo task mới
curl -X POST http://localhost:3000/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"title": "Deploy to Vercel"}'
 
# Lấy một task
curl http://localhost:3000/api/tasks/1
 
# Chuyển đổi trạng thái done
curl -X PATCH http://localhost:3000/api/tasks/1
 
# Xóa task
curl -X DELETE http://localhost:3000/api/tasks/1

{
  "status": "ok",
  "runtime": "edge",
  "timestamp": "2026-02-11T10:00:00.000Z"
}

// src/index.ts (cập nhật)
import { Hono } from 'hono'
import { cors } from 'hono/cors'
import { logger } from 'hono/logger'
import tasksRouter from './routes/tasks'
 
// Khai báo kiểu cho env vars để có type safety đầy đủ
type Env = {
  Bindings: {
    DATABASE_URL: string
    API_SECRET: string
  }
}
 
const app = new Hono<Env>().basePath('/api')
 
app.use('*', logger())
app.use('*', cors())
app.route('/tasks', tasksRouter)
 
app.get('/health', (c) => {
  // Truy cập env vars qua c.env (Edge Runtime) hoặc process.env (Node.js)
  const hasDb = !!c.env?.DATABASE_URL || !!process.env.DATABASE_URL
  return c.json({
    status: 'ok',
    database: hasDb ? 'connected' : 'not configured',
    timestamp: new Date().toISOString(),
  })
})
 
app.notFound((c) => c.json({ error: 'Not found' }, 404))
 
export default app

# .env.local
DATABASE_URL=postgresql://user:pass@localhost:5432/mydb
API_SECRET=my-local-secret

# .gitignore
node_modules/
.env
.env.local
.env*.local
.vercel

# Khởi tạo git repo
git init
 
# Stage tất cả files
git add .
 
# Commit đầu tiên
git commit -m "feat: init Hono API with Vercel adapter"
 
# Thêm remote GitHub (thay YOUR_USERNAME bằng username GitHub của bạn)
git remote add origin https://github.com/YOUR_USERNAME/my-api.git
 
# Push lên GitHub
git branch -M main
git push -u origin main

✓ Build completed
✓ Deployment complete
🚀 https://my-api-yourusername.vercel.app

BASE_URL="https://my-api-yourusername.vercel.app"
 
# Health check
curl $BASE_URL/api/health
 
# Lấy danh sách tasks
curl $BASE_URL/api/tasks
 
# Tạo task mới
curl -X POST $BASE_URL/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"title": "First production task"}'

// src/index.ts
app.get('/health', (c) => {
  return c.json({
    status: 'ok',
    version: '1.1.0',       // Thêm dòng này
    runtime: 'edge',
    timestamp: new Date().toISOString(),
  })
})

git add .
git commit -m "feat: add version to health check"
git push

{
  "rewrites": [
    {
      "source": "/api/(.*)",
      "destination": "/api/index"
    }
  ]
}

// api/index.ts — biến thể Node.js runtime
import { handle } from 'hono/vercel'
import app from '../src/index'
 
export const config = {
  runtime: 'nodejs',   // Đổi từ 'edge'
  maxDuration: 60,     // Tối đa 60s trên free tier
}
 
export default handle(app)

{
  "name": "my-api",
  "version": "1.0.0",
  "scripts": {
    "dev": "bun run --hot src/index.ts",
    "build": "bun build ./api/index.ts --outdir ./dist",
    "start": "bun run dist/index.js"
  },
  "dependencies": {
    "@hono/zod-validator": "^0.4.1",
    "hono": "^4.6.0",
    "zod": "^3.23.8"
  },
  "devDependencies": {
    "@types/bun": "latest",
    "typescript": "^5.0.0"
  }
}

my-api/
├── api/
│   └── index.ts          # Entry point Vercel (edge runtime)
├── src/
│   ├── index.ts           # Hono app + middleware
│   └── routes/
│       └── tasks.ts       # Task CRUD router
├── .env.local             # Secrets local (git-ignored)
├── .gitignore
├── package.json
├── tsconfig.json
└── vercel.json            # Cấu hình Vercel tùy chọn

export default handle(app)

app.use('*', cors({
  origin: ['https://yourfrontend.com', 'http://localhost:5173'],
}))

bun add -d @types/bun