Nomadia : Nomad + Utopia

어디서든 '나답게' 머무는 경험을 시작하세요.

노마디아 (Nomadia) 는 노마드를 위한 액티비티 예약 플랫폼입니다.
사용자가 직접 체험을 등록하고, 다른 노마드의 체험을 예약하며 경험을 공유할 수 있습니다.

배포 링크: https://nomadia-two.vercel.app/

👀 Preview GIF/MP4

회원가입/로그인

메인페이지 캐러셀

메인페이지 리스트

메인페이지 검색

---

체험 등록

_.mp4

마이페이지 내 체험 관리 - 체험 수정

마이페이지 내 체험 관리 - 체험 삭제

마이페이지 예약 내역 - 취소

마이페이지 예약 내역 - 후기 작성

마이페이지 내 예약 현황

---

상세페이지

_.MP4

---

주요 기능

• 💻 체험 등록 - 노마드가 직접 체험을 등록하고 관리
• 📅 예약 시스템 - 실시간 예약 가능 날짜 확인 및 예약
• 🔍 스마트 검색 - 카테고리, 지역별 체험 검색
• 👤 마이페이지 - 예약 내역, 예약 현황, 체험 관리, 프로필 수정

기술 스택

Core Stack

기술	버전	설명
Next.js	15.3.5 (App Router)	파일 기반 라우팅, SSR로 SEO 최적화
TypeScript	5.x	정적 타입으로 개발 안정성 향상
React	19.0.0	최신 기능(Server Components, Suspense) 활용
TailwindCSS	v4 + Turbopack	빠른 빌드와 일관된 디자인 시스템

Data & State Management

기술	설명
TanStack Query	서버 상태 캐싱과 동기화로 API 요청 최적화
Zustand	간단하고 직관적인 클라이언트 상태 관리
Axios	안정적인 HTTP 클라이언트, 인터셉터로 토큰 관리

Form & Validation

기술	설명
React Hook Form	성능 최적화된 폼 라이브러리
Zod	TypeScript 기반 스키마 검증

UI/UX

기술	설명
shadcn/ui	커스터마이징 가능한 컴포넌트 시스템
Framer Motion	부드러운 애니메이션과 인터랙션
Swiper	반응형 캐러셀과 터치 슬라이더

Development & Deployment

기술	설명
Vercel	Next.js 최적화된 배포 플랫폼
Husky + lint-staged	Git Hook으로 코드 품질 자동 검증
Lighthouse CI	성능 및 접근성 지속적 모니터링

R&R

팀원	전지윤(팀장)	김영현	김준우	유동환
페이지, 기능	- 체험 상세 페이지 - 404 페이지, 에러 페이지	- 랜딩 페이지 기획 및 구현 - 메인 페이지 - 예약 내역 페이지 - 체험 등록 페이지	- 예약 현황 페이지 - 체험 검색 기능	- 로그인/회원가입 페이지 - 내 정보/체험 수정 페이지 - 내 체험 관리 페이지
(shared) 공통 컴포넌트, 공통 로직	- Pagination - Modal - Calendar - Infinite Scroll	- Loading Spinner - Skeleton - Carousel - Error Message	- Dropdown - Header - Footer	- Sidebar
기타	- ESLint, Prettier, settings.json 설정 - 프로젝트 리디자인	- 공통 스타일 정의 - husky / LightHouse CI 설정	- 데모 영상	- 배포 - 발표

프로젝트 문서

트러블슈팅

작성자	설명
전지윤	- Next.js 앱 라우터 에러 핸들링: 각 에러 코드에 대한 UI 구현 - 모달 ESC 키 제어 방식 (로컬 vs 전역이벤트) - 예약 중복 요청 방지하기 - [UX] 로그인 성공 후 이전 맥락으로 리다이렉트 - [UX] 모달 warning 이미지 로드 방식 개선(preload 적용)
김영현	- Props Hell 탈출기: Context API로 컴포넌트 최적화 - Form-data 보안 취약점 해결 - Tanstack Query를 활용한 API 중복 요청 해결 - 코드 스플리팅 & lazy loading 적용을 통한 페이지 최적화
김준우	커스텀 클래스 사용 시 타이포그래피 우선순위 문제

공통 컴포넌트, 로직

작성자	설명
전지윤	- 모달 공통 컴포넌트 - 사용 가이드 - 캘린더 공통 컴포넌트 - 설계 구조
김영현	공통 컴포넌트 docs