React/Next.js 개발 워크플로우
개요
App Router, Server Components, TypeScript, Tailwind CSS를 포함한 최신 패턴으로 React 및 Next.js 14+ 애플리케이션을 구축하기 위한 특화된 워크플로우입니다.
이 워크플로우를 사용해야 하는 경우
다음과 같은 경우 이 워크플로우를 사용하세요:
- 새로운 React 애플리케이션 구축 시
- App Router를 사용하는 Next.js 14+ 프로젝트 생성 시
- Server Components 구현 시
- TypeScript와 React 연동 설정 시
- Tailwind CSS로 스타일링 시
- 풀스택 Next.js 애플리케이션 구축 시
워크플로우 단계
1단계: 프로젝트 설정
호출할 스킬
app-builder- 애플리케이션 스캐폴딩senior-fullstack- 풀스택 가이드nextjs-app-router-patterns- Next.js 14+ 패턴typescript-pro- TypeScript 설정
작업
- 프로젝트 유형 선택 (React SPA, Next.js 앱)
- 빌드 도구 선택 (Vite, Next.js, Create React App)
- 프로젝트 구조 스캐폴딩
- TypeScript 구성
- ESLint 및 Prettier 설정
복사-붙여넣기 프롬프트
@app-builder를 사용하여 App Router로 새 Next.js 14 프로젝트 스캐폴딩
@nextjs-app-router-patterns를 사용하여 Server Components 설정
2단계: 컴포넌트 아키텍처
호출할 스킬
frontend-developer- 컴포넌트 개발react-patterns- React 패턴react-state-management- 상태 관리react-ui-patterns- UI 패턴
작업
- 컴포넌트 계층 설계
- 기본 컴포넌트 생성
- 레이아웃 컴포넌트 구현
- 상태 관리 설정
- 커스텀 훅 생성
복사-붙여넣기 프롬프트
@frontend-developer를 사용하여 재사용 가능한 React 컴포넌트 생성
@react-patterns를 사용하여 적절한 컴포넌트 구성 구현
@react-state-management를 사용하여 Zustand 스토어 설정
3단계: 스타일링 및 디자인
호출할 스킬
frontend-design- UI 디자인tailwind-patterns- Tailwind CSStailwind-design-system- 디자인 시스템core-components- 컴포넌트 라이브러리
작업
- Tailwind CSS 설정
- 디자인 토큰 구성
- 유틸리티 클래스 생성
- 컴포넌트 스타일 구축
- 반응형 디자인 구현
복사-붙여넣기 프롬프트
@tailwind-patterns를 사용하여 Tailwind CSS v4로 컴포넌트 스타일링
@frontend-design를 사용하여 현대적인 대시보드 UI 생성
4단계: 데이터 페칭
호출할 스킬
nextjs-app-router-patterns- Server Componentsreact-state-management- React Queryapi-patterns- API 통합
작업
- Server Components 구현
- React Query/SWR 설정
- API 클라이언트 생성
- 로딩 상태 처리
- 에러 경계 구현
복사-붙여넣기 프롬프트
@nextjs-app-router-patterns를 사용하여 Server Components 데이터 페칭 구현
5단계: 라우팅 및 내비게이션
호출할 스킬
nextjs-app-router-patterns- App Routernextjs-best-practices- Next.js 패턴
작업
- 파일 기반 라우팅 설정
- 동적 라우트 생성
- 중첩 라우트 구현
- 라우트 가드 추가
- 리다이렉트 구성
복사-붙여넣기 프롬프트
@nextjs-app-router-patterns를 사용하여 병렬 라우트 및 인터셉팅 라우트 설정
6단계: 폼 및 유효성 검사
호출할 스킬
frontend-developer- 폼 개발typescript-advanced-types- 타입 유효성 검사react-ui-patterns- 폼 패턴
작업
- 폼 라이브러리 선택 (React Hook Form, Formik)
- 유효성 검사 설정 (Zod, Yup)
- 폼 컴포넌트 생성
- 제출 처리
- 에러 처리 구현
복사-붙여넣기 프롬프트
@frontend-developer를 사용하여 React Hook Form과 Zod로 폼 생성
7단계: 테스팅
호출할 스킬
javascript-testing-patterns- Jest/Vitestplaywright-skill- E2E 테스팅e2e-testing-patterns- E2E 패턴
작업
- 테스트 프레임워크 설정
- 단위 테스트 작성
- 컴포넌트 테스트 생성
- E2E 테스트 구현
- CI 통합 구성
복사-붙여넣기 프롬프트
@javascript-testing-patterns를 사용하여 Vitest 테스트 작성
@playwright-skill를 사용하여 중요 흐름에 대한 E2E 테스트 생성
8단계: 빌드 및 배포
호출할 스킬
vercel-deployment- Vercel 배포vercel-deploy-claimable- Vercel 배포web-performance-optimization- 성능
작업
- 빌드 설정 구성
- 번들 크기 최적화
- 환경 변수 설정
- Vercel에 배포
- 프리뷰 배포 구성
복사-붙여넣기 프롬프트
@vercel-deployment를 사용하여 Next.js 앱을 프로덕션에 배포
기술 스택
| 카테고리 | 기술 |
|---|---|
| 프레임워크 | Next.js 14+, React 18+ |
| 언어 | TypeScript 5+ |
| 스타일링 | Tailwind CSS v4 |
| 상태 관리 | Zustand, React Query |
| 폼 | React Hook Form, Zod |
| 테스팅 | Vitest, Playwright |
| 배포 | Vercel |
품질 게이트
- TypeScript 컴파일 오류 없음
- 모든 테스트 통과
- 린트 클린
- 성능 지표 충족 (LCP, CLS, FID)
- 접근성 확인 (WCAG 2.1)
- 반응형 디자인 검증
관련 워크플로우 번들
development- 일반 개발testing-qa- 테스팅 워크플로우documentation- 문서화typescript-development- TypeScript 패턴