시작하기

사전 요구사항

• Node.js 18+
• pnpm (권장) 또는 npm

설치

cd site
pnpm install

개발

개발 서버 시작:

pnpm dev

브라우저에서 http://localhost:5173을 방문하세요.

빌드

프로덕션 빌드 생성 (메인 앱 + 문서):

pnpm build

출력:

• dist/ - 메인 앱
• dist/docs/ - VitePress 문서 (자동 복사)

빌드 단계 (자동화):

1. 메인 앱 빌드 → dist/
2. VitePress 문서 빌드 → docs/.vitepress/dist/
3. 문서를 dist/docs/로 복사

프로덕션 빌드 미리보기

darkhttpd dist --port 8080

접속:

• 메인 앱: http://localhost:8080/
• 문서: http://localhost:8080/docs/

두 앱 모두 단일 디렉토리에서 제공됩니다!

OpenBSD 설정

OpenBSD에서 필요한 네이티브 바인딩은 postinstall 훅을 통해 pnpm install 중에 자동으로 다운로드됩니다.

설치 스크립트는 다음에서 바이너리를 가져옵니다:

• https://github.com/nikescar/tailwind-openbsd-bindings/releases/latest

바인딩을 수동으로 다운로드하거나 업데이트해야 하는 경우:

# 설치 스크립트 직접 실행
bash scripts/install-tailwind-openbsd.sh
bash scripts/install-rolldown-openbsd.sh

스크립트는 다음을 수행합니다:

1. GitHub 릴리스에서 누락된 바이너리 다운로드
2. OpenBSD 바인딩을 사용하도록 node_modules 패치
3. 설치 확인

테스트

테스트 실행:

pnpm test

워치 모드:

pnpm test:watch

프로젝트 구조

site/
├── src/
│   ├── components/     # UI 컴포넌트
│   ├── lib/            # 유틸리티
│   └── pages/          # 페이지 컴포넌트
├── public/
│   └── data/           # 정적 데이터 파일
├── docs/               # 문서
└── dist/               # 빌드 출력