Skip to content

Comments

[WIP] Docs home and nav refresh with new designs#14178

Draft
sfanahata wants to merge 74 commits intomasterfrom
docs-home-and-nav-refresh-v1
Draft

[WIP] Docs home and nav refresh with new designs#14178
sfanahata wants to merge 74 commits intomasterfrom
docs-home-and-nav-refresh-v1

Conversation

@sfanahata
Copy link
Contributor

@sfanahata sfanahata commented Jun 26, 2025

DESCRIBE YOUR PR

This is the home page refresh and top navigation add to the docs site.

  1. Add a top navigation: products, SDKs, etc
  2. Refresh home page with new banner, pull most used SDKs to top, add search bar
  3. Bring product/feature visibility to the top
  4. Make the side navigation dedicated to only the top nav selection

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

Shannon Anahata and others added 26 commits June 4, 2025 15:19
…s release automation files with latest from master
…ions from master to resolve conflicts and navigation issues
@vercel
Copy link

vercel bot commented Jun 26, 2025

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

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment Feb 20, 2026 9:26pm
sentry-docs Ready Ready Preview, Comment Feb 20, 2026 9:26pm

Request Review

@codecov
Copy link

codecov bot commented Jun 26, 2025

Bundle Report

Changes will increase total bundle size by 59.46kB (0.28%) ⬆️. This is within the configured threshold ✅

Detailed changes
Bundle name Size Change
sentry-docs-server-cjs 11.0MB 64.71kB (0.59%) ⬆️
sentry-docs-client-array-push 9.8MB -5.25kB (-0.05%) ⬇️

Affected Assets, Files, and Routes:

view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name Size Change Total Size Change (%)
8928.js (New) 1.76MB 1.76MB 100.0% 🚀
1614.js -73 bytes 1.05MB -0.01%
../instrumentation.js -3 bytes 973.36kB -0.0%
9523.js -3 bytes 949.31kB -0.0%
../app/[[...path]]/page.js 7.07kB 598.49kB 1.2%
../../static/media/Linkedin-1128x191.*.png (New) 245.58kB 245.58kB 100.0% 🚀
../../static/media/yellow-shape-08.*.png (New) 139.23kB 139.23kB 100.0% 🚀
2194.js (New) 78.1kB 78.1kB 100.0% 🚀
7269.js 39.5kB 69.36kB 132.27% ⚠️
1339.js (New) 65.31kB 65.31kB 100.0% 🚀
../app/platform-redirect/page.js 1 bytes 31.48kB 0.0%
9567.js -75 bytes 19.37kB -0.39%
1729.js (Deleted) -1.64MB 0 bytes -100.0% 🗑️
../../static/media/home_illustration.*.png (Deleted) -347.3kB 0 bytes -100.0% 🗑️
4217.js (Deleted) -191.77kB 0 bytes -100.0% 🗑️
9273.js (Deleted) -84.53kB 0 bytes -100.0% 🗑️

Files in ../app/[[...path]]/page.js:

  • ./src/imgs/yellow-shape-08.png → Total Size: 364 bytes

  • ./app/[[...path]]/page.tsx → Total Size: 10.68kB

  • ./src/imgs/Linkedin-1128x191.png → Total Size: 338 bytes

  • ./src/components/search/index.tsx → Total Size: 440 bytes

  • ./src/imgs/yellow-shape-08.png → Total Size: 364 bytes

  • ./src/components/home.tsx → Total Size: 37.35kB

  • ./src/components/card.tsx → Total Size: 1.59kB

  • ./src/components/platformFilter.tsx → Total Size: 40 bytes

  • ./src/components/platformFilter/client.tsx → Total Size: 505 bytes

  • ./src/imgs/Linkedin-1128x191.png → Total Size: 338 bytes

Files in 7269.js:

  • ./app/not-found.tsx → Total Size: 2.81kB

  • ./app/not-found.tsx → Total Size: 4.38kB

  • ./src/components/search/search.module.scss → Total Size: 1.34kB

