README.md

🎬 KPlex : Movie Information App

TMDB API와 Supabase를 활용하여 제작한 영화 정보 및 커뮤니티 애플리케이션입니다.

🔗 라이브 데모 보러가기 - https://kplex.vercel.app/

📸 Preview

홈 (Home)	상세 정보 (Detail)	리스트 (List)	검색 (Search)

✨ Key Features

• 영화 탐색: 인기 영화, 추천 영화, 장르별 영화 리스트 제공
• 직관적인 평점 UI: 10점 만점의 데이터를 5점 만점의 별점 UI(반 스크롤 포함) 로 변환하여 시각화 구현
• 검색 기능: 실시간 영화 검색 기능
• 회원 인증 (Supabase): 빠르고 안전한 소셜 로그인 (Google, Kakao 등) 지원
• 마이페이지 기능: 관심 영화 스크랩 및 보관 기능
• 커뮤니티 (리뷰): 영화에 대한 리뷰 작성, 수정 및 삭제 기능

🛠️ Tech Stack

• Frontend: React (v19.2.4), React-Router-Dom, Axios, Swiper
• Backend & Auth / DB: Supabase
• Build Tool: Vite
• External API: TMDB API

🚀 Getting Started

Prerequisites

• Node.js 설치
• 환경 변수 세팅 (.env 파일에 TMDB API Key 및 Supabase API 정보 입력 필요)

Installation & Run

# 1. 패키지 설치
$ npm install

# 2. 로컬 서버 실행
$ npm run dev

# 3. 배포용 빌드 (Production)
$ npm run build

📚 API Reference (TMDB)

해당 프로젝트는 TMDB API를 기반으로 작성되었습니다.

• 현재 상영작 (Now Playing): /movie/now_playing
• 인기 영화 (Popular): /movie/popular
• 장르 (Genre): /genre/movie/list
• 영화 검색 (Search): /search/movie
• 영화 상세 스태프 크레딧: /movie/{movie_id}/credits
• 영화 발견 (Discover): /discover/movie

🔗 References & Tools

• 영화 API 사용법 참고 (Velog)
• React에서 Axios 사용하기 (Velog)
• JSON View Chrome Extension