Skip to content

chore: 프로젝트 초기 세팅 (Next.js·API 레이어·커밋 규칙·CI) - #1

Merged
Gomyeunghan merged 6 commits into
mainfrom
chore/initial-setup
Oct 19, 2026
Merged

Gomyeunghan merged 6 commits into
mainfrom
chore/initial-setup

Conversation

@Gomyeunghan

@Gomyeunghan Gomyeunghan commented Oct 16, 2026 •

Copy link
Copy Markdown
Collaborator

작업 내용

FE 개발을 시작하기 위한 프로젝트 초기 세팅입니다.

  • Next.js 16 (App Router) + TypeScript + Tailwind 프로젝트 생성
  • API 레이어: TanStack Query, Zustand, Orval(Swagger → Query 훅·타입·MSW 목 생성), MSW
    • 모든 요청은 src/shared/api/fetcher.ts를 거쳐 Next BFF(/api)로 보냄
    • NEXT_PUBLIC_API_MOCKING=enabled면 브라우저에서 MSW 목 응답 사용
  • 코드·커밋 규칙: ESLint + Prettier, husky + lint-staged(커밋 전 자동 포맷), commitlint(Conventional Commits, 한글 제목 허용)
  • 커밋 작성 도우미: commitizen + cz-git, npm run commit으로 종류·범위·이슈를 선택해 작성
  • 폼: React Hook Form + Zod (@hookform/resolvers)
  • GitHub: PR 템플릿, 이슈 폼(기능·버그·작업), CI(포맷·린트·타입·빌드 + 커밋 메시지·PR 제목 검사)
  • README에 시작 방법, 스크립트, 커밋·브랜치 규칙 정리

확인 사항

  • npm run format:check / lint / typecheck / build 로컬 통과
  • 규칙에 맞지 않는 커밋 메시지는 commitlint가 거부하는 것 확인
  • 샘플 OpenAPI 명세로 orval 생성 후 타입 검사 통과 확인 (샘플은 커밋하지 않음)
  • 백엔드 Swagger가 나오면 OPENAPI_URL 설정 후 npm run api:generate

참고

  • MSW v3, Orval v8 기준이라 이전 버전 문서와 옵션 이름이 다릅니다(onUnhandledFrame, formatter).

🤖 Generated with Claude Code

Gomyeunghan and others added 5 commits October 16, 2026 12:20
create-next-app(App Router, TypeScript, Tailwind)으로 생성하고
ESLint와 Prettier가 충돌하지 않도록 eslint-config-prettier를 적용했다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
커밋 전에 변경 파일에 ESLint·Prettier를 적용하고
커밋 메시지는 Conventional Commits 형식으로 검사한다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Orval이 Swagger로 Query 훅·타입·MSW 목을 생성하도록 설정
- 모든 요청이 Next BFF(/api)를 거치는 fetch 래퍼 추가
- NEXT_PUBLIC_API_MOCKING=enabled일 때 브라우저에서 MSW 사용

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
포맷·린트·타입·빌드와 커밋 메시지·PR 제목 규칙을 검사한다.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration
  • Configuration used: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 6d40b97a-3875-46e7-9dbb-82f73e6dd4a0
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

- npm run commit으로 커밋 종류·범위·이슈를 선택해 작성 (한글 프롬프트)
- 폼 검증용 react-hook-form, zod, @hookform/resolvers 추가
- @hookform/resolvers의 옵셔널 피어(@typeschema/zod)가 zod 3을 요구해
  overrides로 프로젝트의 zod 4에 맞춤

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Gomyeunghan
Gomyeunghan merged commit 5d5e5c8 into main Oct 19, 2026
3 checks passed
@Gomyeunghan Gomyeunghan mentioned this pull request Oct 19, 2026
3 tasks done
@Gomyeunghan
Gomyeunghan deleted the chore/initial-setup branch October 21, 2026 07:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant