Skip to content

docs(homepage): Redesign homepage with product separation for Data Replication and Agent Engine#74080

Draft
Ian Alton (ian-at-airbyte) wants to merge 6 commits intomasterfrom
devin/1772168127-homepage-product-separation
Draft

docs(homepage): Redesign homepage with product separation for Data Replication and Agent Engine#74080
Ian Alton (ian-at-airbyte) wants to merge 6 commits intomasterfrom
devin/1772168127-homepage-product-separation

Conversation

@ian-at-airbyte
Copy link
Contributor

@ian-at-airbyte Ian Alton (ian-at-airbyte) commented Feb 27, 2026

What

Redesigns the docs.airbyte.com homepage to create stronger product separation between Data Replication and Agent Engine using a three-tier layout: Hero → Data Replication → Agent Engine.

Follows up on airbytehq/airbyte#73725 which introduced the single-navbar dropdown with product separation.

Requested by Ian Alton (@ian-at-airbyte).

How

index.js:

  • Simplified the hero section to a centered title + tagline (removed 2-column grid with connectors)
  • Split the single navLinks array into drNavLinks (5 cards: Platform, Connectors, Release Notes, Developers, Community) and aeNavLinks (5 cards: About Agent Engine, Tutorials, Platform, API reference, Connectors)
  • Removed the "AI Agents" card from the Data Replication section
  • Moved popular connectors display from the hero into the Data Replication section
  • Added new SVG icon components for Agent Engine cards (TutorialsIcon, AgentConnectorsIcon, AgentApiIcon)
  • Reuses PlatformIcon for the Agent Engine "Platform" card (same icon as Data Replication)
  • Removed unused Arcade and Navattic imports

index.module.css:

  • Replaced generic .navSection/.navCard classes with product-specific prefixes (.drNavGrid/.drNavCard and .aeNavGrid/.aeNavCard)
  • Agent Engine section uses a slightly darker background (hsl(240, 20%, 95%) light / hsl(240, 18%, 16%) dark) to visually differentiate from the white Data Replication section
  • Dark mode overrides for Agent Engine cards and icons
  • AE grid is 5 columns on desktop, 3 on tablet, 1 on mobile
  • Removed unused legacy classes (.whySection, .whyList, .demoContainer, etc.)
  • Updated responsive breakpoints for both product sections

docs/platform/readme.md:

  • Added Navattic interactive product tour (moved from homepage) as a new ## Interactive product tour section

GitHub stars badge:

  • Removed maxAge=2592000 parameter from shields.io URL to fix "invalid" badge display

Updates since last revision

  • Moved Navattic demo from the homepage to /docs/platform/readme.md (new "Interactive product tour" section)
  • Updated Agent Engine cards to match all 5 top-level sidebar items: About Agent Engine, Tutorials, Platform, API reference, Connectors
  • Reused PlatformIcon for the AE "Platform" card instead of a separate AgentToolsIcon
  • Replaced AgentToolsIcon with TutorialsIcon (graduation cap SVG)
  • Fixed GitHub stars badge showing "invalid" by removing maxAge parameter
  • Removed unused CSS (.demoContainer) and updated AE grid from 4 → 5 columns

Review guide

  1. docs/platform/readme.md — Navattic embed added as "Interactive product tour" section
  2. index.js lines 48-94 — Updated AIAgentsIcon className, new TutorialsIcon, AgentConnectorsIcon, AgentApiIcon
  3. index.js lines 120-184 — Split nav links arrays (drNavLinks with 5 cards, aeNavLinks with 5 cards)
  4. index.js lines 186-327 — Three-tier JSX structure (Hero → Data Replication → Agent Engine), Navattic removed
  5. index.module.css lines 9-38 — Simplified hero section styling (centered, no grid)
  6. index.module.css lines 62-188 — Data Replication section styles
  7. index.module.css lines 190-283 — Agent Engine section styles with darker background and 5-column grid

⚠️ Human review checklist:

  • Agent Engine link paths (/ai-agents/about/, /ai-agents/tutorials/, /ai-agents/platform/, /ai-agents/api/, /ai-agents/connectors/) — verify these resolve in the Docusaurus build
  • Navattic component in MDX — verify the Navattic embed renders correctly on /platform/ page (uses MDXComponents registration)
  • Visual review needed — layout has not been tested locally in a browser (light/dark modes, responsive breakpoints, 5-column AE grid). Please verify via the Vercel preview or locally
  • Icon consistency: PlatformIcon uses navIconSvg class while other AE icons use aeNavIconSvg — both have identical styles but worth noting
  • Hard-coded HSL colors for Agent Engine section (hsl(240, 20%, 95%) / hsl(240, 18%, 16%)) instead of CSS variables — may want to add these to custom.css for consistency

