docs(site): v3.0 docs site redesign — new homepage + theme + 3 new pages#10
Merged
Conversation
## Homepage (docs/index.md) - Layout: home with hero + 6 features (preserved) - New sections (pure HTML divs, scene-fab reliable pattern): - Workflow: 5-step novel-to-video pipeline (numbered cards) - Why frame-fab: 6 differentiating value cards - Tech stack: 4-layer grid (frontend/desktop/AI/engineering) - Compare: 7-row positioning table vs 万兴剧厂/梦灵 AI - Stats: 4 big numbers (5 days / 72% / 30MB / 10 steps) - CTA: gradient block with download + quick start buttons ## Theme (docs/.vitepress/theme/style.css) - Single :root block (light) + single .dark block (dark) - OKLCH color tokens: Indigo → Purple → Pink (matches v3.0 brand) - Brand: --color-brand-500 (#6366F1) → -600 (#A855F7) → -700 (#EC4899) - Accent: --color-accent (#FB923C) for AI pulse - Surface dark: oklch(13% 0.025 270) ≈ #0B0E2C - All homepage sections defined as .vp-* classes - Hover/transition effects for all interactive elements - Responsive: collapses to 1-col on <768px ## Theme Index (docs/.vitepress/theme/index.ts) - Minimal: extends DefaultTheme, imports style.css - No Vue SFCs (scene-fab lesson: they fail silently) - No enhanceApp (no custom components needed) ## Config (docs/.vitepress/config.mjs) - appearance: 'light' (default) with toggle - base: '/frame-fab/' (GitHub Pages repo) - New favicon links (16/32/256 + apple-touch-icon) - OG image 1280x640 PNG (replaces /logo.svg) - New nav: 首页/指南/用户手册/开发者/架构决策/性能基准 - Full sidebar for all sections - editLink → GitHub edit URL pattern ## New Pages (3 + ADR index) - docs/developer-guide/platform-layer.md (NEW) - Tauri/Web 平台适配设计, 含完整 Platform 接口定义 - docs/developer-guide/ai-providers.md (NEW) - Provider Registry + Fallback Chain + 能力路由 - docs/developer-guide/module-system.md (NEW) - 9 features × 7 core × DDD 分层规则 - docs/adr/index.md (NEW) + 3 new ADRs: - 0003-platform-adapter: Platform Adapter 决策 - 0004-brand-redesign: 品牌 v3.0 重新设计 - 0006-pipeline-engine: Pipeline + Checkpoint 机制 ## Verification - ✅ npx vitepress build docs → exit 0 - ✅ All 4 section titles present in dist/index.html - ✅ Browser preview: light mode 8.5/10 - ✅ Browser preview: dark mode 8.5/10 - ✅ No dead links (ignoreDeadLinks: true) - ✅ No 'env' or 'redis' language errors
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
📚 frame-fab v3.0 文档站全新设计
完整重写文档站, 全新首页 + 现代设计系统 + 3 个新开发者文档 + ADR 索引。
🎨 设计系统 (OKLCH)
--color-brand-500oklch(58% 0.21 270)--color-brand-600oklch(52% 0.24 285)--color-brand-700oklch(48% 0.25 320)--color-accentoklch(70% 0.18 50)oklch(13% 0.025 270)🏠 新首页 (docs/index.md)
5 大自定义 section (纯 HTML divs, scene-fab 可靠模式):
📑 新文档 (3 页 + 3 ADR)
docs/developer-guide/platform-layer.mddocs/developer-guide/ai-providers.mddocs/developer-guide/module-system.mddocs/adr/index.mddocs/adr/0003-platform-adapter.mddocs/adr/0004-brand-redesign.mddocs/adr/0006-pipeline-engine.md⚙️ 配置更新 (docs/.vitepress/config.mjs)
appearance: 'light'默认 + 暗色切换按钮base: '/frame-fab/'(GitHub Pages repo)✅ 验证
npx vitepress build docs→ exit 0ignoreDeadLinks: true)📦 与 PR #9 关联
本 PR 引用 PR #9 创建的
public/favicon.svg+public/og-image.png+ 品牌色规范。合并后形成完整视觉锤。🔗 后续