From 4cd81afb5576b063c14af2bbc5606c53f88b6637 Mon Sep 17 00:00:00 2001
From: Jessica Lin
Date: Wed, 3 Jun 2026 16:14:58 -0700
Subject: [PATCH 1/2] Redesign homepage with LaunchDarkly-inspired layout
- Restructure docs.yml tabs: Overview, EVM, SVM, Cross-Chain, API Reference, Liquidity, Changelog
- Fix duplicate slug bug in SVM tab layout
- New hero section: two-column layout with illustration, two CTAs, split heading
- Theme-aware hero illustration: dark fills for light mode, original for dark mode
- Custom hero button styles (green primary, white secondary) with light/dark variants
- API cards, Quick Links, What's New (Release Highlights), Resources, and Help sections
- Replace white SVG fills with #25272a for light mode visibility
Co-Authored-By: Claude Sonnet 4.6
---
fern/docs.yml | 189 +++++++++++++-----------
fern/docs/assets/img/hero-home-dark.svg | 127 ++++++++++++++++
fern/docs/assets/img/hero-home-new.svg | 82 +++++-----
fern/docs/assets/styles.css | 50 +++++++
fern/docs/pages/index.mdx | 167 ++++++++++++++++-----
5 files changed, 451 insertions(+), 164 deletions(-)
create mode 100644 fern/docs/assets/img/hero-home-dark.svg
diff --git a/fern/docs.yml b/fern/docs.yml
index 5fd48ffa..1daad1b0 100644
--- a/fern/docs.yml
+++ b/fern/docs.yml
@@ -36,32 +36,28 @@ metadata:
# Tabs configuration
tabs:
- home:
- display-name: Home
- icon: home
- docs:
- display-name: Docs
- icon: book
+ overview:
+ display-name: Overview
+ evm:
+ display-name: EVM
+ svm:
+ display-name: SVM
+ cross-chain:
+ display-name: Cross-Chain
api-reference:
display-name: API Reference
- icon: puzzle
liquidity:
display-name: Liquidity Integration
- icon: water
changelog:
display-name: Changelog
- icon: clock
changelog: docs/changelog
# Navigation structure
navigation:
- - tab: home
+ - tab: overview
layout:
- - page: Home
+ - page: Welcome
path: docs/pages/index.mdx
-
- - tab: docs
- layout:
- section: Introduction
slug: introduction
icon: fa-regular fa-compass
@@ -107,9 +103,51 @@ navigation:
slug: need-help
path: docs/pages/need-help/contact-support.mdx
- - section: Swap API
+ - section: Core Concepts
+ slug: core-concepts
+ icon: fa-regular fa-books
+ contents:
+ - page: Introduction to 0x
+ slug: introduction-to-0x
+ path: docs/pages/core-concepts/introduction-to-0x.mdx
+ - page: 0x Cheat Sheet
+ slug: 0x-cheat-sheet
+ path: docs/pages/core-concepts/0x-cheat-sheet.mdx
+ - page: Contracts
+ slug: contracts
+ path: docs/pages/core-concepts/contracts.mdx
+ - page: Order Types
+ slug: order-types
+ path: docs/pages/core-concepts/order-types.mdx
+ - page: Glossary
+ slug: glossary
+ path: docs/pages/core-concepts/glossary.mdx
+ - page: White Paper
+ slug: white-paper
+ path: docs/pages/core-concepts/white-paper.mdx
+ - page: Transaction Data
+ slug: transaction-data
+ path: docs/pages/core-concepts/transaction-data.mdx
+
+ - section: Developer Resources
+ slug: developer-resources
+ icon: fa-regular fa-screwdriver-wrench
+ contents:
+ - page: Bounties
+ slug: bounties
+ path: docs/pages/developer-resources/bounties.mdx
+ - page: Rate Limits
+ slug: rate-limits
+ path: docs/pages/developer-resources/rate-limits.mdx
+ - link: System Status
+ href: https://0x.statuspal.io/
+ target: _blank
+
+ - tab: evm
+ layout:
+ - section: EVM Swap API
slug: 0x-swap-api
- icon: fa-regular fa-arrows-rotate
+ icon: fa-regular fa-shuffle
contents:
- page: Introduction
slug: introduction
@@ -172,7 +210,7 @@ navigation:
slug: faq
path: docs/pages/introduction/faq.mdx
- - section: Gasless API
+ - section: EVM Gasless API
slug: gasless-api
icon: fa-regular fa-gas-pump
contents:
@@ -194,9 +232,28 @@ navigation:
- link: Gasless FAQ
href: /docs/0x-swap-api/faq#gasless-api
+ - section: Need Help?
+ slug: need-help
+ icon: fa-regular fa-circle-question
+ contents:
+ - page: FAQ
+ slug: faq
+ path: docs/pages/introduction/faq.mdx
+ - page: API Issues & Error Codes
+ slug: api-issues
+ path: docs/pages/introduction/api-issues.mdx
+ - page: Contact Support
+ slug: contact-support
+ path: docs/pages/need-help/contact-support.mdx
+ - link: Contact Sales
+ href: https://0x.org/contact
+ target: _blank
+
+ - tab: svm
+ layout:
- section: Solana Swap API
slug: solana-swap-api
- icon: fa-regular fa-arrows-rotate
+ icon: fa-regular fa-shuffle
contents:
- page: Introduction
slug: introduction
@@ -227,6 +284,25 @@ navigation:
- link: Gasless FAQ
href: /docs/0x-swap-api/faq#gasless-api
+ - section: Need Help?
+ slug: need-help
+ icon: fa-regular fa-circle-question
+ contents:
+ - page: FAQ
+ slug: faq
+ path: docs/pages/introduction/faq.mdx
+ - page: API Issues & Error Codes
+ slug: api-issues
+ path: docs/pages/introduction/api-issues.mdx
+ - page: Contact Support
+ slug: contact-support
+ path: docs/pages/need-help/contact-support.mdx
+ - link: Contact Sales
+ href: https://0x.org/contact
+ target: _blank
+
+ - tab: cross-chain
+ layout:
- section: Cross-Chain API
slug: cross-chain-api
icon: fa-regular fa-bridge
@@ -284,73 +360,6 @@ navigation:
href: https://0x.org/products/cross-chain
target: _blank
- - section: Trade Analytics API
- slug: trade-analytics-api
- icon: fa-regular fa-chart-column
- contents:
- - page: Introduction
- slug: introduction
- path: docs/pages/trade-analytics-api/introduction.mdx
- - page: Transaction Data
- slug: transaction-data
- path: docs/pages/core-concepts/transaction-data.mdx
- - link: Trade Analytics FAQ
- href: /docs/introduction/faq#trade-analytics-api
-
- - section: Core Concepts
- slug: core-concepts
- icon: fa-regular fa-books
- contents:
- - page: Introduction to 0x
- slug: introduction-to-0x
- path: docs/pages/core-concepts/introduction-to-0x.mdx
- - page: 0x Cheat Sheet
- slug: 0x-cheat-sheet
- path: docs/pages/core-concepts/0x-cheat-sheet.mdx
- - page: Contracts
- slug: contracts
- path: docs/pages/core-concepts/contracts.mdx
- - page: Order Types
- slug: order-types
- path: docs/pages/core-concepts/order-types.mdx
- - page: Glossary
- slug: glossary
- path: docs/pages/core-concepts/glossary.mdx
- - page: White Paper
- slug: white-paper
- path: docs/pages/core-concepts/white-paper.mdx
- - page: Transaction Data
- slug: transaction-data
- path: docs/pages/core-concepts/transaction-data.mdx
-
- - section: Developer Resources
- slug: developer-resources
- icon: fa-regular fa-screwdriver-wrench
- contents:
- - page: Bounties
- slug: bounties
- path: docs/pages/developer-resources/bounties.mdx
- - page: Rate Limits
- slug: rate-limits
- path: docs/pages/developer-resources/rate-limits.mdx
- - link: System Status
- href: https://0x.statuspal.io/
- target: _blank
-
- - section: Upgrading
- slug: upgrading
- icon: fa-regular fa-arrow-up
- contents:
- - page: Overview
- slug: overview
- path: docs/pages/upgrading/overview.mdx
- - page: Upgrading to Swap v2
- slug: upgrading-to-swap-v2
- path: docs/pages/upgrading/upgrading-to-swap-v2.mdx
- - page: Upgrading to Gasless v2
- slug: upgrading-to-gasless-v2
- path: docs/pages/upgrading/upgrading-to-gasless-v2.mdx
-
- section: Need Help?
slug: need-help
icon: fa-regular fa-circle-question
@@ -392,9 +401,13 @@ navbar-links:
- type: minimal
text: Contact Support
url: https://docs.0x.org/docs/introduction/need-help#-contact-developer-support-fastest-direct-help
- - type: minimal
- text: Discord
- url: https://discord.com/invite/official0x
+ - type: dropdown
+ text: Connect
+ links:
+ - text: X
+ href: https://x.com/0xProject
+ - text: Discord
+ href: https://discord.com/invite/official0x
- type: filled
text: Go to dashboard
url: https://dashboard.0x.org/create-account
diff --git a/fern/docs/assets/img/hero-home-dark.svg b/fern/docs/assets/img/hero-home-dark.svg
new file mode 100644
index 00000000..ab5c711c
--- /dev/null
+++ b/fern/docs/assets/img/hero-home-dark.svg
@@ -0,0 +1,127 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/fern/docs/assets/img/hero-home-new.svg b/fern/docs/assets/img/hero-home-new.svg
index d574d84b..b54feaa2 100644
--- a/fern/docs/assets/img/hero-home-new.svg
+++ b/fern/docs/assets/img/hero-home-new.svg
@@ -1,79 +1,79 @@
-
-
-
-
-
-
-
+
+
+
+
+
+
+
-
+
-
+
-
+
-
+
-
+
-
+
-
-
+
+
-
+
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -121,7 +121,7 @@
-
+
diff --git a/fern/docs/assets/styles.css b/fern/docs/assets/styles.css
index 98b08828..d4c6057c 100644
--- a/fern/docs/assets/styles.css
+++ b/fern/docs/assets/styles.css
@@ -16,3 +16,53 @@
.fern-layout-overview .fern-layout-footer-toolbar {
display: none !important;
}
+
+
+/* Hero illustration — swap between light and dark variants */
+.hero-illustration-dark { display: none; }
+.dark .hero-illustration-light { display: none; }
+.dark .hero-illustration-dark { display: block; }
+
+/* Hero buttons */
+.hero-btn-primary,
+.hero-btn-secondary {
+ display: inline-flex;
+ align-items: center;
+ padding: 3px 22px;
+ border-radius: 9999px;
+ text-decoration: none !important;
+ font-weight: 600;
+ font-size: 17px;
+ line-height: 1;
+ white-space: nowrap;
+ width: fit-content;
+}
+
+/* Hide the auto-injected external link icon */
+.hero-btn-primary svg,
+.hero-btn-secondary svg {
+ display: none !important;
+}
+
+.hero-btn-primary {
+ background-color: #01a74d;
+ color: #ffffff !important;
+ border: 1.5px solid transparent;
+}
+
+.dark .hero-btn-primary {
+ background-color: #01a74d;
+ color: #ffffff !important;
+}
+
+.hero-btn-secondary {
+ background-color: white;
+ color: #25272a !important;
+ border: 1.5px solid rgba(37, 39, 42, 0.2);
+}
+
+.dark .hero-btn-secondary {
+ background-color: #ffffff;
+ color: #25272a !important;
+ border-color: transparent;
+}
diff --git a/fern/docs/pages/index.mdx b/fern/docs/pages/index.mdx
index fdb96594..d9a4a2fd 100644
--- a/fern/docs/pages/index.mdx
+++ b/fern/docs/pages/index.mdx
@@ -5,39 +5,83 @@ hide-toc: true
hide-nav-links: true
---
-
+{/* ── Hero ── */}
-
- Welcome to 0x Docs
-
-
-
- Embed swaps in your onchain app
-
-
-
- Start building
-
-
+
+
+ Welcome to 0x Docs
+
+
+ Build onchain trading into your app. Liquidity from 150+ sources, across
+ EVM chains and Solana — with a single API.
+
+
+
+
+
+
+
+{/* ── Explore 0x APIs ── */}
+
Explore 0x APIs
-
- Embed swaps into your app
+
+ Embed token swaps on any EVM chain. Aggregated liquidity from 150+ sources.
+
+
+
+ Native Solana support. Fast, low-cost token swaps with deep SPL token
+ liquidity.
- Swap any token, any chain
+ Swap any token across any chain in one transaction.
-
- Enable seamless, gasless DeFi transactions
+
+ Enable seamless, gasless DeFi transactions.
- Track & analyze trading activity
+ Track and analyze every trade routed through 0x.
+{/* ── Quick Links ── */}
+
Quick Links
@@ -100,17 +146,31 @@ hide-nav-links: true
-Dev Resources
+{/* ── Release Highlights ── */}
-
+Release Highlights
-
- Answers to common integration issues
-
+| Date | Update | API |
+| ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------- |
+| May 2026 | [Exact-out support — specify a precise `buyAmount` and get the minimum sell amount required](https://docs.0x.org/changelog#2026-05-31-new-features) | Swap API, Gasless API |
+| May 2026 | [Concurrent gasless trades now supported for the same taker and sell token](https://docs.0x.org/changelog#2026-05-31-new-features) | Gasless API |
+| April 2026 | [New 0x Agent Skill for AI-powered integrations](https://docs.0x.org/changelog#2026-04-30-new-feature) | All APIs |
+| April 2026 | [Sub-BPS slippage precision now supported](https://docs.0x.org/changelog#2026-04-30-new-feature) | Swap API, Gasless API |
+| March 2026 | [Smart account signatures now supported](https://docs.0x.org/changelog#2026-04-13-new-features) | Gasless API |
+| March 2026 | [Fine-tuned native wrap/unwrap control via `wrapUnwrapMode`](https://docs.0x.org/changelog#2026-04-13-new-features) | Swap API |
-
- Real-time 0x system performance updates
-
+
+ See all updates →
+
+
+{/* ── Resources ── */}
+
+Resources
+
+
Quick reference for supported chains & contract addresses
+
+
+ Real-time 0x system performance updates
+
+
+
+ Understand 0x API rate limits
+
+
+
+ Manage your API keys and monitor usage
+
+
+
+
+{/* ── Help ── */}
+
+Need Help?
+
+
+
+
+ Answers to common integration issues
+
+
+
+ Contact the 0x developer support team
+
+
From 06644f2666f268833abb6a2070b776b23be80ffc Mon Sep 17 00:00:00 2001
From: Jessica Lin
Date: Wed, 3 Jun 2026 16:41:29 -0700
Subject: [PATCH 2/2] Fix all internal links after tab restructure
Update hrefs to use /{tab-slug}/{section-slug}/{page-slug} pattern
now that home/docs tabs have been replaced with overview/evm/svm/
cross-chain tabs.
Co-Authored-By: Claude Sonnet 4.6
---
fern/docs/pages/index.mdx | 30 +++++++++++++++++-------------
1 file changed, 17 insertions(+), 13 deletions(-)
diff --git a/fern/docs/pages/index.mdx b/fern/docs/pages/index.mdx
index d9a4a2fd..063a6121 100644
--- a/fern/docs/pages/index.mdx
+++ b/fern/docs/pages/index.mdx
@@ -40,7 +40,7 @@ hide-nav-links: true
Start building →
@@ -75,33 +75,37 @@ hide-nav-links: true
-
+
Embed token swaps on any EVM chain. Aggregated liquidity from 150+ sources.
-
+
Native Solana support. Fast, low-cost token swaps with deep SPL token
liquidity.
Swap any token across any chain in one transaction.
-
+
Enable seamless, gasless DeFi transactions.
- Track and analyze every trade routed through 0x.
+ Track and analyze trades routed through 0x.
@@ -114,7 +118,7 @@ hide-nav-links: true
Accelerate your 0x integration using AI tools
@@ -122,7 +126,7 @@ hide-nav-links: true
Get started with Swap API
@@ -138,7 +142,7 @@ hide-nav-links: true
Unlock new revenue streams with 0x
@@ -174,7 +178,7 @@ hide-nav-links: true
Quick reference for supported chains & contract addresses
@@ -186,7 +190,7 @@ hide-nav-links: true
Understand 0x API rate limits
@@ -210,7 +214,7 @@ hide-nav-links: true
Contact the 0x developer support team