[Draft] Docs v2 Redesign#144
Merged
coreymartin merged 42 commits intolightsparkdev:pat-v2from Feb 4, 2026
Merged
Conversation
- Add .env.example documenting CENTRAL_ICONS_LICENSE env var - Download hero landscape image from Figma - Download payout preview image from Figma - Download trusted-by logos (Coinbase, SoFi, Nu, Revolut, Bitso) - Create directory structure for icons and home assets Co-authored-by: Cursor <cursoragent@cursor.com>
- Change theme from "mint" to "palm" in docs.json - Simplify fonts config by removing source/format properties (fixes validation errors with Mintlify CLI 4.2.x - fonts now load via custom CSS in head.links instead) This is part of the Grid Docs redesign project. Co-authored-by: Cursor <cursoragent@cursor.com>
- Add @central-icons-react/all and react/react-dom as devDependencies - Create scripts/export-icons.js to export icons as SVG files - Export 36 icons with round-outlined style, radius 3, stroke 1.5 - Add npm script: npm run build:icons - Update .env.example with CENTRAL_LICENSE_KEY Icons are exported for use in sidebar navigation matching the Figma design specification. Co-authored-by: Cursor <cursoragent@cursor.com>
Add Font Awesome icons to the Platform Overview tab pages: - Introduction section: square-info, circle-question - Core Concepts section: diagram-project, receipt, wallet, arrows-rotate, coins Icons improve navigation discoverability and visual hierarchy. Co-authored-by: Cursor <cursoragent@cursor.com>
Add Font Awesome icons to all tabs: - Payouts & B2B: paper-plane, book, map, bolt, gear, users, etc. - Ramps: arrows-rotate, right-left, key, etc. - Rewards: gift, paper-plane, list, etc. - Global P2P: globe, envelope, at, etc. - API Reference: server, key, etc. Consistent icon usage improves navigation discoverability across all documentation sections. Co-authored-by: Cursor <cursoragent@cursor.com>
- Add "What you can build" tabbed section with use cases for Payouts, Ramps, Rewards, and Global P2P - Add "Trusted by" logo section (Coinbase, SoFi, Nu, Revolut, Bitso) - Add secondary "View API" CTA button with hover states - Create UseCaseCard and ProductTiles components for tabbed UI - Use Central Icons in tabbed section cards Homepage now includes: - Hero with dual CTAs - Use case overview cards - Tabbed "What you can build" component - Trusted by logo strip - Resources section Co-authored-by: Cursor <cursoragent@cursor.com>
- Change first tab from "Home" to "Get started" with proper groups - Add Overview, Quickstart, and Core concepts groups to sidebar - Use correct Mintlify navigation format with groups inside tabs - Add custom titles for quickstart links (Send a payout, etc.) - Create placeholder pages: capabilities.mdx, use-cases.mdx, configuration.mdx - Update homepage to use Mintlify components (no custom mode) - Homepage now includes: hero frame, capability cards, tabbed use cases, trusted-by logos, and resource cards Sidebar now shows proper navigation structure matching Figma design. Co-authored-by: Cursor <cursoragent@cursor.com>
Phase 1: Sidebar Icons - Create sidebar-icons.css with ::before pseudo-elements - Add icons for all navigation items using mask-image technique - Support icons on individual sidebar items (Mintlify limitation workaround) Phase 2: Homepage Redesign - Hero banner with sand dunes image and overlay - Info cards: "Understand Grid" and "Start building" - Capabilities grid with colored icons (4x2 layout) - ProductTiles component (adapted from Aspen theme) - Tabbed interface: Payouts, Ramps, Rewards, Global P2P - Use case items with icons and descriptions - Preview image panel on right - Trusted by logo strip - Resources 3-column layout Phase 3: CSS Styling - Capabilities grid with colored square icons - ProductTiles styling with active states - Resources grid responsive layout - Hero banner overlay and button styles - Info card styling Files changed: - mintlify/styles/sidebar-icons.css (new) - mintlify/styles/styles.css (updated) - mintlify/index.mdx (rewritten) - mintlify/snippets/product-tiles.mdx (new) - mintlify/docs.json (linked new CSS) Co-authored-by: Cursor <cursoragent@cursor.com>
- Reset index.mdx to root (removed redirect mess) - Remove CSS hack for sidebar icons - use frontmatter instead - Add icon field to page frontmatter (house, file-lines, grid-2, etc.) - Remove icons from group headers (per Figma design) - Simplify docs.json navigation with clean structure - Navigation now works correctly: - "Get started" tab is active by default - Sidebar shows Overview/Quickstart/Core concepts - Each page has proper icon via frontmatter Co-authored-by: Cursor <cursoragent@cursor.com>
- Change page title from "Welcome" to "Grid Documentation" - Keep sidebarTitle as "Welcome" for sidebar display - Replace hero image with correct sand dunes from Figma Co-authored-by: Cursor <cursoragent@cursor.com>
Double icons fix: - Delete sidebar-icons.css (CSS hack no longer needed) - Icons now come solely from page frontmatter (proper Mintlify way) Homepage customization: - Add homepage.js to detect homepage and add 'is-homepage' class - Add CSS to hide TOC, copy button, eyebrow on homepage only - Homepage now has sidebar + clean layout without clutter Co-authored-by: Cursor <cursoragent@cursor.com>
- Update all 15 sidebar pages to use Central Icons SVGs - Icons now use paths like /images/icons/file-text.svg - Adds wide mode to homepage for cleaner layout - Hides page title and context menu on homepage via CSS Co-authored-by: Cursor <cursoragent@cursor.com>
Remove Mintlify and Tailwind utility classes from homepage content to enable pixel-perfect implementation matching Figma designs. Add custom CSS for hero section, use cases grid, resources section, and partner logos. Update gitignore for development reference files. Co-authored-by: Cursor <cursoragent@cursor.com>
Refresh SVG logos for Bitso, Coinbase, Nu, Revolut, and SoFi to match current brand guidelines and improve visual consistency. Co-authored-by: Cursor <cursoragent@cursor.com>
Add Grid logo variants, toggle icon, newspaper icon, Postman icon, and updated square-info icon. Include placeholder use case image and sand texture for homepage visual elements. Co-authored-by: Cursor <cursoragent@cursor.com>
- Split styles.css into base.css (navbar, sidebar, typography) and homepage.css (all homepage-specific components) - Remove ~180 lines of unused legacy styles - Replace hardcoded colors with --ls-* design tokens - Simplify redundant selectors - styles.css now serves as import manifest only Co-authored-by: Cursor <cursoragent@cursor.com>
- Add 8px gap between navbar link buttons - Remove redundant theme toggle CSS (handled via docs.json) - Reorganize content area and sidebar footer styles - Add content container centering for homepage Co-authored-by: Cursor <cursoragent@cursor.com>
Add Central icons to page frontmatter for visual navigation across Payouts & B2B, Ramps, Rewards, Global P2P, and API Reference tabs. Co-authored-by: Cursor <cursoragent@cursor.com>
Sidebar styling improvements: - Add Plaid icon to External Accounts with Plaid pages - Fix two-line sidebar items height (min-height instead of fixed) - Style API Reference expandable groups (full width, left aligned) - Replace small triangle chevrons with CSS-generated Central Icons style - Add icons to API Reference groups (Platform Config, Customers, etc.) - Remove hover color change on group buttons - Fix nested item vertical alignment for method pills Co-authored-by: Cursor <cursoragent@cursor.com>
Add ascent-override, descent-override, and line-gap-override to all Suisse Intl font-face declarations to fix text sitting too high. Remove compensating padding-top from capability-title. Co-authored-by: Cursor <cursoragent@cursor.com>
- Add new Central Icons: bell, sandbox, people-add, arrow-expand-hor, arrow-left-right - Update Webhooks icon from lightning/code to bell across all use cases - Update Invitations icon to people-add for consistency with API Reference - Update Environments icon from toggle to globe - Fix square-info icon (What is Grid) from refs - Fix Postman icon rendering with fill-rule="evenodd" - Update API Reference sidebar icons in CSS Co-authored-by: Cursor <cursoragent@cursor.com>
Change "Trusted by" to "Building on Grid" for more accurate messaging. Co-authored-by: Cursor <cursoragent@cursor.com>
- Remove social icons (X, GitHub, LinkedIn) from footer config - Hide footer element completely via CSS to remove extra padding Co-authored-by: Cursor <cursoragent@cursor.com>
Configure inner page content container with 48px padding, 280px TOC sidebar, and 48px gap between content and TOC for consistent spacing. Co-authored-by: Cursor <cursoragent@cursor.com>
Add full-width banner images (928x400 aspect ratio) with 8px corner radius to the Payouts, Ramps, Rewards, and Global P2P introduction pages. Co-authored-by: Cursor <cursoragent@cursor.com>
- Add CSS overrides for card components (8px border radius, 0.5px border, secondary text color) - Replace Mintlify built-in icons with custom SVGs from central icon library - Update 23 MDX files with contextually appropriate icons Co-authored-by: Cursor <cursoragent@cursor.com>
Adds a subtle 0.5px vertical line on nested items within expandable sidebar groups, improving visual hierarchy in the API Reference section. Co-authored-by: Cursor <cursoragent@cursor.com>
Expands the content area for API reference pages while keeping other pages at 1024px. Code panel maintains fixed width and content area flexes to fill remaining space. Co-authored-by: Cursor <cursoragent@cursor.com>
- Hide scrollbars globally while maintaining scroll functionality - Add sidebar indentation line for nested groups with width fix - Widen API reference layout to 1600px max-width - Override divider borders with --ls-black-10 - Style code groups: 8px radius, tab bar with FAFAF9 background - Style field info pills and inline code with --ls-gray-150 - Style pagination buttons with transparent bg, hover states - Style endpoint bar (GET /path) with 12px radius, white background - Style Try it button with 6px radius - Style expandable child attributes with FAFAF9 background - Set page description text to 16px Co-authored-by: Cursor <cursoragent@cursor.com>
- Style page context menu as split button group with 6px radius - Add 0.5px borders with design tokens (--ls-black-10, --ls-white-10) - Add background color (--ls-gray-025) and hover states - Replace single favicon with light/dark variants Co-authored-by: Cursor <cursoragent@cursor.com>
- Add hero images for product index pages (global-p2p, payouts, ramps, rewards) - Update index page titles to product names with sidebarTitle for navigation - Add wide mode to platform overview pages - Document Mintlify CLI version requirement (4.2.284) and troubleshooting Co-authored-by: Cursor <cursoragent@cursor.com>
- Add dark mode backgrounds for navbar (gray-975), sidebar (gray-975), and content area (gray-950) - Style cards, code blocks, and API reference elements for dark mode - Add proper tab indicator styling with Tailwind class overrides - Adjust sidebar items, labels, and expandable groups for dark mode - Add CSS filter inversions for icons in cards and sidebar - Reduce border brightness to white-06 for subtler dark mode borders - Style pagination and page context menu for dark mode Co-authored-by: Cursor <cursoragent@cursor.com>
- Create reusable FeatureCard snippet with optional icon, title, and href props - Add FeatureCardGrid wrapper with column variants (2, 3, 4 cols) - Add hover states for linked cards (scale + background) - Support cards without icons for use-cases page - Update 29 files across all documentation sections Co-authored-by: Cursor <cursoragent@cursor.com>
- Add border to inline code elements (0.5px, black-10/white-06) - Style code blocks and code groups with 8px radius - Add overflow:hidden corner clipping for code blocks with headers - Style callouts with 8px border radius - Update pagination title font size to 15px Co-authored-by: Cursor <cursoragent@cursor.com>
Progressive enhancement - browsers that support corner-shape: squircle get smooth Apple-style corners, others fall back to regular border-radius. Co-authored-by: Cursor <cursoragent@cursor.com>
- Add @supports block in tokens.css with 1.8× radii for squircle browsers - Convert all hardcoded border-radius values to use --ls-radius-* tokens - Override Mintlify's inline border-radius on content images Browsers with corner-shape: squircle support get Figma-matched radii, others fall back to original values with standard rounded corners. Co-authored-by: Cursor <cursoragent@cursor.com>
Add new ImageCard component with full-bleed image at top and content below. Update use cases page to display 13 use case images in 3-column grid layout. Co-authored-by: Cursor <cursoragent@cursor.com>
- Add 13 use case images for ImageCard component - Update hero images for product sections - Add new icons (bitcoin, crypto-wallet, money-hand, suitcase-work) - Update homepage and what-is-grid page Co-authored-by: Cursor <cursoragent@cursor.com>
Add subtle interactivity to homepage capability grid: - Background tint on hover (light/dark mode) - Toggle icon animation slides left on hover Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Accept main's OpenAPI schema changes (customer schema separation, enum fixes) Co-authored-by: Cursor <cursoragent@cursor.com>
The package is only needed locally for exporting icons, not for CI builds. Moving to optionalDependencies allows CI to pass without the license key. Co-authored-by: Cursor <cursoragent@cursor.com>
Contributor
|
Too many files changed for review. ( |
coreymartin
approved these changes
Feb 4, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Full documentation redesign with new visual design system.
This is a draft for preview purposes. Please do not review yet - sharing with design team for feedback.
Changes include:
Preview
Check the Mintlify preview link (will be added by bot) to see the changes.
Made with Cursor