saju-me-nick

이름·생년월일·태어난 시간·성별·양력/음력을 입력하면 Gemini AI가 사주를 해석해 주는 React 웹 서비스입니다.

주요 기능

• 사주 정보 입력 (이름, 생년월일, 시간, 성별, 양력/음력)
• Gemini(gemini-3.5-flash) 사주 해석
• 스트리밍으로 결과가 실시간 표시
• 로딩 스켈레톤 UI
• 마크다운 표·강조를 읽기 쉬운 HTML로 변환
• 모바일 대응 및 Pretendard 기반 UI

시작하기

1. 의존성 설치

npm install

2. 환경 변수 설정

프로젝트 루트에 .env 파일을 만들고 Gemini API 키를 넣습니다.

VITE_GEMINI_API_KEY=여기에_발급받은_키

키는 Google AI Studio에서 발급받을 수 있습니다.
.env는 Git에 올라가지 않도록 .gitignore에 포함되어 있습니다.

3. 개발 서버 실행

npm run dev

브라우저에서 안내된 주소(보통 http://localhost:5173)로 접속합니다.

vite.config.js의 Gemini 프록시를 쓰므로, 설정 변경 후에는 개발 서버를 재시작하세요.

사용 방법

1. 이름, 생년월일, 태어난 시간, 성별, 양력/음력을 입력합니다.
2. 내 사주 보기를 누릅니다.
3. 해석이 스트리밍으로 나타나며, 표와 강조가 정리된 형태로 표시됩니다.

스크립트

명령	설명
npm run dev	개발 서버 실행
npm run build	프로덕션 빌드
npm run preview	빌드 결과 미리보기
npm run lint	Oxlint 실행

기술 스택

• React 19 + Vite
• Gemini Interactions API (SSE 스트리밍)
• Pretendard