Moneta — Smart Financial Dashboard

Moneta is a precision-engineered personal finance management platform built for modern life. It combines high-performance web architecture with a dedicated Python microservice to provide a seamless, secure, and data-rich experience for tracking wealth and spending.

Live Project: monetafin.vercel.app

---

🏗️ Architecture Overview

The system is designed with a clear separation of concerns, utilizing a hybrid Next.js and Python architecture to handle specialized data processing tasks effectively.

graph TD
    User([User]) <--> NextApp[Next.js App Router v16]
    NextApp <--> Clerk(Clerk Auth)
    NextApp <--> DB[(PostgreSQL / Neon)]
    NextApp <--> ExternalData(Coingecko / Stooq)
    NextApp -- Async Request --> PythonSvc[Python PDF Microservice]
    PythonSvc -- Data Extraction --> NextApp
    
    subgraph "Main Application (Vercel)"
        NextApp
    end

    subgraph "Data Processing (Render)"
        PythonSvc
    end

Loading

✨ Core Features

• Asynchronous Bank Import: A dedicated Python/Flask service processes PDF bank statements, extracting and translating (KA ➔ EN) transactions without blocking the user interface.
• Unified Investment Portfolio: Real-time tracking for Stocks, Crypto, Property, and Custom assets.
• Intelligent Financial Health: A 4-pillar scoring system (Savings, Spending, Goals, Engagement) providing actionable insights based on demographic benchmarking.
• Bento Grid Dashboard: Optimized layouts for Mobile, Tablet, and Desktop, ensuring critical financial data is always at a glance.
• Recurring Transactions Engine: Automated bill and income tracking via Vercel Cron.

🛠️ Technology Stack

Frontend & Core

• Framework: Next.js 16.2.4 (App Router, Server Actions)
• State Management: custom hooks + SWR for optimized data fetching.
• Styling: Tailwind CSS v4 with a custom design system and glassmorphism accents.
• Type Safety: End-to-end TypeScript integration.

Backend & Infrastructure

• Database: PostgreSQL managed via Prisma 7.7.0.
• Processing: Python 3.12 + Flask + pdfplumber.
• Authentication: Clerk v6 with custom themes.

---

🚀 Getting Started

Prerequisites

• Node.js 20+
• Python 3.10+
• PostgreSQL instance

Installation

1. Clone & Install Dependencies

   git clone https://github.com/karroge10/Moneta.git
   cd Moneta
   npm run setup

2. Database Setup

   npx prisma db push
   npm run seed

3. Development Server

   npm run dev

---

📄 License

MIT License. See LICENSE for details.