Skip to content

fix(nav): use valid @posthog/icons names for docs menu items#16907

Merged
cleo-pleurodon merged 4 commits into
masterfrom
posthog-code/fix-nav-icon-names
May 27, 2026
Merged

fix(nav): use valid @posthog/icons names for docs menu items#16907
cleo-pleurodon merged 4 commits into
masterfrom
posthog-code/fix-nav-icon-names

Conversation

@cleo-pleurodon
Copy link
Copy Markdown
Contributor

Changes

The top navigation was missing icons on a handful of docs menu entries — specifically under PostHog Code → Features and Support → Guides — because the icon names referenced in src/navs/index.js don't exist in the @posthog/icons package.

menuData.tsx resolves icons via Icons[item.icon as keyof typeof Icons] and silently renders nothing when the lookup is undefined, which is why the items still showed up with no visible icon.

Fixed the following icon names:

Section Item Was Now
PostHog Code → Features Inbox IconInbox IconNotebook
PostHog Code → Features Command Center IconLayoutDashboard IconDashboard
PostHog Code → Features Worktrees IconGitFork IconGitRepository
Support → Guides Inbox management IconInbox IconNotebook
Support → Guides Email channel IconMail IconLetter
Support → Guides GitHub integration IconGitHub IconGithub (casing)

If anyone has stronger preferences for the replacement icons (esp. for the two "Inbox" entries), happy to swap them — these are the closest matches available in @posthog/icons@0.36.6.

Checklist

  • I've read the docs and/or content style guides.
  • Words are spelled using American English
  • Use relative URLs for internal links
  • I've checked the pages added or changed in the Vercel preview build
  • If I moved a page, I added a redirect in vercel.json

Created with PostHog Code

Five icon names referenced in src/navs/index.js don't exist in @posthog/icons,
so the resolver in TaskBarMenu silently rendered no icon for those entries.

- IconInbox -> IconNotebook (PostHog Code > Inbox, Support > Inbox management)
- IconLayoutDashboard -> IconDashboard (PostHog Code > Command Center)
- IconGitFork -> IconGitRepository (PostHog Code > Worktrees)
- IconMail -> IconLetter (Support > Email channel)
- IconGitHub -> IconGithub (Support > GitHub integration; casing)

Generated-By: PostHog Code
Task-Id: 680d1cf1-2902-4dca-9b31-1f8546f84152
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 19, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview May 27, 2026 04:30PM

Follow-ups from review:

- PostHog Code → Inbox: IconLetter (mail icon, per feedback)
- PostHog Code → Command Center: IconGridMasonry (square split into a grid)
- Diversify Support → Guides colors (all entries were orange) and swap
  Slack integration's icon to IconChat to avoid duplicating IconMessage
  with Widget setup

Also fix other docs nav items whose icon names didn't resolve in
@posthog/icons:

- Product tours → Customize styles: IconColor → IconPalette
- Customer analytics → B2B mode: IconCohort → IconGroups
- Customer analytics → Create usage metrics: IconG (typo) → IconGraph
- Endpoints → Rate limits: IconGauge → IconDashboard

And add a fallback in TaskBarMenu/menuData.tsx so icon names that exist
only in src/components/OSIcons/Icons.tsx (e.g. IconTag, IconAnthropic,
IconOpenAI, IconClaudeCode, IconGemini, IconLangChain, IconOpenRouter,
IconOpenClaw) resolve too. PostHog Icons still take precedence so JSX
usage like <Icons.IconApps /> is unchanged.

Generated-By: PostHog Code
Task-Id: 680d1cf1-2902-4dca-9b31-1f8546f84152
Keep the import surface in menuData.tsx unchanged per review feedback.
The local-OSIcons-only names (IconTag, IconAnthropic, IconClaudeCode,
IconGemini, IconLangChain, IconOpenAI, IconOpenRouter, IconOpenClaw)
were already silently failing before this PR and remain a separate
problem to solve elsewhere.

Generated-By: PostHog Code
Task-Id: 680d1cf1-2902-4dca-9b31-1f8546f84152
@cleo-pleurodon cleo-pleurodon requested a review from gewenyu99 May 19, 2026 21:26
@cleo-pleurodon cleo-pleurodon marked this pull request as ready for review May 19, 2026 21:26
…aster

Master removed the Product Tours product in #16756 (deleted docs, landing
page, and nav entries). This branch was still adding back the Product
Tours docs sidebar block, causing a merge conflict in src/navs/index.js.

Remove both Product Tours entries from src/navs/index.js (the API
reference link and the main docs sidebar section) so the three-way merge
against master is clean again.

Generated-By: PostHog Code
Task-Id: c0d6ec58-56fd-41f2-a83d-d098d1ef26cb
@cleo-pleurodon cleo-pleurodon merged commit 418f936 into master May 27, 2026
17 checks passed
@cleo-pleurodon cleo-pleurodon deleted the posthog-code/fix-nav-icon-names branch May 27, 2026 17:00
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.

2 participants