Frontend

Documentation for the UI layer of FastAPI RBAC.

Current implementation

The shipped UI is a React + TypeScript + Vite app in react-frontend/.

Page	Covers
Setup	Install, env files, local dev commands
Architecture	Project layout and coding patterns
Authentication	Client auth, tokens, RBAC guards
State management	Redux Toolkit slices and thunks
UI components	ShadCN / Tailwind
Testing	Vitest and Playwright
Deployment	Docker, Nginx, production build
Troubleshooting	Common client issues

Cross-cutting system context: System Architecture.

Future frontend frameworks

This section is structured so additional UIs can be documented beside React without rewriting the nav:

docs/frontend/
├── index.md                 # this page
├── react/                   # current SPA (documented)
├── nextjs/                  # reserved — SSR / App Router (not implemented)
└── angular/                 # reserved — alternative client (not implemented)

When a second framework ships:

1. Add a subdirectory under docs/frontend/ (for example nextjs/).
2. Mirror the same topic split (setup, architecture, auth, …) where it applies.
3. Register pages under the Frontend nav group in mkdocs.yml.
4. Keep shared backend contracts in API Reference; do not fork API docs per UI.

Until then, treat React as the only supported frontend.