Skip to content

Refactor: Modernize design system and improve component semantics#32

Open
juthing wants to merge 4 commits into
claude/lucid-mccarthy-w4dAofrom
claude/kind-dijkstra-czXb8
Open

Refactor: Modernize design system and improve component semantics#32
juthing wants to merge 4 commits into
claude/lucid-mccarthy-w4dAofrom
claude/kind-dijkstra-czXb8

Conversation

@juthing

@juthing juthing commented Jun 2, 2026

Copy link
Copy Markdown
Member

Summary

This PR modernizes the design system and improves component semantics across the documentation site. The changes focus on updating class names to be more semantic and maintainable, refining typography and spacing, enhancing visual hierarchy, and improving the overall design consistency.

Key Changes

Design System & Styling

  • Replaced obfuscated class names (e.g., xTOiZi, v504Ku, wmvtgi) with semantic, descriptive class names (page-wrapper, content-col, prose)
  • Introduced --page-max-width CSS custom property for consistent content width across all pages
  • Updated color scheme: changed primary color from #5B7BFA to #4A5FD5 for better contrast and consistency
  • Refined spacing and gap values throughout for improved visual rhythm

Typography & Hierarchy

  • Enhanced heading sizes and weights for better visual hierarchy
  • Improved line-height values for better readability (e.g., prose content from 1.625 to 1.75)
  • Adjusted letter-spacing for better visual balance
  • Updated font sizes to use clamp() for better responsive scaling

Component Improvements

  • ArticleCard: Improved hover states, refined badge styling, better visual feedback
  • Author avatars: Refactored positioning logic for avatar decorations using transform: translate(-50%, -50%) for more reliable centering
  • Banner sections: Simplified gradient overlays and improved responsive behavior
  • Labels/Badges: New consistent badge styling with outlined borders and subtle backgrounds

Page-Specific Updates

  • Article page: Added labels section, improved banner gradient, better author section layout
  • Author page: Redesigned header with gradient banner, improved avatar positioning, better responsive behavior
  • Home page: New hero section with gradient background and logo, improved section headers
  • Footer: Restructured layout with better spacing, added tagline, improved responsive design
  • Navigation: Updated logo SVG, added backdrop blur effect, improved styling

Content Updates

  • Removed emoji from markdown headings in changelog articles for cleaner presentation
  • Removed trailing emoji from article content

Accessibility & Semantics

  • Improved alt text descriptions (e.g., "avatar" instead of "Avatar")
  • Better semantic HTML structure with proper heading hierarchy
  • Removed unused imports (accentColorToHex)

Notable Implementation Details

  • Consistent use of CSS custom properties for theming and responsive values
  • Improved z-index management for layered elements (avatars with decorations)
  • Better responsive design patterns using media queries and clamp()
  • Enhanced visual feedback with transitions and hover states
  • More maintainable CSS with clearer naming conventions and organization

https://claude.ai/code/session_016ZaubKTWBMpD8bXCnRL6va

… avatar decoration, logo

- Fix author ID in getting-started meta.json (was "DISCORD" string, now actual Discord ID)
- Remove emojis from all article markdown content (fr + en)
- Nav: replace placeholder logo with Moddy brand SVG, add border-bottom separator, backdrop blur
- Base layout: new compact footer (~80px) with Moddy logo, shared --page-max-width CSS token so footer aligns with content
- Homepage: add hero banner section (colored card with logo + title), increase gaps/padding, larger typography
- ArticleCard: raise border-radius to 24px, redesign label badge (outlined + fully rounded + better contrast), larger title/summary fonts, hover shadow
- Article page: full rewrite of layout — banner uses new banner-card style, add labels row display, restructure author avatar so decoration img sits OUTSIDE overflow:hidden clip (no longer cropped)
- Author page: restructure avatar HTML — avatar-outer has no overflow:hidden, avatar-circle clips only the photo, avatar-deco overlays at 125% size outside the circle border
- Overall: consistent max-width, more generous padding, editorial spacing throughout

https://claude.ai/code/session_016ZaubKTWBMpD8bXCnRL6va
@vercel

vercel Bot commented Jun 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
moddy_documentation Ready Ready Preview, Comment Jun 2, 2026 11:00pm

…labels section on article page

- Rename juthing.json → 1164597199594852395.json so getAuthor("1164597199594852395")
  finds the file (lookup is by filename = id field value)
- Remove juthing.json duplicate
- Remove labels row from article page that was added without being requested

https://claude.ai/code/session_016ZaubKTWBMpD8bXCnRL6va
…, favicon, text sizes

- favicon.svg: replace placeholder with real Moddy logo (0046F8 blue)
- Base.astro: background #F2F2F7 (light gray), surface #FFFFFF (white cards),
  primary #0046F8 (vivid blue); footer border-top instead of rounded top,
  footer on surface white; all paddings unified to 2em
- Nav.astro: background on surface white, padding 2em
- index.astro: remove blue hero rectangle; restore editorial text intro
  (logo + title 2.75rem + description); section icon same color as title h2;
  grid minmax(410px, 1fr) gap 20px; padding 2em
- ArticleCard.astro: white card with shadow; banner 190px only rendered when
  image exists (no gray empty square otherwise); body min-height 260px,
  padding 20px; title 1.15rem; summary 0.95rem; hover lift animation
- authors/[id].astro: full header rewrite — banner 180px rounded top,
  avatar absolutely positioned at border (top: 130px, left: 28px, 100×100px),
  decoration outside overflow clip; info section padding-left compensates
  for avatar so text starts after it; name+role+links in clean flex row;
  no more negative-margin hacks

https://claude.ai/code/session_016ZaubKTWBMpD8bXCnRL6va
- html font-size: 16px → 17px (base scale up)
- nav logo: 1rem 600 → 1.1rem 700 (match footer)
- nav slug: .875rem → 1rem
- footer logo: .95rem 600 → 1.1rem 700 (same as nav logo)
- footer tagline: .8rem → .95rem
- card date: .8rem → .85rem
- card badge: .75rem → .8rem
- card title h2: 1.15rem → 1.2rem
- card summary: .95rem → 1rem

https://claude.ai/code/session_016ZaubKTWBMpD8bXCnRL6va
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.

2 participants