User Impact

Users visiting docs.airbyte.com will see a redesigned homepage with clearer visual separation between Data Replication and Agent Engine products. The Agent Engine section has a darker background to distinguish it from Data Replication. The Navattic interactive demo has moved from the homepage to the Platform documentation page.

Can this PR be safely reverted and rolled back?

  • YES 💚

This is a pure frontend change to the homepage component, styles, and platform readme. No backend changes, no data migrations, no API changes.


Devin session


Open with Devin

- Hero section: simplified with centered title and tagline
- Data Replication section: popular connectors, 5 nav cards, Navattic demo
- Agent Engine section: darker background, 4 nav cards
- Removed AI Agents from Data Replication nav links
- Light/dark mode theming for both product sections
- Responsive design for tablet and mobile

Co-Authored-By: ian.alton@airbyte.io <ian.alton@airbyte.io>
@devin-ai-integration
Copy link
Contributor

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment and CI monitoring

@github-actions
Copy link
Contributor

👋 Greetings, Airbyte Team Member!

Here are some helpful tips and reminders for your convenience.

💡 Show Tips and Tricks

PR Slash Commands

Airbyte Maintainers (that's you!) can execute the following slash commands on your PR:

  • 🛠️ Quick Fixes
    • /format-fix - Fixes most formatting issues.
    • /bump-version - Bumps connector versions, scraping changelog description from the PR title.
  • ❇️ AI Testing and Review (internal link: AI-SDLC Docs):
    • /ai-prove-fix - Runs prerelease readiness checks, including testing against customer connections.
    • /ai-canary-prerelease - Rolls out prerelease to 5-10 connections for canary testing.
    • /ai-review - AI-powered PR review for connector safety and quality gates.
  • 🚀 Connector Releases:
    • /publish-connectors-prerelease - Publishes pre-release connector builds (tagged as {version}-preview.{git-sha}) for all modified connectors in the PR.
    • /bump-progressive-rollout-version - Bumps connector version with an RC suffix (2.16.10-rc.1) for progressive rollouts (enableProgressiveRollout: true).
      • Example: /bump-progressive-rollout-version changelog="Add new feature for progressive rollout"
  • ☕️ JVM connectors:
    • /update-connector-cdk-version connector=<CONNECTOR_NAME> - Updates the specified connector to the latest CDK version.
      Example: /update-connector-cdk-version connector=destination-bigquery
    • /bump-bulk-cdk-version bump=patch changelog='foo' - Bump the Bulk CDK's version. bump can be major/minor/patch.
  • 🐍 Python connectors:
    • /poe connector source-example lock - Run the Poe lock task on the source-example connector, committing the results back to the branch.
    • /poe source example lock - Alias for /poe connector source-example lock.
    • /poe source example use-cdk-branch my/branch - Pin the source-example CDK reference to the branch name specified.
    • /poe source example use-cdk-latest - Update the source-example CDK dependency to the latest available version.
  • ⚙️ Admin commands:
    • /force-merge reason="<REASON>" - Force merges the PR using admin privileges, bypassing CI checks. Requires a reason.
      Example: /force-merge reason="CI is flaky, tests pass locally"
📚 Show Repo Guidance

Helpful Resources

📝 Edit this welcome message.

Co-Authored-By: ian.alton@airbyte.io <ian.alton@airbyte.io>
@github-actions
Copy link
Contributor

github-actions bot commented Feb 27, 2026

Deploy preview for airbyte-docs ready!

✅ Preview
https://airbyte-docs-f3ddk22di-airbyte-growth.vercel.app

Built with commit d7b2c9e.
This pull request is being automatically deployed with vercel-action

…badges

- Move Navattic interactive demo from homepage to /docs/platform/readme.md
- Update Agent Engine cards to match sidebar: About, Tutorials, Platform, API, Connectors
- Reuse PlatformIcon (navIconSvg) for AE Platform card instead of separate icon
- Replace AgentToolsIcon with TutorialsIcon (graduation cap SVG)
- Fix GitHub stars badge by removing maxAge parameter
- Remove unused Navattic import and demoContainer CSS
- Update AE grid to 5 columns (3 on tablet, 1 on mobile)

Co-Authored-By: ian.alton@airbyte.io <ian.alton@airbyte.io>
Copy link
Contributor

@devin-ai-integration devin-ai-integration bot left a comment

Choose a reason for hiding this comment

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

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 3 additional findings.

Open in Devin Review

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