Files in 1339.js:

  • ./src/components/sidebar/style.module.scss → Total Size: 468 bytes

  • ./src/components/platformIcon.tsx → Total Size: 36.94kB

  • ./src/components/platformSelector/index.tsx → Total Size: 24.63kB

  • ./src/components/sidebar/index.tsx → Total Size: 14.51kB

  • ./src/components/focus-active-link.tsx → Total Size: 1.41kB

  • ./src/components/sidebar/sidebarNavigation.tsx → Total Size: 7.72kB

  • ./src/components/platformIcon.tsx → Total Size: 36.94kB

  • ./src/components/docPage/index.tsx → Total Size: 10.23kB

  • ./src/components/platformSelector/index.tsx → Total Size: 490 bytes

  • ./src/docTree.ts → Total Size: 10.95kB

  • ./src/components/sidebar/dynamicNav.tsx → Total Size: 4.21kB

  • ./src/components/sidebar/style.module.scss → Total Size: 468 bytes

  • ./src/components/sidebar/productSidebar.tsx → Total Size: 1.15kB

  • ./src/components/focus-active-link.tsx → Total Size: 485 bytes

  • ./src/components/header.tsx → Total Size: 872 bytes

App Routes Affected:

App Route Size Change Total Size Change (%)
/[[...path]] 7.07kB 3.15MB 0.23%
/platform-redirect 1 bytes 2.58MB 0.0%
/ 39.5kB 2.65MB 1.51%
view changes for bundle: sentry-docs-client-array-push

Assets Changed:

