Pulse Analytics

Analytics dashboard — FastAPI backend + React/TypeScript/Vite frontend.

Quick Start

Backend

cd backend
pip install -r requirements.txt
uvicorn main:app --reload --port 8001
# API at http://localhost:8001
# Swagger docs at http://localhost:8001/docs

Frontend

cd frontend
npm install
npm run dev
# App at http://localhost:5173

The frontend falls back to built-in demo data automatically if the backend isn't running — great for demos.

Structure

pulse-analytics/
├── backend/
│   ├── main.py            ← FastAPI app (5 endpoints)
│   └── requirements.txt
└── frontend/
    ├── index.html
    ├── package.json
    ├── vite.config.ts     ← proxies /analytics → localhost:8001
    └── src/
        ├── types/         ← shared TypeScript interfaces
        ├── api/           ← axios client + analytics calls
        ├── hooks/         ← useDashboard, useClock
        ├── components/    ← Sidebar, KpiCard, Sparkline, BarChart,
        │                     DonutChart, LineChart, ProductsTable
        └── pages/         ← DashboardPage

Stack

• Backend: FastAPI, uvicorn
• Frontend: React 18, TypeScript, Vite, Axios, CSS Modules