A modern, open-source dashboard for monitoring cash flow, risk alerts, forecasting, and financial KPIs. Built with Next.js, TypeScript, TailwindCSS, and Prisma.
- Interactive cash flow charts and dashboards
- Risk alerts and recommendations
- KPI overview and segment analysis
- Monte Carlo simulation panel
- Forecasting tools
- API endpoints for cashflow, forecasts, health, KPIs, recommendations, segments, and simulation
- Responsive UI with shadcn/ui components
- Framer Motion animations
- SQLite (development) and Postgres (production) support via Prisma
- Node.js (v18+ recommended)
- npm
- SQLite (for local dev) or Postgres (for production)
- Clone the repository:
git clone https://github.com/gabedossantos/cashflow-dashboard.git cd cashflow-dashboard - Install dependencies:
npm install
- Copy environment variables template and configure as needed:
cp .env.example .env
- Generate Prisma client:
npx prisma generate
- Run the development server:
npm run dev
To build for production:
npm run buildTo start the production server:
npm startapp/– Next.js app directory (routes, layouts, API endpoints)components/– UI and dashboard componentshooks/– Custom React hookslib/– Utility libraries (analytics, ML, types, etc.)prisma/– Prisma schema and migrationsscripts/– Utility scripts (e.g., seed data)tests/– Unit and API tests
/api/alerts– Risk alerts/api/cashflow– Cash flow data/api/forecasts– Forecasting/api/health– Health checks/api/kpis– Key performance indicators/api/recommendations– Recommendations/api/segments– Segment analysis/api/simulation– Monte Carlo simulation
Run unit and API tests with:
npm testContributions are welcome! Please open issues or pull requests for improvements, bug fixes, or new features.
This project is licensed under the MIT License. See LICENSE for details.
For questions or support, open an issue on GitHub.