Files
viberoom-web/README.md
corpi cbd9017744 feat(fsd): 허브·스페이스 중심 UI 목업 구조로 재편
맥락:

- 기존 라우트/컴포넌트 구조를 FSD 기준으로 정리하고, /app 허브와 /space 집중 화면 중심의 목업 흐름을 구성하기 위해

변경사항:

- App Router 구조를 /landing, /app, /space, /stats, /settings 중심으로 재배치

- entities/session/room/user 더미 데이터와 타입 정의 추가

- features(커스텀 입장, 룸 선택, 체크인, 리액션, 30초 리스타트 등) 단위로 로직 분리

- widgets(허브, 룸 갤러리, 타이머 HUD, 툴 도크 등) 조합형 UI 추가

- shared 공용 UI(Button/Chip/Modal/Toast 등) 및 유틸(cn/useReducedMotion) 정비

- 로그인 후 이동 경로를 /dashboard 에서 /app 으로 변경

- README를 현재 프로젝트 구조/라우트/구현 범위 기준으로 갱신

검증:

- npx tsc --noEmit

세션-상태: 허브·스페이스 목업이 FSD 레이어로 동작 가능하도록 정리됨

세션-다음: /space 상단 및 도크의 인원 수 카피를 분위기형 카피로 후속 정리

세션-리스크: build는 네트워크 환경에서 Google Fonts fetch 실패 가능
2026-02-27 13:30:55 +09:00

1.4 KiB

VibeRoom Web

Next.js(App Router) + TypeScript + TailwindCSS 기반 VibeRoom 프론트엔드입니다.

실행 방법

npm install
npm run dev

브라우저에서 http://localhost:3000 접속

주요 라우트

  • / : Landing 페이지 (src/app/(landing)/page.tsx)
  • /app : 가상공간 입장 허브
  • /space : 집중공간 스켈레톤
  • /stats : 집중 통계 목업
  • /settings : 설정 목업
  • /login : 로그인

구조

FSD 스타일로 src/ 하위 레이어를 사용합니다.

  • src/entities : room/user/session 타입 + 더미 데이터
  • src/features : room-select/check-in/reactions/custom-entry-modal/profile-menu/distraction-dump
  • src/widgets : 페이지 섹션 단위 UI (TopBar, StartRitual, RoomsGallery, SpaceShell 등)
  • src/shared : 공용 UI, 유틸, 설정
  • src/app : App Router 페이지 조합

구현 범위

이번 변경은 UI 목업 중심입니다.

  • 타이머 카운트다운/오디오 재생/실시간/DB 저장/API 호출 미구현
  • 선택 하이라이트, 패널 토글, 모달 탭, 드롭다운, 라우팅, 토스트만 구현

문서(작업 재개용)

세션이 끊겨도 같은 품질로 이어서 작업하려면 아래 문서를 먼저 확인합니다.

  • docs/README.md
  • docs/00_project_brief.md
  • docs/01_ui_guidelines.md
  • docs/02_arch_fsd_rules.md
  • docs/03_routes_map.md
  • docs/90_current_state.md