# Admin App DESIGN.md Reference

Use this optional DESIGN.md-style reference when a business management app needs a clean, operational UI.

## Design Tokens
- Background: soft neutral gray.
- Surfaces: white with subtle borders and soft shadows.
- Text: graphite/slate hierarchy.
- Accent: one primary color from the BA brief; if none, use teal/emerald or professional blue.
- Radius: moderate rounded cards and controls.

## Components
- App shell: sidebar, topbar, content header, action toolbar.
- Dashboard: KPI cards, chart placeholders, recent activities, alerts, task/order/customer summaries.
- CRUD pages: toolbar, filters, table/list, row actions, add/edit/delete modals.
- Forms: clear labels, required fields, grouped sections, primary/secondary buttons.
- Feedback: toast for successful add/edit/delete, inline validation hints, status badges.

## UX Rules
- Pages should show realistic fake data immediately; avoid empty screens unless the workflow specifically needs an empty state.
- Primary workflows should be discoverable above the fold.
- Navigation must be consistent across all generated pages.
- Mobile views must keep actions reachable and data readable.
