[CHORE] 프론트엔드 개발환경 세팅

.github/ISSUE_TEMPLATE/bug.md

@@ -0,0 +1,37 @@
+---
+name: Bug
+about: 버그 발생 시 사용하는 이슈입니다.
+title: "[BUG]"
+labels: BugFix
+assignees: chaeyoungwon
+type: Bug
+---
+
+<!-- 작성하지 않은 항목은 모두 지워주세요 -->
+
+## 🐞 Bug description
+
+<!-- 어떤 상황에서 어떤 문제가 발생했는지 구체적으로 작성해주세요 -->
+
+<br/>
+
+## 🐛 Error log
+<!-- 콘솔에 찍힌 에러 로그나 네트워크 응답 에러가 있다면 코드 블럭에 포함해주세요 -->
+
+
+<br/>
+
+## ✅ 작업할 내용
+<!-- 이 버그를 해결하기 위해 예상되는 작업을 세분화해서 체크박스 형태로 작성해주세요 -->
+- [ ] 
+
+<br/>
+
+## 📸 스크린샷
+<!-- 시각적으로 이해를 돕기 위한 스크린샷이 있다면 첨부해주세요 -->
+
+<br/>
+
+
+## 📑참고 문서
+<!-- 참고할 수 있는 자료가 있다면 적어주세요 -->

.github/ISSUE_TEMPLATE/feature.md

@@ -0,0 +1,29 @@
+---
+name: Feature
+about: 기능 개발 및 세팅 작업에 사용하는 이슈입니다.
+title: ""
+labels: ""
+assignees: chaeyoungwon
+---
+
+## 📝 IssueName
+
+> 이슈 명을 작성해주세요.
+
+<br/>
+
+## 📝 Description
+
+> 이슈에 대해 간결하게 설명해주세요.
+
+<br/>
+
+## 📝 Todo
+
+> 작업 목록을 작성해주세요.
+
+<br/>
+
+## 📝 참고 사항
+
+> 참고 사항을 적어주세요. 해당 작업을 하는 사람이 참고해야 하는 내용을 자유로운 형식으로 적을 수 있습니다.

.github/pull_request_template.md

@@ -0,0 +1,28 @@
+## ‼️ 관련 이슈
+
+<!-- 해당 PR과 관련된 이슈 번호가 있다면 "- #22" 형태로 작성해주세요 -->
+
+close #
+
+<br/>
+
+## 🔎 개요
+
+<!-- 구현한 기능에 대해 간단하게 설명해주세요 -->
+
+<br/>
+
+## 📝 작업 내용
+<!-- 구현한 기능에 대한 구체적인 내용을 작성해주세요 -->
+
+
+<br/>
+
+## 👀 변경 사항
+<!-- 컴포넌트, API, 로직 등 코드 변경으로 인해 협업 시 다른 개발자가 주의해야 할 내용이 있다면 작성해주세요 -->
+
+
+<br/>
+
+## 📸 스크린샷 (Optional)
+<!-- UI에 변경이 있을 경우, 실제 화면을 캡처해서 첨부해주세요 -->

.gitignore

@@ -0,0 +1,32 @@
+# dependencies
+node_modules/
+.pnp
+.pnp.*
+
+# pnpm
+.pnpm-store/
+
+# build outputs
+.next/
+out/
+build/
+dist/
+coverage/
+
+# env
+.env*
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+.pnpm-debug.log*
+
+# system
+.DS_Store
+*.pem
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

.husky/pre-commit

@@ -0,0 +1 @@
+pnpm --filter festival-app/frontend lint-staged

.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+  "prettier.prettierPath": "festival-app/frontend/node_modules/prettier/index.cjs"
+}

festival-app/frontend/.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

festival-app/frontend/.prettierignore

@@ -0,0 +1,8 @@
+.next
+node_modules
+out
+build
+coverage
+pnpm-lock.yaml
+next-env.d.ts
+*.tsbuildinfo

