feat(apollo-vertex): framer-motion animations for shell and sidebar

[creilly11235]

Summary

• Migrate sidebar width animation from CSS transitions to framer-motion spring physics (matching MRS)
• Add asymmetric text fade via AnimatePresence on nav items (slide-in on expand, fade-out on collapse)
• Inline shell-nav-item into shell-sidebar and remove standalone component
• Add shell-animations constants for spring config
• Update shell-layout with animation-aware structure
• Animate user profile section with expand/collapse transitions

Split from #468 — this is the core animation feature. Depends on #537 (shell cleanup) and #538 (sidebar infra).

Test plan

• Sidebar collapse/expand animates smoothly with spring physics
• Nav item text fades asymmetrically (slide-in on expand, fade-out on collapse)
• User profile animates on sidebar state change
• Skeleton loading state displays during i18n initialization
• No animation jank or layout shift during transitions

🤖 Generated with Claude Code

[github-actions]

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

Project	Deployment	Review	Updated (PT)
apollo-design	🟢 Ready	Preview, Logs	Apr 17, 2026, 06:57:07 PM
apollo-docs	🟢 Ready	Preview, Logs	Apr 17, 2026, 06:55:26 PM
apollo-landing	🟢 Ready	Preview, Logs	Apr 17, 2026, 06:54:50 PM
apollo-ui-react	🟢 Ready	Preview, Logs	Apr 17, 2026, 06:55:19 PM
apollo-vertex	❌ Failed: 2026-04-18T01:54:47.175Z Summary: /vercel/path0/.turbo/runs/3CVilMODm4aHkrmmNrqxjox0a0F.json...	N/A, Logs	Apr 17, 2026, 06:54:55 PM

[github-actions]

Dependency License Review

• ✅ 1941 package(s) scanned
• ✅ No license issues found
• ⚠️ 3 package(s) excluded (see details below)

License distribution

License	Packages
MIT	1701
ISC	89
Apache-2.0	61
BSD-3-Clause	28
BSD-2-Clause	23
BlueOak-1.0.0	8
MPL-2.0	5
MIT OR Apache-2.0	3
MIT-0	3
CC0-1.0	3
LGPL-3.0-or-later	2
(MIT OR Apache-2.0)	2
Unlicense	2
Python-2.0	1
CC-BY-4.0	1
(MPL-2.0 OR Apache-2.0)	1
Unknown	1
Artistic-2.0	1
(WTFPL OR MIT)	1
(BSD-2-Clause OR MIT OR Apache-2.0)	1
CC-BY-3.0	1
0BSD	1
(MIT OR CC0-1.0)	1
MIT AND ISC	1

Excluded packages

Package	Version	License	Reason
@img/sharp-libvips-linux-x64	1.2.4	LGPL-3.0-or-later	LGPL pre-built binary, not linked
@img/sharp-libvips-linuxmusl-x64	1.2.4	LGPL-3.0-or-later	LGPL pre-built binary, not linked
khroma	2.1.0	Unknown	MIT per GitHub repo, missing license field in package.json

[creilly11235]

Closing in favor of a smaller, stacked set of PRs per team guidelines:

• fix(apollo-vertex): contain viewport-sized and fixed children in preview wrapper #576 — preview wrapper containment fix
• Creilly11235/vertex shell sidebar provider migration #577 — shell migration to shadcn SidebarProvider (with sub-nav support)
• Creilly11235/vertex shell sidebar framer #578 — icon hover scale on collapsed nav items
• Creilly11235/vertex shell user profile framer #579 — user profile fade-in text + minimal variant
• Creilly11235/vertex shell docs demo #580 — shell docs + sub-nav demo data

Each replacement is one concern, under Peter's 800–1000 LoC cap, stacked via the manual-stacked-PR workflow.