Recipes Core Pack · Backend

Hono 부트스트랩

경량 API 서버를 빠르게 시작하고 테스트 가능한 구조로 잡기 위한 레시피입니다.

Hono 부트스트랩 프롬프트

복사해서 사용하세요

"Hono API를 최소 구성으로 빠르게 시작하고 싶어. 아래 조건으로 실행 가능한 스타터를 설계해줘. [입력 정보] - 런타임: [Node/Bun/Cloudflare Workers] - 타입 검증: [zod/none] - 저장소: [in-memory/postgres] - 테스트 도구: [vitest/jest] [출력 요구사항] 1) 최소 폴더 구조 2) /health + CRUD 기본 라우트 3) 에러 핸들러/로깅 미들웨어 4) 테스트 1~2개 샘플 5) 로컬 실행/배포 체크리스트"

위 프롬프트를 복사하여 AI 채팅에 붙여넣으세요.

명령어 예시

terminal

npm create hono@latest my-hono-api
cd my-hono-api
npm install
npm run dev

실행 체크리스트

0/5 완료

프로젝트 생성Hono + TypeScript 초기화

핵심 라우트 구성/health 및 기본 CRUD 추가

미들웨어 추가로깅/에러 처리 구성

기본 테스트 작성헬스/CRUD 스모크 테스트

실행 검증로컬 런타임 동작 확인

TL;DR

Hono 부트스트랩 작업 시 필요한 최소 기준과 검증 포인트를 빠르게 확인합니다.
실제 프로젝트 환경값(브랜치, 시크릿, URL, 임계치)은 팀 기준에 맞게 치환하세요.

사전 준비 (Prerequisites)

대상 리포지토리와 실행 환경 접근 권한 확인
로컬/CI에서 사용할 기본 명령어(`install`, `build`, `test`) 점검
환경변수/시크릿/배포 대상 정보를 최신 상태로 정리

실행 순서 (Steps)

변경 목표와 범위를 한 줄로 고정한다.
핵심 변경(Hono 부트스트랩)을 최소 단위 커밋으로 적용한다.
검증 로그를 남기고 체크리스트/문서를 즉시 업데이트한다.

검증 (Validation)

빌드/테스트가 현재 브랜치에서 재현 가능하게 통과하는지 확인
핵심 경로(사용자 플로우 또는 운영 플로우)를 수동 샘플 점검
ko/en 문서와 링크가 동일 의도를 유지하는지 대조

문제 해결 (Troubleshooting)

오류 발생 시 로그/요청 본문/환경값을 먼저 캡처한다.
권한/환경변수/라우팅/빌드 산출물 순서로 원인을 좁힌다.
임시 조치와 근본 원인 수정을 분리해 기록한다.

Hono 부트스트랩