Phase 11 — Example consumer app

[jonmatum]

Phase 11 — Example consumer app

Proves the package works end-to-end and serves as a living reference implementation.

Deliverables

• apps/example — Next.js 15 App Router app installing @jonmatum/next-shell as a workspace dep
• Wires AppShell, AppProviders, ThemeProvider, Auth.js (demo provider), nav config, CommandBar
• Demonstrates:
  • Dashboard page with charts + data table
  • Settings page with forms + validation (react-hook-form + zod)
  • Auth-gated admin page (role gate)
  • Data table with server-side pagination + filters
  • Toasts (success / error / promise)
  • Empty, loading, error states
  • Dark mode toggle + brand override live demo
• Deployed to Vercel; live demo link added to README

Acceptance

• App runs with pnpm --filter example dev
• Every major shell feature is exercised at least once
• Zero raw color literals in example source (same lint rule applies)

Depends on Phases 3, 4, 5, 6, 7.

Part of the next-shell app shell extraction plan.