Asset Name Size Change Total Size Change (%)
static/chunks/pages/_app-*.js -3 bytes 873.24kB -0.0%
static/css/*.css 3.58kB 744.79kB 0.48%
static/css/*.css -999 bytes 18.1kB -5.23%
static/css/*.css -556 bytes 4.62kB -10.75%
static/css/*.css 1.65kB 15.64kB 11.81% ⚠️
static/chunks/7750-*.js -3 bytes 415.85kB -0.0%
static/chunks/6436-*.js (New) 278.55kB 278.55kB 100.0% 🚀
/static/media/Linkedin-*.83085e4a.png (New) 245.58kB 245.58kB 100.0% 🚀
server/app/api/ip-*.js -15.98kB 243.15kB -6.17%
server/app/_not-*.js -15.98kB 243.14kB -6.17%
server/app/[[...path]]/page_client-*.js -15.98kB 243.1kB -6.17%
server/app/platform-*.js -16.59kB 228.03kB -6.78%
static/chunks/8524-*.js (New) 190.81kB 190.81kB 100.0% 🚀
/static/media/yellow-*.643dd5f3.png (New) 139.23kB 139.23kB 100.0% 🚀
static/chunks/app/[[...path]]/page-*.js -1.17kB 82.53kB -1.4%
static/chunks/2386-*.js (New) 62.82kB 62.82kB 100.0% 🚀
static/chunks/6670-*.js (New) 19.21kB 19.21kB 100.0% 🚀
static/chunks/app/platform-*.js 2.03kB 15.13kB 15.53% ⚠️
server/middleware-*.js -5.55kB 1.0kB -84.74%
server/middleware-*.js 5.55kB 6.55kB 555.3% ⚠️
app-*.json -93 bytes 4.5kB -2.02%
static/chunks/app/not-*.js 19 bytes 2.77kB 0.69%
static/7DeNhThnym2g5xqPs6S7q/_buildManifest.js (New) 684 bytes 684 bytes 100.0% 🚀
static/7DeNhThnym2g5xqPs6S7q/_ssgManifest.js (New) 77 bytes 77 bytes 100.0% 🚀
/static/media/home_illustration.*.png (Deleted) -347.3kB 0 bytes -100.0% 🗑️
static/chunks/353-*.js (Deleted) -276.51kB 0 bytes -100.0% 🗑️
static/chunks/4926-*.js (Deleted) -120.27kB 0 bytes -100.0% 🗑️
static/chunks/9212-*.js (Deleted) -73.36kB 0 bytes -100.0% 🗑️
static/chunks/404-*.js (Deleted) -43.6kB 0 bytes -100.0% 🗑️
static/chunks/4746-*.js (Deleted) -20.32kB 0 bytes -100.0% 🗑️
static/ZG9WK-*.js (Deleted) -684 bytes 0 bytes -100.0% 🗑️
static/ZG9WK-*.js (Deleted) -77 bytes 0 bytes -100.0% 🗑️

Files in static/chunks/app/[[...path]]/page-*.js:

  • ./src/imgs/yellow-shape-08.png → Total Size: 364 bytes

  • ./src/imgs/Linkedin-1128x191.png → Total Size: 338 bytes

  • ./src/components/platformFilter/client.tsx → Total Size: 11.73kB

Files in static/chunks/2386-*.js:

  • ./src/components/platformSelector/index.tsx → Total Size: 26.09kB

  • ./src/components/platformIcon.tsx → Total Size: 37.08kB

  • ./src/components/sidebar/style.module.scss → Total Size: 468 bytes

  • ./src/components/search/search.module.scss → Total Size: 1.3kB

Files in static/chunks/6670-*.js:

  • ./src/components/focus-active-link.tsx → Total Size: 1.38kB

Files in static/chunks/app/not-*.js:

  • ./app/not-found.tsx → Total Size: 4.35kB

App Routes Affected:

App Route Size Change Total Size Change (%)
/ 19 bytes 12.5kB 0.15%

…rn search results, dynamic header search visibility

- Reduce SDK tile sizes and align with search bar
- Auto-open SDK selector when navigating to /platforms/
- Modernize search results: rounded corners, white bg, better shadows
- Fix search results z-index to appear above other content
- Hide header search on home page, show when scrolling past hero search
- Add HomeSearchObserver for intersection-based visibility detection
…centering

- Smaller header (32px), description, and search bar (44px height)
- Compact SDK tiles (70x70px) with larger icons, 6 cols desktop / 4 cols mobile
- Center-align all content on mobile, left/right align on desktop
- Wider search bar (50/50 column split)
- SDK tiles and 'GO TO ALL SDKS' right-aligned on desktop, centered on mobile
Shannon Anahata and others added 3 commits February 20, 2026 10:48
Resolve conflicts while preserving our branch's customized sidebar logic:
- page.tsx: kept master's improved error handling with Sentry logging
- docPage/index.tsx: merged extractPlatforms with master's getCurrentPlatformOrGuide and getSdkPackageName
- focus-active-link.tsx: took master's improved scroll handling
- header.tsx: merged TopNavClient changes with master's dynamic Search import
- home.tsx: merged our layout with master's new Sentry for AI card
- sidebar/index.tsx: merged MobileSidebarNav with master's EQUIVALENT_PATHS logic
- sidebar/sidebarNavigation.tsx: added AI and Guides handlers to our customized sidebar structure

Co-Authored-By: Claude <noreply@anthropic.com>
- Add AI section link (/ai/) to TopNavClient and MobileSidebarNav
- Add Guides section link (/guides/) to TopNavClient and MobileSidebarNav
- Update nav order: SDKs, Product, AI, Guides, Concepts, Admin, API, Security
- Add sidebar handlers for /ai/ and /guides/ routes in sidebarNavigation.tsx
- Remove unused basicPlatforms prop from MobileSidebarNav (cleanup)
- Fix stray merge conflict marker in page.tsx
- Update platformicons to 9.0.7 (adds Firebase icon)

Co-Authored-By: Claude <noreply@anthropic.com>
- Restore SDK redirect feature from stash (clicking SDKs nav goes to last selected platform)
- Use client-side navigation (router.push) instead of hard navigation for smoother transitions
- Fix header search bar layout shift by setting fixed width (340px)
- Remove dynamic import for Search component to eliminate loading lag
- Fix HomeSearchObserver wrapper width to allow full-width search on home page
- Reduce spacing between search bar and top nav
- Make SDK tile text nowrap to keep 'React Native' on one line
- Update home page title to 'Welcome To Sentry Docs'

Co-Authored-By: Claude <noreply@anthropic.com>
- Fix ultra-wide layout by removing mx-auto from main content and adding
  data-layout-anchor to platform sidebar
- Fix onboarding options sticky position (80px -> var(--header-height))
- Hide top nav at same breakpoint hamburger appears (lg-xl: 1130px)

Co-Authored-By: Claude <noreply@anthropic.com>
- Hamburger menu now appears below 768px
- Top nav and Go to Sentry button show at 768px+
- Mobile Ask AI button shows below 768px (when search's Ask AI is hidden)
- Sidebar mobile behavior matches md breakpoint

Co-Authored-By: Claude <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.

1 participant