🔨 chore: 프로젝트 초기 설정

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,2 @@
+blank_issues_enabled: false
+contact_links: []

.github/ISSUE_TEMPLATE/task.yml

@@ -0,0 +1,76 @@
+name: 개발 작업
+description: 기능, 버그, 리팩터링, 문서 및 설정 작업을 등록합니다.
+body:
+  - type: markdown
+    attributes:
+      value: |
+        하나의 이슈에는 하나의 명확한 작업 목표를 작성해 주세요.
+
+  - type: dropdown
+    id: type
+    attributes:
+      label: 작업 유형
+      description: 이슈의 주된 작업 유형을 선택해 주세요.
+      options:
+        - 기능 개발
+        - 버그 수정
+        - 리팩터링
+        - 문서 작업
+        - UI/UX 변경
+        - 테스트
+        - 성능 개선
+        - 보안 개선
+        - 빌드 및 설정
+        - 배포
+    validations:
+      required: true
+
+  - type: textarea
+    id: background
+    attributes:
+      label: 배경 및 목적
+      description: 이 작업이 필요한 이유와 해결하려는 문제를 작성해 주세요.
+      placeholder: 현재 상황, 사용자 문제 또는 기술적인 배경을 작성해 주세요.
+    validations:
+      required: true
+
+  - type: textarea
+    id: details
+    attributes:
+      label: 작업 내용
+      description: 구현하거나 변경할 내용을 구체적으로 작성해 주세요. 버그라면 재현 방법과 기대 결과를 함께 작성해 주세요.
+      placeholder: |
+        - 변경할 화면, 기능 또는 코드
+        - 주요 동작과 예외 상황
+        - 버그 재현 방법과 기대 결과
+    validations:
+      required: true
+
+  - type: textarea
+    id: tasks
+    attributes:
+      label: 세부 작업
+      description: 필요한 작업을 체크리스트로 작성해 주세요.
+      value: |
+        - [ ]
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: 완료 조건
+      description: 이 이슈를 완료로 판단할 수 있는 조건과 검증 방법을 작성해 주세요.
+      value: |
+        - [ ] 주요 동작을 확인했다.
+        - [ ] 관련 정적 검사와 테스트를 통과했다.
+    validations:
+      required: true
+
+  - type: textarea
+    id: references
+    attributes:
+      label: 참고 자료
+      description: 디자인, API 명세, 관련 이슈, 로그 또는 스크린샷을 첨부해 주세요.
+    validations:
+      required: false

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,45 @@
+## 작업 내용
+
+<!-- 이 PR에서 변경한 내용과 변경 이유를 작성해 주세요. -->
+
+-
+
+## 관련 이슈
+
+<!-- 병합 시 종료할 이슈 번호를 작성해 주세요. 예: Closes #12 -->
+
+- Closes #
+
+## 변경 유형
+
+- [ ] 새로운 기능
+- [ ] 버그 수정
+- [ ] 리팩터링
+- [ ] UI/UX 변경
+- [ ] 문서 또는 설정 변경
+
+## 주요 변경 사항
+
+<!-- 리뷰어가 중점적으로 확인할 내용을 작성해 주세요. -->
+
+-
+
+## 스크린샷
+
+<!-- UI 변경이 있다면 변경 전후 이미지 또는 Chromatic 링크를 첨부해 주세요. UI 변경이 없다면 이 항목을 삭제해 주세요. -->
+
+## 검증
+
+<!-- 실행한 검증 방법과 결과를 작성해 주세요. 적용되지 않는 항목은 이유를 남겨 주세요. -->
+
+- [ ] 주요 사용자 흐름을 직접 확인했습니다.
+- [ ] `pnpm lint`를 통과했습니다.
+- [ ] `pnpm build`를 통과했습니다.
+- [ ] 모바일과 데스크톱 화면을 확인했습니다.
+- [ ] 관련 Storybook 스토리를 확인했습니다.
+
+## 참고 사항
+
+<!-- 리뷰 또는 배포 시 알아야 할 내용이 있다면 작성해 주세요. -->
+
+-

.github/workflows/chromatic.yml

@@ -0,0 +1,47 @@
+name: Chromatic
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: chromatic-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  chromatic:
+    name: Visual tests
+    runs-on: ubuntu-latest
+    env:
+      CHROMATIC_PROJECT_TOKEN: ${{ secrets.CHROMATIC_PROJECT_TOKEN }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+
+      - name: Set up pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11.15.0
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version-file: .node-version
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Publish to Chromatic
+        if: env.CHROMATIC_PROJECT_TOKEN != ''
+        uses: chromaui/action@latest
+        with:
+          projectToken: ${{ secrets.CHROMATIC_PROJECT_TOKEN }}
+          onlyChanged: true

.gitignore

@@ -2,11 +2,18 @@
 
 # dependencies
 /node_modules
+/.pnpm-store/
 /.pnp
-.pnp.js
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
 
 # testing
 /coverage
+/storybook-static/
 
 # next.js
 /.next/
@@ -23,10 +30,15 @@
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
-
-# local env files
-.env*.local
-.env
+.pnpm-debug.log*
+build-storybook.log
+chromatic.log
+chromatic-build-*.xml
+chromatic-diagnostics.json
+debug-storybook.log
+
+# env files (can opt-in for committing if needed)
+.env*
 
 # vercel
 .vercel

.node-version

@@ -0,0 +1 @@
+v24.18.0

.storybook/main.ts

@@ -0,0 +1,17 @@
+import type { StorybookConfig } from "@storybook/nextjs-vite";
+
+const config: StorybookConfig = {
+  stories: ["../src/**/*.stories.@(js|jsx|mjs|ts|tsx)"],
+  addons: [
+    "@storybook/addon-docs",
+    "@storybook/addon-a11y",
+    "@chromatic-com/storybook",
+  ],
+  framework: {
+    name: "@storybook/nextjs-vite",
+    options: {},
+  },
+  staticDirs: ["../public"],
+};
+
+export default config;

.storybook/preview.ts

@@ -0,0 +1,22 @@
+import type { Preview } from "@storybook/nextjs-vite";
+
+import "../src/app/globals.css";
+
+const preview: Preview = {
+  parameters: {
+    controls: {
+      matchers: {
+        color: /(background|color)$/i,
+        date: /Date$/i,
+      },
+    },
+    options: {
+      storySort: {
+        order: ["Shared", "Entities", "Features", "Widgets", "Views", "Pages"],
+      },
+    },
+  },
+  tags: ["autodocs"],
+};
+
+export default preview;