Skip to content

docs: redesign homepage with hero, feature cards, and pill layouts#32

Merged
anandgupta42 merged 2 commits intomainfrom
docs/improve-homepage
Mar 4, 2026
Merged

docs: redesign homepage with hero, feature cards, and pill layouts#32
anandgupta42 merged 2 commits intomainfrom
docs/improve-homepage

Conversation

@anandgupta42
Copy link
Contributor

Summary

  • Redesigned docs homepage with a centered hero section (banner, tagline, CTAs, install snippet)
  • Replaced plain tables with Material icon grid cards for features and agent modes
  • Replaced LLM provider table and warehouse bullet list with centered pill layouts
  • Switched fonts to Inter + JetBrains Mono for a more modern look
  • Added custom CSS for hero styling, card hover effects, pill grids, and section headings
  • Enabled md_in_html and pymdownx.emoji MkDocs extensions

Test plan

  • Run mkdocs serve in docs/ and verify homepage renders correctly
  • Check light and dark mode
  • Verify all links in doc-links table work
  • Verify left sidebar navigation is present
  • Confirm no layout overflow into right sidebar area

🤖 Generated with Claude Code

…youts

- Add centered hero with banner image, tagline, CTA buttons, and install snippet
- Replace comparison table with 6 feature cards using Material icon grid
- Replace agent mode table with 4 icon cards
- Replace LLM provider table and warehouse list with centered pill layouts
- Switch fonts to Inter (body) and JetBrains Mono (code)
- Add md_in_html and pymdownx.emoji extensions
- Add custom CSS for hero, section headings, pill grid, card hover effects
- Hide TOC on homepage for cleaner landing page layout
- Add doc links table at bottom for quick navigation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link

@jontsai jontsai left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Nice homepage refresh. Verified:

✓ CSS is well-structured with dark mode support ([data-md-color-scheme="slate"])
✓ Material icon grid cards and pill layouts are clean
✓ Font swap to Inter + JetBrains Mono is a good call
✓ MkDocs extensions (md_in_html, pymdownx.emoji) properly configured
✓ Hidden TOC + hidden H1 pattern is standard for hero-style landing pages
✓ No broken links visible — doc-links table references existing pages

One minor observation: the old comparison table (general agents vs altimate-code) was useful marketing content — might be worth keeping somewhere in the docs if not on the homepage.

Ship it! 🚢

- Replace broken doc-links table with centered inline links
- Fix dark mode styling for bottom section
- Move "general agents vs altimate-code" comparison table to Getting Started page

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@anandgupta42 anandgupta42 merged commit c05720a into main Mar 4, 2026
4 checks passed
@kulvirgit kulvirgit deleted the docs/improve-homepage branch March 10, 2026 21:06
anandgupta42 added a commit that referenced this pull request Mar 17, 2026
* docs: redesign homepage with hero section, feature cards, and pill layouts

- Add centered hero with banner image, tagline, CTA buttons, and install snippet
- Replace comparison table with 6 feature cards using Material icon grid
- Replace agent mode table with 4 icon cards
- Replace LLM provider table and warehouse list with centered pill layouts
- Switch fonts to Inter (body) and JetBrains Mono (code)
- Add md_in_html and pymdownx.emoji extensions
- Add custom CSS for hero, section headings, pill grid, card hover effects
- Hide TOC on homepage for cleaner landing page layout
- Add doc links table at bottom for quick navigation

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: fix doc-links layout, move comparison table to getting-started

- Replace broken doc-links table with centered inline links
- Fix dark mode styling for bottom section
- Move "general agents vs altimate-code" comparison table to Getting Started page

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
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