Skip to content

feat: docs와 라이브 데모 추가 - #60

Merged
eunjin11 merged 1 commit into
mainfrom
feat/docs-site
Sep 4, 2026
Merged

feat: docs와 라이브 데모 추가#60
eunjin11 merged 1 commit into
mainfrom
feat/docs-site

Conversation

@eunjin11

@eunjin11 eunjin11 commented Sep 4, 2026

Copy link
Copy Markdown
Collaborator

lynx-console.pages.dev 한 도메인에서 문서와 예제 데모를 함께 서빙해요.

URL 내용
/, /ko/ 문서 (영문 / 한국어)
/main.lynx.bundle Lynx Explorer 용 예제 번들 — 기존 경로 그대로예요
/main.web.bundle, /async/* 웹 데모 번들, lazy chunk
/demo/ <lynx-view> 호스트 셸 (홈에 iframe 으로 임베드)

무엇을 했나

  • docs/ 워크스페이스 — Rspress 문서 사이트예요. 콘텐츠는 docs/src/{en,ko}, 소개 · 시작하기 · 커스텀 탭 · 데모 · API 레퍼런스를 영/한 양쪽으로 썼어요.
  • 라이브 데모 — 홈 히어로 오른쪽 폰 프레임에서 Lynx Web Platform 위의 예제 앱이 실제로 돌아가요. 옆에는 Lynx Explorer QR 과 lynx://open 딥링크를 뒀어요.
  • 한 번의 빌드docs/scripts/sync-demo.mjs 가 example 빌드 산출물과 QR 을 docs/src/public/ 으로 옮겨서, rspress 출력 하나에 문서와 번들이 같이 담겨요.
  • 홈 레이아웃 — 기본 히어로가 항상 가운데 정렬이라 왼쪽 소개 / 오른쪽 데모 배치를 위해 HomeLayout 을 교체했어요. 색은 CSS 변수 한 곳(docs/styles/global.css)에 모여 있어요.
  • 부수 변경 — example 의 QR 스키마가 가리키던 Vercel 주소를 pages.dev 로 바꿨고, 빌드 설정 문서에 fetch: "lynx.fetch" define 을 추가했어요 (README 도 함께). 레포 루트에 AGENTS.md 를 두고 Rspress 스킬 2개를 설치했어요.

확인한 것

  • ASSET_PREFIX 를 넣은 클린 빌드에서 위 표의 모든 URL 이 200 이고, 번들에 배포 도메인이 정상적으로 박혀요
  • 웹 데모에서 콘솔이 열리고 fetch 요청이 Network 탭에 기록돼요
  • 라이트/다크, 모바일 폭, rspress devrspress build 양쪽
  • 문서 내부 데드링크 검사를 켜뒀어요 (markdown.checkDeadLinks)
  • 네이티브(iOS/Android)는 기기가 없어 확인하지 못했어요

머지 전에 필요한 설정

Cloudflare Pages 대시보드에서 Build output directory 를 website/doc_builddocs/doc_build 로 바꿔야 해요. Build command(yarn build:site)와 ASSET_PREFIX 는 그대로예요.

🤖 Generated with Claude Code

@eunjin11 eunjin11 self-assigned this Sep 4, 2026
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Sep 4, 2026

Copy link
Copy Markdown

Deploying lynx-console with  Cloudflare Pages  Cloudflare Pages

Latest commit: 849d4c4
Status: ✅  Deploy successful!
Preview URL: https://29b7de96.lynx-console.pages.dev
Branch Preview URL: https://feat-docs-site.lynx-console.pages.dev

View logs

@eunjin11
eunjin11 merged commit fb3c786 into main Sep 4, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant