Docs

Web Surface

The web app combines public marketing pages, a localized docs shell, and an authenticated dashboard under one Astro project.

Route map

RoutesPurpose
/, /pricingMarketing landing pages
/docs/*Docs shell for quickstart, SDK, CLI, concepts, and web reference
/blog/*, /compare/*, /guides/*SEO and educational content
/ko/*, /jp/*Localized entry points for Korean and Japanese
/app, /app/workflows, /app/oauth-callbackAuthenticated dashboard shell and workflow builder entry points

Stack and runtime

PieceCurrent choice
Site frameworkAstro 6
Interactive UIReact 19
StylingTailwind CSS 4 plus local UI primitives
LocalizationAstro i18n with en, ko, and jp
Deploy targetCloudflare Pages with dist/ output from npm run build

Local development

bashcd web
npm install
npm run dev
npm run build
npm run preview
  • The package declares node >=22.12.0.
  • PUBLIC_API_URL controls the API origin used by src/lib/api.ts and src/lib/auth-api.ts.
  • Dashboard auth uses backend-set httpOnly cookies plus the schift_csrf cookie for CSRF protection.

Deployment note

This project is built as a static Astro site. wrangler.toml points Cloudflare Pages at the generated dist/ directory, and the sitemap intentionally excludes /app from public indexing.