feat(docs): added page nav buttons, static search, TOC footer

[waleedlatif1]

Summary

• added page nav buttons, static search, TOC footer
• significant speedup in search, improved transition from docs -> app with CTA

Type of Change

• New feature

Testing

Tested manually.

Checklist

• Code follows project style guidelines
• Self-reviewed my changes
• Tests added/updated and passing
• No new warnings introduced
• I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

[vercel]

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

Project	Deployment	Preview	Comments	Updated (UTC)
docs	Ready	Preview	Comment	Nov 1, 2025 9:36pm

[greptile-apps]

Greptile Overview

Greptile Summary

This PR enhances the documentation site with improved navigation and search performance. The changes introduce page navigation arrows for quick prev/next navigation, a CTA footer in the table of contents, and a significant performance upgrade by switching from server-side to static search generation.

Key improvements:

• Static search generation with locale-specific stemming configuration provides faster search results
• New PageNavigationArrows component adds intuitive navigation in the top-right corner
• TOCFooter component adds a conversion-focused CTA with smooth hover animations
• Sidebar folders now automatically expand/collapse based on active page for better UX
• Minor visual refinements to button styling and sidebar colors for improved consistency

Technical highlights:

• Proper accessibility attributes (aria-label, aria-hidden) on all interactive elements
• Uses path aliases (@/) consistently per project standards
• Clean component separation with clear prop interfaces
• revalidate: false ensures search index is static for optimal performance

Confidence Score: 5/5

• This PR is safe to merge with minimal risk - all changes are additive UI enhancements with proper testing
• Score reflects well-structured code with proper accessibility, good separation of concerns, performance improvements, and no breaking changes. One minor style suggestion about extracting config, but not critical.
• No files require special attention - all changes are straightforward UI enhancements

Important Files Changed

File Analysis

Filename	Score	Overview
apps/docs/components/docs-layout/page-navigation-arrows.tsx	5/5	New component for page navigation with previous/next arrows - clean implementation with proper accessibility
apps/docs/components/docs-layout/toc-footer.tsx	5/5	New CTA component for TOC footer with hover animation - well-structured with proper accessibility attributes
apps/docs/app/api/search/route.ts	5/5	Switched to static search generation with locale-specific configuration for improved performance
apps/docs/app/[lang]/layout.tsx	5/5	Added static search configuration to RootProvider for performance optimization
apps/docs/app/[lang]/[[...slug]]/page.tsx	5/5	Integrated new page navigation arrows and TOC footer components, disabled breadcrumb display

Sequence Diagram

sequenceDiagram
participant User
participant Browser
participant Page as [[...slug]]/page.tsx
participant Layout as [lang]/layout.tsx
participant RootProvider
participant SearchRoute as /api/search/route.ts
participant NavArrows as PageNavigationArrows
participant TOCFooter
User->>Browser: Navigates to docs page
Browser->>Layout: Request page
Layout->>RootProvider: Initialize with static search config
RootProvider->>Page: Render page with components
Page->>Page: Fetch page data & neighbours
Page->>NavArrows: Pass previous/next page data
NavArrows->>NavArrows: Render navigation arrows
Page->>TOCFooter: Render in TOC footer slot
TOCFooter->>TOCFooter: Initialize hover state
User->>User: Hovers over CTA button
TOCFooter->>TOCFooter: Toggle icon (ChevronRight ↔ ArrowRight)
User->>NavArrows: Clicks next/previous arrow
NavArrows->>Browser: Navigate to adjacent page
Browser->>Page: Load new page
User->>Browser: Types in search
Browser->>SearchRoute: Query search endpoint
SearchRoute->>SearchRoute: Use staticGET with locale map
SearchRoute->>Browser: Return pre-generated static results
Browser->>User: Display search results

Loading

_{9 files reviewed, 1 comment}

_{Edit Code Review Agent Settings | Greptile}