Dashboard
React web client for the platform. Branded Business Studio in the UI (nav home label, browser tab, marketing hero) — the apps/dashboard name is the technical/directory name and is unchanged.
Architecture
Section titled “Architecture”This is a client-only React application that connects to the central Platform API server for all backend functionality.
- Frontend: React 19 + Vite + Tailwind CSS v4 + the
@abeauvois/platform-uidesign system - Routing: TanStack Router (file-based)
- State Management: TanStack React Query; forms via
@tanstack/react-form - Backend: Connects to Platform API (
/apps/api) via Vite proxy
All pages require authentication except sign-in/sign-up.
- Home (
/) — operator overview driven by live platform data - Board (
/tasks) — unified Kanban of tasks + review artifacts (social/blog drafts, links). “Select” mode multi-selects the currently-filtered cards for a bulk Archive or Delete (delete asks for confirmation first) - Scheduled jobs (
/scheduled-jobs,/scheduled-jobs/new,/scheduled-jobs/$name) — view, create, and inspect recurring (cron) job schedules - Quote requests (
/quote-requests,/quote-requests/$id) — manage incoming quote requests, edit status/notes - Settings (
/settings) — theme (light/dark/system, live-applied) + locale, Business Studio preferences, and the default notification email - Scraped data (
/scraped-data) — ingestion results - Auth (
/signin,/signup)
Development
Section titled “Development”# From monorepo rootbun run dashboard
# Or from this directorybun run devClient runs on port 5000.
Note: The API server must be running for the dashboard to function:
# Start both API and dashboardbun run devScripts
Section titled “Scripts”bun run dev # Start development serverbun run build # Build for productionbun run serve # Preview production buildbun run test # Run testsbun run lint # Run ESLintbun run format # Run PrettierEnvironment Variables
Section titled “Environment Variables”VITE_API_URL=http://localhost:3000 # Optional, defaults to proxyProxy Configuration
Section titled “Proxy Configuration”The Vite dev server proxies all /api/* requests to http://localhost:3000 (Platform API server).
