Skip to content

docs(brand): redesign logo system + professionalize README#64

Merged
Agions merged 1 commit into
mainfrom
docs/brand-redesign
Jun 2, 2026
Merged

docs(brand): redesign logo system + professionalize README#64
Agions merged 1 commit into
mainfrom
docs/brand-redesign

Conversation

@Agions
Copy link
Copy Markdown
Owner

@Agions Agions commented Jun 2, 2026

Brand Redesign

SceneFab README + Logo 专业化设计 — 让 ship 出去的项目看起来像真正的产品

🎨 Logo System (3 SVGs, 1 identity)

File viewBox Purpose
assets/logo.svg 256×256 App icon / OG image / doc hero
assets/logo-horizontal.svg 512×128 README header / VitePress nav
assets/favicon.svg 64×64 Browser tab (small-pixel optimized)
docs/public/* (3 sync copies) VitePress docs site

Design recipe (3 layers, 1 concept)

  • Background: Deep space gradient #0f0c29 → #1a1a3e → #24243e (AI 神秘感)
  • Film strip (45° tilt): Warm orange→red #ff8a5b → #e63946 (影视温暖,关键差异化元素)
  • AI neural pulse: Cool cyan→purple #4cc9f0 → #7209b7 (AI 感,穿越胶片)
  • Center play triangle: On dark disc for high contrast

✏️ README Rewrite (151 → 241 lines)

Restructured to product-grade:

  1. Hero — Centered logo + tagline + 5 badges + 4 nav links (中文用「在线文档」非「官网文档」)
  2. 它是什么? — One-paragraph positioning statement
  3. 2×3 HTML table — 6 capability cards (vs. previous plain markdown table)
  4. Quick start — Download table (4 platforms) + from-source block
  5. ASCII architecture diagram — Layered box diagram (NOT Mermaid — GitHub README Mermaid is unreliable per project-brand-redesign skill pitfall pip install -r requirements.txt对于python 3.12 存在不兼容 #5)
  6. Tech stack table — 9 rows
  7. Documentation links — 6 entries
  8. Roadmap — Done / In-progress / Planned checkbox lists
  9. Contributing — With Conventional Commits cheat sheet
  10. Acknowledgements — 7 upstream projects
  11. MIT license + Copyright

🔒 Style decisions

  • for-the-badge style badges (more product-y than flat-square)
  • All SVGs have role="img" + aria-label for accessibility
  • Used 「在线文档」 for hero link (per project memory: 「官网文档」 implies ownership ambiguity)
  • Architecture diagram is ASCII art (skill rule: default to ASCII in README, use Mermaid only in docs site)

✅ Verification

  • 6 SVGs validate as XML
  • assets/ + docs/public/ logo copies in sync
  • README line count 241 (target ~250)
  • All image paths in README resolve
  • git status clean after commit
  • No Mermaid in README

📋 Post-merge

  • Re-run GitHub Pages deploy (VitePress will pick up new docs/public/* logos)
  • Verify OG image preview in social share

## Logo System (3 SVGs, 1 identity)

| File | viewBox | Purpose |
|------|---------|---------|
| assets/logo.svg | 256×256 | App icon / OG image / doc hero |
| assets/logo-horizontal.svg | 512×128 | README header / VitePress nav |
| assets/favicon.svg | 64×64 | Browser tab (small-pixel optimized) |
| docs/public/* | (sync copies) | VitePress docs site |

### Design recipe
- Background: deep space gradient (#0f0c29 → #1a1a3e → #24243e)
- Film strip (45° tilt): warm orange→red (#ff8a5b → #e63946)
- AI neural pulse: cool cyan→purple (#4cc9f0 → #7209b7)
- Center play triangle on dark disc (high contrast)

## README Rewrite (151 → 241 lines)

Restructured with:
- Hero section (centered logo + tagline + 5 badges + 4 nav links)
- '它是什么?' positioning statement
- 2×3 HTML table (6 capability cards)
- Quick start with download table + from-source block
- ASCII architecture diagram (NOT Mermaid — GitHub README Mermaid is unreliable)
- Tech stack table (9 rows)
- Documentation link table
- Roadmap (done / in-progress / planned)
- Contributing with Conventional Commits cheat sheet
- Acknowledgements + MIT license

### Wording precision
- Used '在线文档' (not '官网文档') for hero link — clearer for VitePress-on-GitHub-Pages
- for-the-badge style badges (more product-y than flat-square)
- All SVGs have role='img' and aria-label for accessibility

## Verification
- ✅ 3 SVGs validate as XML
- ✅ assets/ + docs/public/ logo copies in sync (6 files total)
- ✅ README line count 241 (target ~250)
- ✅ No Mermaid in README (used ASCII art instead)
@Agions Agions merged commit cd39580 into main Jun 2, 2026
2 checks passed
@Agions Agions deleted the docs/brand-redesign branch June 2, 2026 09:32
Agions added a commit that referenced this pull request Jun 2, 2026
PR #64 squash merge only included 3 new assets/*.svg files. The README.md
rewrite and docs/public/{logo,favicon}.svg sync were missing from the
squashed commit (4a53bea) due to a staging oversight in the original
brand branch.

This commit backfills the missing changes:
- README.md: 151 → 241 lines (full professionalization)
- docs/public/logo.svg: new design (256², film strip + AI pulse)
- docs/public/favicon.svg: new design (64², simplified for small pixels)

Verification:
- 3 files changed, +297 / -109 (matches original PR #64 diff stat)
- All 5 SVG assets validate as XML
- README links to assets/logo-horizontal.svg resolve correctly
- for-the-badge badges, ASCII architecture diagram (no Mermaid)
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