Frontend Stack
Next.js, React, and UI technologies
Frontend Stack
Required Versions
| Technology | Version | Notes |
|---|---|---|
| Next.js | 15.x | App Router with Server Components |
| React | 19.x | Latest stable |
| react-hook-form | 7.x | 7.50.0+ |
| Zod | 3.x | Latest stable |
| Tailwind CSS | 3.4 | Utility-first styling |
| Shadcn/ui | Latest | Radix UI primitives |
Architecture
- Routing: Next.js App Router (file-system based)
- Components: Shadcn/ui + Radix UI primitives
- Styling: Tailwind CSS with dark mode support
- Forms: react-hook-form + Zod validation
State Management
| State Type | Approach |
|---|---|
| Server data | React Server Components |
| Server state (async) | TanStack Query v5 |
| Client state | useState, useReducer |
| URL state | Filters, pagination |
| Persistence | Local storage for preferences |
No Redux/Zustand - Server Components + TanStack Query cover most needs.
Data Visualization
| Use Case | Library |
|---|---|
| Org Chart | React Flow |
| Charts/Graphs | Recharts |
Key Rules
- Use Zod 3.x - Stable, well-documented, excellent AI training data
- Server Components first - Use client components only when needed
- Strict TypeScript - noUncheckedIndexedAccess enabled
Specifics to be defined during implementation