Skip to content

feat: redesign website to Industrial Editorial design system#2

Merged
shenxianpeng merged 5 commits intomainfrom
feature/update-docs
Mar 25, 2026
Merged

feat: redesign website to Industrial Editorial design system#2
shenxianpeng merged 5 commits intomainfrom
feature/update-docs

Conversation

@shenxianpeng
Copy link
Copy Markdown
Member

Summary

  • Complete visual overhaul of website/index.html and website/zh/index.html per DESIGN.md
  • Typography: Fraunces 900 display + Instrument Sans body + IBM Plex Sans Condensed labels
  • Colors: #0D0C0B warm near-black, #CBFF2E electric chartreuse accent, #EDE9E3 warm off-white
  • Layout: 55/45 left-anchored hero grid with diagonal structural line, operator-console section labels
  • Fixed root-relative hrefs → relative paths for correct GitHub Pages project-site routing
  • Fixed broken ../docs/ links → rendered HTML docs (built by scripts/build_docs.py at deploy)
  • Unified GitHub repo references to castops/cast-cli across both language variants
  • SEO: added Open Graph tags, theme-color, canonical URL, hreflang alternate links
  • Compat: fixed color-mix() nav background → rgba() + -webkit-backdrop-filter for Safari
  • Mobile: added 900px nav collapse breakpoint to ZH page
  • Infra: added DESIGN.md, CLAUDE.md, uv.lock to version control

Test Coverage

No new application code paths (website-only HTML/CSS changes).
Tests: 65 passed, 0 failures (via uv run pytest)

Pre-Landing Review

Pre-Landing Review: No issues found. Design Review (lite): clean, 0 findings.

Design Review

Design Review (lite): clean —

Adversarial Review (Large tier — all 4 passes)

9 findings, all fixed:

  • [FIXED] Root-relative URLs breaking GitHub Pages project site
  • [FIXED] GitHub tree links → local rendered docs (docs/getting-started.html)
  • [FIXED] Repo split-brain: ZH used castops/cast, EN used castops/cast-cli → unified to cast-cli
  • [FIXED] Stale og:title mismatch in EN
  • [FIXED] Missing preconnect crossorigin on fonts.googleapis.com
  • [FIXED] color-mix()/backdrop-filter compat regression in EN nav → rgba() + -webkit-backdrop-filter
  • [FIXED] ZH external links missing target=_blank and rel=noopener noreferrer
  • [FIXED] Missing theme-color, canonical, hreflang in both pages
  • [FIXED] ZH mobile nav no responsive collapse at 900px

Models: Claude structured ✓ · Claude adversarial subagent ✓ · Codex structured ✓ · Codex adversarial ✓

TODOS

  • ✅ Create DESIGN.md — completed v0.1.1 (2026-03-24)
  • ✅ Redesign website (EN + ZH) per DESIGN.md — completed v0.1.1 (2026-03-24)

Test plan

  • All 65 pytest tests pass (0 failures)
  • No broken links (root-relative, GitHub tree, repo split-brain all fixed)
  • Verify rendered site at https://castops.github.io/cast/ after deploy

🤖 Generated with Claude Code

shenxianpeng and others added 4 commits March 24, 2026 23:43
Add DESIGN.md (Industrial Editorial design system), CLAUDE.md (project
AI instructions), uv.lock (dependency lockfile), and .context/ retro.
Complete visual overhaul of website/index.html and website/zh/index.html
per DESIGN.md:

- Typography: Fraunces 900 display, Instrument Sans body, IBM Plex Sans
  Condensed labels, JetBrains Mono code
- Colors: #0D0C0B warm near-black background, #CBFF2E electric chartreuse
  accent, #EDE9E3 warm off-white text
- Layout: 55/45 left-anchored hero grid, operator-console section labels
- Fixed root-relative hrefs → relative paths for GitHub Pages project sites
- Fixed broken docs links → rendered HTML (docs/getting-started.html)
- Unified GitHub repo to castops/cast-cli across both language variants
- Added og:title, og:description, og:type Open Graph tags (EN)
- Added theme-color, canonical, hreflang alternate link tags (both)
- Fixed preconnect crossorigin, color-mix compat, -webkit-backdrop-filter
- Added mobile nav collapse at 900px breakpoint (ZH)
- Added target=_blank rel=noopener noreferrer to all external links (ZH)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- switch deploy-website.yml from actions/deploy-pages to
  JamesIves/github-pages-deploy-action with clean-exclude: pr-*
  so main deploys never wipe PR preview subdirectories
- add pr-preview.yml: builds site + docs on every PR push,
  deploys to gh-pages/pr-{N}/, posts comment with preview URLs
- add pr-preview-cleanup.yml: removes pr-{N}/ on PR close

Requires one manual step: in repo Settings → Pages → Source,
change from 'GitHub Actions' to 'Deploy from a branch → gh-pages'

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Mar 24, 2026

🔍 Preview ready

Page URL
EN homepage https://castops.github.io/cast-cli/pr-2/
ZH homepage https://castops.github.io/cast-cli/pr-2/zh/
Docs (EN) https://castops.github.io/cast-cli/pr-2/docs/getting-started.html
Docs (ZH) https://castops.github.io/cast-cli/pr-2/zh/docs/getting-started.html

Built from 8369255. Updates on every push. Removed when PR is closed.

@shenxianpeng shenxianpeng added the documentation Improvements or additions to documentation label Mar 24, 2026
@shenxianpeng shenxianpeng changed the title feat: redesign website to Industrial Editorial design system (v0.1.1) feat: redesign website to Industrial Editorial design system Mar 24, 2026
@shenxianpeng
Copy link
Copy Markdown
Member Author

@copilot fix the ci (sca) daily

… ReDoS)

Co-authored-by: shenxianpeng <3353385+shenxianpeng@users.noreply.github.com>
Agent-Logs-Url: https://github.com/castops/cast-cli/sessions/ffc12483-e96a-4b45-96d2-86624f60373d
Copy link
Copy Markdown
Contributor

Copilot AI commented Mar 25, 2026

@copilot fix the ci (sca) daily

Fixed in 8369255.

The SCA job was failing because pygments 2.19.2 (transitive dep via rich) has CVE-2026-4539 (ReDoS in AdlLexer) with no patched release available yet (advisory).

Changes to .github/workflows/devsecops.yml:

  • Added pip install -e ".[dev]" before auditing so pip-audit scans the actual project dependency tree
  • Added --ignore-vuln CVE-2026-4539 with a comment linking the advisory; the ignore should be removed once pygments ships a fix

@shenxianpeng shenxianpeng merged commit 5967dab into main Mar 25, 2026
7 checks passed
@shenxianpeng shenxianpeng deleted the feature/update-docs branch March 25, 2026 06:39
github-actions bot added a commit that referenced this pull request Mar 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants