refboard
최근 수정 시각: 2026-07-11 00:13:16
1. 개요
refboard는 게임을 만드는 사람의 자료를 프로젝트별 작업 공간으로 묶는 웹앱이다. 현재 저장소에서 실제로 사용할 수 있는 중심 기능은 프로젝트 생성과 폴더·문서 트리 기반 GDD 편집이다. 데스크톱에서는 문서 트리, 편집·미리보기, 우측 패널의 3분할 구조를 사용하고 모바일에서는 문서 보기와 편집을 전환한다.
무드보드 블록과 AI 어시스턴트는 제품 방향에는 포함돼 있지만 현재 UI와 API에서는 후속 마일스톤 자리로 남아 있다. 기존 소개에서 목표 기능과 현재 기능이 섞였던 부분을 이 문서 묶음에서는 상태별로 구분한다.
위 이미지는 공개 접속 시 확인되는 Clerk 로그인 게이트다. Apple·Google 또는 이메일로 로그인하는 화면이며, 프로젝트·GDD·무드보드 같은 내부 기능 화면으로 해석하면 안 된다.
2. 기능 한눈에 보기
| 문서 | 현재 상태와 역할 |
|---|---|
| 프로젝트 | 프로젝트를 이름·설명·색으로 만들고 최근 수정 순으로 연다. |
| GDD | 폴더·문서 트리를 만들고 Markdown을 자동 저장하며 미리 본다. |
| 무드보드 | 목표 기능. 현재 블록 UI는 자리 표시자이며 블록 API도 비활성 상태다. |
| AI 어시스턴트 | 목표 기능. 현재 챗 UI는 자리 표시자이고 문서 인용 답변은 아직 동작하지 않는다. |
| 임포트 | 로컬 Markdown 폴더를 프로젝트의 문서 트리로 일괄 가져온다. |
3. 시작하기
- 라이브에서 Clerk 로그인을 통과한다.
- 새 프로젝트를 만들고 색과 한 줄 설명을 정한다.
- 문서 트리에서 루트 폴더와 문서를 만든다.
- 많은 Markdown 문서가 이미 있다면 임포트 CLI를 사용한다.
- 우측의 챗·블록·백링크 탭은 현재 자리 표시자이므로 중요한 자료는 GDD 문서 트리에 보관한다.
4. 기술 스택
| 영역 | 기술 |
|---|---|
| 프런트엔드 | Next.js 15 App Router, React 19, TypeScript |
| 문서 | React Markdown, remark-gfm, @dnd-kit |
| 레이아웃 | react-resizable-panels |
| 데이터 | Neon Postgres |
| 배포 | Vercel |
| 인증 | 라이브 접속에서 확인되는 Clerk 로그인 게이트 |
5. 개발 배경
게임 디렉터의 무드보드, 기획서, 참고 링크가 서로 다른 도구에 흩어지는 문제에서 시작했다. 초기의 무드보드·노트·AI 챗 구상은 GDD 피벗을 거쳐 폴더·문서 트리로 구체화됐다. 현재 구현은 문서 계층과 편집 경험을 먼저 완성한 단계이며, 블록 라이브러리와 문서 문맥을 인용하는 AI는 코드에 명시된 후속 마일스톤이다.
6. 링크
- 라이브: refboard.vercel.app — 로그인 필요
- GitHub: architectofthoughts/refboard