🍪 뉴스를 간식처럼, Snack 🍪

🧑🏻‍💻 Member 👩🏻‍💻

✨ 주요 기능

📰 뉴스 요약 및 읽기

• AI 기반 뉴스 요약 제공
• 카테고리별 뉴스 분류 (정치, 경제, 사회, 국제, 스포츠, 연예, IT/과학)
• 원본 기사 링크 제공

📚 학습 도구

• 용어집: 기사 내 전문 용어 설명
• 퀴즈: 기사 내용 기반 학습 퀴즈
• 메모장: 개인 학습 노트 작성 및 저장

🔍 검색 및 개인화

• 의미론적 검색 (Semantic Search)
• 개인 맞춤 피드 (Custom Feed)
• 스크랩 기능으로 관심 기사 저장

👤 사용자 관리

• 소셜 로그인 (Google)
• 이메일 회원가입/로그인
• 프로필 관리 및 설정

🛠 기술 스택

🎨 Frontend

• React 19 + TypeScript – 최신 React와 타입 안전성
• Vite – 빠른 개발 환경과 빌드
• Tailwind CSS – 유틸리티 기반 스타일링
• React Router DOM – SPA 라우팅

📦 State Management & Data Fetching

• TanStack React Query – 서버 상태 관리
• Context API – 전역 상태 관리 (인증)

💎 UI/UX

• Embla Carousel – 온보딩 카드 캐러셀
• SVG Icons – 벡터 기반 아이콘 시스템

🔧 Development Tools

• ESLint + Prettier – 코드 품질 및 포맷팅
• Husky + lint-staged – Git 훅을 통한 코드 품질 관리
• TypeScript – 정적 타입 검사

🔥 Git Commit Convention

커밋 타입	설명
✨ feat	새로운 기능 추가
🐛 fix	버그 및 오류 수정
📝 docs	문서 수정 (README 등)
🎨 style	코드 포맷팅, 세미콜론 누락 등 (기능 변경 없음)
♻️ refactor	코드 리팩토링 (기능 변경 없음)
✅ test	테스트 코드 추가 및 수정
🔧 chore	빌드 업무, 패키지 매니저 설정 등 기타 작업
💬 comment	필요한 주석 추가 및 변경
🚚 rename	파일, 폴더명 수정 및 이동
🔥 remove	파일, 폴더 삭제
🎉 init	프로젝트 시작 커밋
🧪 TEST	테스트 관련 커밋 (상세 구분 시)

🚀 시작하기

📋 Prerequisites

• Node.js 20.0.0 이상
• pnpm (권장, npm 또는 yarn도 가능)

⚙️ 설치

# 저장소 클론
git clone https://github.com/your-repo/snack-frontend.git
cd snack-frontend

# 패키지 설치
pnpm install

# 개발 서버 실행
pnpm dev

# 테스트 실행
pnpm test