문서
웹 표면
웹 앱은 공개 마케팅 페이지, 다국어 문서 셸, 인증된 대시보드를 하나의 Astro 프로젝트 안에서 함께 다룹니다.
라우트 맵
| 라우트 | 용도 |
|---|---|
/, /pricing | 마케팅 랜딩 페이지 |
/docs/* | 빠른 시작, SDK, CLI, 개념, 웹 레퍼런스를 담는 문서 셸 |
/blog/*, /compare/*, /guides/* | SEO와 교육용 콘텐츠 |
/ko/*, /jp/* | 한국어와 일본어 로컬라이즈드 진입점 |
/app, /app/workflows, /app/oauth-callback | 인증 대시보드 셸과 워크플로우 빌더 진입점 |
스택과 런타임
| 구성 요소 | 현재 선택 |
|---|---|
| 사이트 프레임워크 | Astro 6 |
| 인터랙티브 UI | React 19 |
| 스타일링 | Tailwind CSS 4와 로컬 UI primitives |
| 현지화 | en, ko, jp를 사용하는 Astro i18n |
| 배포 대상 | npm run build가 만드는 dist/를 쓰는 Cloudflare Pages |
로컬 개발
bashcd web
npm install
npm run dev
npm run build
npm run preview- 패키지 요구사항은
node >=22.12.0입니다. PUBLIC_API_URL이src/lib/api.ts와src/lib/auth-api.ts에서 사용할 API origin을 결정합니다.- 대시보드 인증은 백엔드가 설정한 httpOnly 쿠키와 CSRF 보호용
schift_csrf쿠키를 사용합니다.
배포 메모
이 프로젝트는 정적 Astro 사이트로 빌드됩니다. wrangler.toml은 Cloudflare Pages가 생성된 dist/를 사용하도록 가리키고 있고, sitemap은 /app을 공개 인덱싱에서 제외합니다.