festival-app/frontend/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "arrowParens": "always",
+  "plugins": ["prettier-plugin-tailwindcss"]
+}

festival-app/frontend/README.md

@@ -0,0 +1,42 @@
+# Festival Frontend
+
+대학 축제 플랫폼의 프론트엔드 프로젝트입니다.  
+공연 티켓 예매, 부스 예약, 축제 타임라인, 안내도 등의 기능을 사용자에게 제공합니다.
+
+프론트엔드와 백엔드는 pnpm workspace 기반의 모노레포 환경에서 함께 관리하며,  
+VSCode Codex Extension을 활용한 바이브 코딩 기반으로 개발을 진행합니다.
+
+<br/>
+
+## 🛠 Tech Stack
+
+- Next.js 16 (App Router)
+- TypeScript
+- Tailwind CSS
+- pnpm workspace
+- ESLint
+- Prettier
+- Husky
+- lint-staged
+
+<br/>
+
+## 📦 Project Structure
+
+프론트엔드는 역할별 디렉토리를 기준으로 파일을 분리하고,  
+각 디렉토리 내부에서는 기능 도메인별로 세분화하여 관리합니다.
+
+```bash
+src/
+├── app/                         # Next.js App Router
+├── components/                  # 공통 UI 컴포넌트
+│   ├── tickets/
+│   ├── booths/
+│   ├── timeline/
+│   └── common/
+├── constants/                   # 상수 값 관리
+├── hooks/                       # 커스텀 훅
+├── styles/              # 전역 스타일 및 스타일 관련 파일
+├── types/                       # 공통 TypeScript 타입
+└── utils/                       # 공통 유틸 함수
+```

festival-app/frontend/eslint.config.mjs

@@ -0,0 +1,41 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+import simpleImportSort from "eslint-plugin-simple-import-sort";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  {
+    plugins: {
+      "simple-import-sort": simpleImportSort,
+    },
+    rules: {
+      "simple-import-sort/imports": [
+        "error",
+        {
+          groups: [
+            ["^\\u0000"],
+            ["^node:"],
+            ["^react", "^next", "^@?\\w"],
+            ["^@/"],
+            ["^\\.\\.(?!/?$)", "^\\.\\./?$"],
+            ["^\\./(?=.*/)(?!/?$)", "^\\.(?!/?$)", "^\\./?$"],
+            ["^.+\\.s?css$"],
+          ],
+        },
+      ],
+      "simple-import-sort/exports": "error",
+    },
+  },
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

festival-app/frontend/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+};
+
+export default nextConfig;

festival-app/frontend/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "frontend",
+  "version": "0.1.0",
+  "private": true,
+  "packageManager": "pnpm@10.33.2",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier . --write",
+    "lint-staged": "lint-staged",
+    "format:check": "prettier . --check"
+  },
+  "dependencies": {
+    "next": "16.2.6",
+    "react": "19.2.4",
+    "react-dom": "19.2.4"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.2.6",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.7.4",
+    "prettier-plugin-tailwindcss": "^0.8.0",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,mjs,cjs}": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,css,md,mdx,yml,yaml}": [
+      "prettier --write"
+    ]
+  }
+}

festival-app/frontend/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

festival-app/frontend/src/app/globals.css

@@ -0,0 +1,5 @@
+@import "tailwindcss";
+
+body {
+  font-family: Arial, Helvetica, sans-serif;
+}

festival-app/frontend/src/app/layout.tsx

@@ -0,0 +1,21 @@
+import type { Metadata } from "next";
+
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "Hongik Festival",
+  description:
+    "홍익대학교 축제 공연, 부스, 타임테이블 정보를 쉽고 빠르게 확인할 수 있는 축제 플랫폼입니다.",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="ko" className="h-full antialiased">
+      <body className="flex min-h-full flex-col">{children}</body>
+    </html>
+  );
+}

festival-app/frontend/src/app/page.tsx

@@ -0,0 +1,3 @@
+export default function Home() {
+  return <div className="flex flex-1 flex-col items-center justify-center"></div>;
+}