DX-1128: docs — localise design system off @ably/ui (combined view for review/demo)

[jamiehenson]

Part of DX-1128. Combined view of the whole stack (#3409–#3416) on top of main — for reviewing/demoing the localisation as one diff. Not for merge; the individual stacked PRs land it.

What it does

Removes @ably/ui as docs' design-system source: vendors the Tailwind theme + CSS, a local Icon, cn/heights, and the full visual component set (Badge/Button/LinkButton/FeaturedLink/Status, SegmentedControl/TabMenu, ProductTile, Code/CodeSnippet), plus the syntax-highlighter util. (~169 files.)

End state

Entire visual surface local; compiled global.css 6.7k lines. Remaining @ably/ui imports = insights (×6) + scripts (×2 — the SessionDataProvider/useSessionData context API); the old SessionData Redux store + Flash reducer are gone after rebasing onto the 18.3.1 main (Ken's #3418 migration) — parked infra. Gates still open: full build, design sign-off, and working review apps (review-app asset-prefix issue tracked separately).

Stack (DX-1128)

	PR	Role
	#3409	Design foundation — vendor @ably/ui tokens + reset/core CSS
	#3410	Local cn + heights utils
	#3411	Docs-native Icon component
	#3412	Presentational components (Badge, Button, LinkButton, FeaturedLink, Status)
	#3413	Interactive components (SegmentedControl, TabMenu)
	#3414	ProductTile + product data (leaf)
	#3415	syntax-highlighter util + registry
	#3416	Code + CodeSnippet — completes the lift; prunes dead CSS + drops @ably/ui Tailwind scan
▶	#3417	Combined view of #3409–#3416 — review/demo only (based on main)

#3409–#3416 are a linear stack (each builds on the previous); #3417 is the combined view. ▶ = this PR.

Testing

• Load the review app.
• Check a sufficient sample of pages load with no visual regressions.

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 9dad9d15-64f4-4579-9f1a-a46cbc782087

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch dx-1128/docs-ably-ui-localisation

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[jamiehenson]

Closing this combined-view branch — the individual stacked PRs (#3410–#3416) are the source of truth for review and merge, and keeping a parallel squashed view in sync with the per-slice cascade isn't worth the upkeep.

~ 𝒞𝓁𝒶𝓊𝒹𝑒