Skip to content

grep-many/fin-sight

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

28 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Meta Merch Logo FinSight --- Financial Analytics Dashboard

FinSight is a fullโ€‘stack financial analytics dashboard for visualizing KPIs, products, and transaction data using modern web technologies.

Frontend Backend Database Redux Charts License: MIT Render GitHub Pages


๐Ÿ–ผ๏ธ Preview

Dashboard Overview


๐Ÿ“– Overview

FinSight provides a clean and interactive way to explore financial data.

The backend seeds predefined financial data into MongoDB and exposes readโ€‘only REST APIs.
The frontend consumes this data using Redux Toolkit Query and presents insights via charts and data grids.

โš ๏ธ This project does not support CRUD operations.
Data is seeded once and served as readโ€‘only analytics data.


โœจ Features

  • ๐Ÿ“ˆ KPI analytics dashboard
  • ๐Ÿ“Š Interactive charts (bar, line, area, pie, scatter)
  • ๐Ÿงฎ Financial trend prediction using regression
  • ๐Ÿ—ƒ๏ธ Product & transaction data grids
  • โšก RTK Query--powered data fetching
  • ๐ŸŽจ Material UI responsive layout
  • ๐ŸŒ™ Theme customization
  • ๐Ÿงฑ Clean monorepo architecture

๐Ÿงฐ Tech Stack

Frontend (Client)

  • Vite
  • React 19
  • TypeScript
  • Redux Toolkit + RTK Query
  • Material UI (MUI)
  • Recharts
  • React Router
  • Regression.js

Backend (Server)

  • Node.js
  • Express 5
  • TypeScript
  • MongoDB + Mongoose
  • Helmet, CORS, Morgan
  • dotenv

๐Ÿ—๏ธ Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   Frontend   โ”‚
โ”‚  React + Viteโ”‚
โ”‚  RTK Query   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜
        โ”‚ HTTP (REST)
        โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   Backend    โ”‚
โ”‚ Express API  โ”‚
โ”‚ Readโ€‘only    โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”˜
        โ”‚ Mongoose
        โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   MongoDB    โ”‚
โ”‚ Seeded Data  โ”‚
โ”‚ (Dummy.js)   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ“ Project Structure

fin-sight
โ”œโ”€โ”€ client        # Frontend (Vite + React)
โ”‚   โ”œโ”€โ”€ src
โ”‚   โ”‚   โ”œโ”€โ”€ components
โ”‚   โ”‚   โ”œโ”€โ”€ scenes
โ”‚   โ”‚   โ”œโ”€โ”€ state
โ”‚   โ”‚   โ”œโ”€โ”€ theme
โ”‚   โ”‚   โ””โ”€โ”€ main.tsx
โ”‚   โ””โ”€โ”€ vite.config.ts
โ”œโ”€โ”€ server        # Backend (Express + MongoDB)
โ”‚   โ”œโ”€โ”€ src
โ”‚   โ”‚   โ”œโ”€โ”€ models
โ”‚   โ”‚   โ”œโ”€โ”€ routes
โ”‚   โ”‚   โ”œโ”€โ”€ utils
โ”‚   โ”‚   โ””โ”€โ”€ index.ts
โ”‚   โ””โ”€โ”€ data
โ”‚       โ””โ”€โ”€ dummy.js
โ”œโ”€โ”€ LICENSE
โ””โ”€โ”€ README.md

๐Ÿ”— API Endpoints

Resource Endpoint


KPIs /kpi/kpis Products /product/products Transactions /transaction/transactions

All endpoints are readโ€‘only and consumed via RTK Query.


โš™๏ธ Environment Variables

Client (client/.env)

VITE_BASE_URL="http://localhost:1337"

Server (server/.env)

MONGO_URL="mongodb://localhost:27017/finsight"
PORT=1337
CLIENT_URL="http://localhost:5173"

๐Ÿ› ๏ธ Getting Started

1๏ธโƒฃ Clone the Repository

git clone https://github.com/grep-many/finsight.git
cd finsight

2๏ธโƒฃ Install Dependencies

Client

cd client
npm install

Server

cd server
npm install

3๏ธโƒฃ Run the Project

Backend

cd server
npm run dev

Frontend

cd client
npm run dev

Open http://localhost:5173


๐ŸŒฑ Database Seeding

On startup, the backend automatically seeds:

  • KPIs
  • Products
  • Transactions

Seeding runs only if collections are empty.


๐ŸŽฏ Use Cases

  • Financial analytics dashboards
  • KPI monitoring platforms
  • Data visualization projects
  • Portfolioโ€‘grade MERN applications
  • RTK Query learning reference

๐Ÿ“œ License

This project is licensed under the MIT License. See the License: MIT for details.


โญ Support

If you found this useful:

  • โญ Star the repo
  • ๐Ÿด Fork it
  • ๐Ÿ“Š Build your own analytics platform

FinSight --- turning raw financial data into clear insights.

About

FinSight is a full-stack financial analytics dashboard built with React, Vite, Redux Toolkit, and Express. It visualizes KPIs, products, and transactions using interactive charts, backed by a MongoDB API with seeded read-only data.

Topics

Resources

License

Stars

Watchers

Forks

Contributors