Skip to content

Docs visual polish — layout, markdown viewer, sidebar reorg#16

Merged
siracusa5 merged 1 commit intomainfrom
docs/visual-polish-v2
Mar 14, 2026
Merged

Docs visual polish — layout, markdown viewer, sidebar reorg#16
siracusa5 merged 1 commit intomainfrom
docs/visual-polish-v2

Conversation

@siracusa5
Copy link
Copy Markdown
Collaborator

Summary

  • Visual polish: Remove harsh borders, better spacing, purple code block glow, link transitions, gradient section dividers, card hover effects, step badges, sidebar/TOC micro-interactions, reduced-motion support
  • Plugin pages: New MarkdownViewer component with Raw/Preview toggle inside collapsible accordions for SKILL.md and README.md source files. Fixed remark-embed to properly handle frontmatter and inject JSX components
  • Sidebar reorg: Concepts moved to top, architecture moved into Getting Started (before installation), removed duplicate section header dividers, FAQ at bottom

Test plan

  • Visual check: index, quick-start, plugin overview, creating-plugins pages
  • Expand plugin Source Files accordion — verify Preview/Raw toggle works
  • Check sidebar order: Concepts > Getting Started > Plugins > Evals > Guides > Cross-Harness > FAQ
  • Verify no duplicate section labels in sidebar
  • Light mode: no regressions
  • Build passes

🤖 Generated with Claude Code

Visual improvements:
- Remove harsh borders from tables, cards, code blocks
- Increase content spacing and breathing room
- Subtle purple glow on code blocks, ghost copy button
- Dotted underline + hover transitions on links
- Gradient H2 section dividers and page title glow
- Richer callouts, card hover effects, accent step badges
- Sidebar/TOC micro-interactions with smooth transitions
- Reduced-motion support for all animations

Plugin pages:
- MarkdownViewer component with Raw/Preview toggle
- Fix remark-embed to inject proper JSX components
- Wrap SKILL.md/README.md in collapsible Accordion sections

Navigation:
- Move Concepts above Getting Started in sidebar
- Move architecture into Getting Started (before installation)
- Remove duplicate section header dividers
- FAQ moved to bottom

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@siracusa5 siracusa5 merged commit 3c7b93c into main Mar 14, 2026
2 checks passed
@siracusa5 siracusa5 deleted the docs/visual-polish-v2 branch March 15, 2026 19:45
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