Skip to content

aad1tyaaaaa/LenDen

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

4 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Typing SVG

LenDen Logo

Version License PRs Welcome Made with Love

A comprehensive fintech application empowering Indian users with intuitive debt tracking, smart savings, community investments, and AI-powered financial advice โ€” all accessible through voice in multiple Indian languages.


Features โ€ข Tech Stack โ€ข Screenshots โ€ข Getting Started โ€ข Architecture โ€ข i18n โ€ข Contributors


๐Ÿ“น Prototype Demo

Watch the Prototype Video

Click above to watch LenDen in action โ€” see the complete user flow from onboarding to financial management.


โœจ Features


%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#e94560', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#0f3460', 'lineColor': '#16213e', 'secondaryColor': '#16213e', 'tertiaryColor': '#1a1a2e', 'fontFamily': 'Fira Code', 'fontSize': '14px'}}}%%
flowchart TB
    subgraph CORE["๐Ÿ  LenDen Ecosystem"]
        direction TB
        HOME["๐Ÿ  Smart Dashboard\nโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”\nBalance โ€ข Stats โ€ข Budget\nTransactions โ€ข Quick Actions"]
    end

    subgraph FINANCE["๐Ÿ’Ž Financial Modules"]
        direction LR
        UD["๐Ÿ’ฐ Udhaari\nโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”\nโ€ข Debt Ledger\nโ€ข Priority Tracking\nโ€ข AI Clearance Tips\nโ€ข Gamification"]
        GU["๐Ÿท Gullack\nโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”\nโ€ข Savings Overview\nโ€ข Goal Tracking\nโ€ข AI Saving Tips\nโ€ข Coin Animation"]
        CO["๐Ÿค Community\nโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”\nโ€ข Chit Fund Schemes\nโ€ข Quick Udhaari\nโ€ข Multi-Provider\nโ€ข EMI Calculator"]
        SA["๐Ÿง  Salah\nโ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”\nโ€ข Health Score\nโ€ข Expert Advisors\nโ€ข Loan Marketplace\nโ€ข AI Recommendations"]
    end

    subgraph INFRA["โšก Infrastructure Layer"]
        direction LR
        VO["๐ŸŽค Voice Engine\nMultilingual NLP"]
        I18["๐ŸŒ i18n Layer\n6 Indian Languages"]
        AI["๐Ÿค– AI Engine\nSmart Suggestions"]
        SEC["๐Ÿ”’ Security\n2FA + Biometrics"]
    end

    CORE --> FINANCE
    FINANCE --> INFRA

    style CORE fill:#e94560,stroke:#e94560,color:#fff
    style FINANCE fill:#0f3460,stroke:#0f3460,color:#fff
    style INFRA fill:#16213e,stroke:#16213e,color:#fff
    style HOME fill:#1a1a2e,stroke:#e94560,color:#fff
    style UD fill:#1a1a2e,stroke:#e94560,color:#fff
    style GU fill:#1a1a2e,stroke:#e94560,color:#fff
    style CO fill:#1a1a2e,stroke:#e94560,color:#fff
    style SA fill:#1a1a2e,stroke:#e94560,color:#fff
    style VO fill:#1a1a2e,stroke:#16213e,color:#fff
    style I18 fill:#1a1a2e,stroke:#16213e,color:#fff
    style AI fill:#1a1a2e,stroke:#16213e,color:#fff
    style SEC fill:#1a1a2e,stroke:#16213e,color:#fff
Loading

๐Ÿ’ฐ Udhaari โ€” Intelligent Debt Tracking

"Your personal debt ledger, reimagined with AI and gamification."

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#e94560', 'fontFamily': 'Fira Code'}}}%%
flowchart LR
    A["๐Ÿ“ Add Debt\nLend or Borrow"] --> B["๐Ÿท๏ธ Set Priority\n๐Ÿ”ด High ๐ŸŸก Med ๐ŸŸข Low"]
    B --> C["๐Ÿ“… Track Due Date\nVisual Countdown"]
    C --> D["๐Ÿค– AI Suggests\nClearance Order"]
    D --> E["โœ… Clear Debt\n๐ŸŽฎ Earn Rewards"]
    E --> F["๐Ÿ“Š Level Up!\nProgress Journey"]

    style A fill:#1a1a2e,stroke:#e94560,color:#fff
    style B fill:#1a1a2e,stroke:#e94560,color:#fff
    style C fill:#1a1a2e,stroke:#0f3460,color:#fff
    style D fill:#1a1a2e,stroke:#0f3460,color:#fff
    style E fill:#1a1a2e,stroke:#16213e,color:#fff
    style F fill:#e94560,stroke:#e94560,color:#fff
Loading

๐Ÿ“Š Smart Ledger

Track every lending and borrowing transaction with intelligent priority levels:

  • ๐Ÿ”ด High Priority โ€” Due soon, affects local credit
  • ๐ŸŸก Medium Priority โ€” Standard timeline debts
  • ๐ŸŸข Low Priority โ€” Flexible repayment

๐Ÿ“… Due Date Intelligence

Visual countdown indicators that change color as deadlines approach, with automated push notifications for upcoming payments.

๐Ÿค– AI-Powered Clearance

The AI engine analyzes your debts and recommends the optimal clearance order:

"Clear your โ‚น800 debt with Local Kirana first โ€” it's due soon and affects your local credit score!"

๐ŸŽฎ Gamification Engine

  • ๐Ÿ† Debt Clearing Journey with progress visualization
  • โญ Level System โ€” Progress from Level 1 to Financial Freedom
  • ๐ŸŽฏ Milestones โ€” Celebrate each debt cleared with animations
  • ๐Ÿ“Š 40% Progress Bar with coin-style indicators

๐Ÿท Gullack โ€” Smart Savings Management

"Watch your digital piggy bank grow coin by coin, guided by AI."

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#0f3460', 'fontFamily': 'Fira Code'}}}%%
flowchart LR
    A["๐Ÿ’ต Set Goal\nEmergency โ€ข Phone\nFestival โ€ข Custom"] --> B["๐Ÿ’ฐ Add Money\nManual or Auto"]
    B --> C["๐Ÿ“ˆ Track Growth\n+โ‚น2,500/month"]
    C --> D["๐Ÿ’ก AI Tips\nSave โ‚น400/month"]
    D --> E["๐Ÿท Watch Fill\nCoin Animation"]
    E --> F["๐ŸŽ‰ Goal Hit!\nโ‚น50,000 Reached"]

    style A fill:#1a1a2e,stroke:#0f3460,color:#fff
    style B fill:#1a1a2e,stroke:#0f3460,color:#fff
    style C fill:#1a1a2e,stroke:#16213e,color:#fff
    style D fill:#1a1a2e,stroke:#16213e,color:#fff
    style E fill:#1a1a2e,stroke:#e94560,color:#fff
    style F fill:#0f3460,stroke:#0f3460,color:#fff
Loading

๐Ÿ’ธ Total Savings Dashboard

Real-time overview showing โ‚น30,700 saved with:

  • ๐Ÿ“ˆ Monthly growth tracking (+โ‚น2,500 trend)
  • ๐ŸŽฏ Goal-wise breakdown with deadlines
  • ๐Ÿ“Š Visual progress bars per goal

๐ŸŽฏ Active Savings Goals

๐Ÿ›ก๏ธ Emergency Fund    โ‚น15,000 / โ‚น50,000  โ–“โ–“โ–“โ–“โ–“โ–“โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 30%
๐Ÿ“ฑ New Phone         โ‚น8,500  / โ‚น25,000  โ–“โ–“โ–“โ–“โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘โ–‘ 34%
๐ŸŽŠ Festival Shopping โ‚น7,200  / โ‚น10,000  โ–“โ–“โ–“โ–“โ–“โ–“โ–“โ–“โ–“โ–‘โ–‘โ–‘โ–‘ 72%

๐Ÿ’ก AI Saving Tips

Personalized suggestions that actually save money:

"Buy a monthly bus pass for โ‚น800 instead of daily tickets. You'll save โ‚น400 every month!"

๐Ÿท Animated Piggy Bank

A delightful visual experience as your savings grow:

๐Ÿท Your Gullack is Growing!
๐Ÿช™๐Ÿช™๐Ÿช™๐Ÿช™๐Ÿช™๐Ÿช™โšชโšชโšชโšช  60% Full
Keep saving to see it fill up with coins!

Each coin lights up golden as you hit 10% milestones, creating a satisfying sense of progress.

๐Ÿค Community โ€” Chit Funds & Quick Loans

"Collective financial power, digitized and made transparent for everyone."

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#16213e', 'fontFamily': 'Fira Code'}}}%%
flowchart TB
    subgraph CHIT["๐Ÿ“‹ Chit Fund Schemes"]
        direction LR
        C6["6 Months\nโ‚น1,000/mo"] --- C9["9 Months\nโ‚น1,500/mo"] --- C12["12 Months\nโ‚น2,000/mo"]
        C18["18 Months\nโ‚น2,500/mo"] --- C24["24 Months\nโ‚น3,000/mo"]
    end

    subgraph LOAN["โšก Quick Udhaari Engine"]
        direction LR
        L1["๐ŸŽš๏ธ Adjust Amount\nSlider Control"] --> L2["๐Ÿ“Š Calculate\nInterest Rate"]
        L2 --> L3["โฑ๏ธ Pick Tenure\n3/6/9/12 months"]
        L3 --> L4["๐Ÿ’ฐ See Total\nReal-time EMI"]
    end

    subgraph PROV["๐Ÿฆ Loan Providers"]
        direction LR
        P1["PaySense\n๐ŸŸข 85% Match\nFin"]
        P2["HDFC Bank\n๐ŸŸก 65% Match\nBank"]
        P3["Bajaj Finance\n๐ŸŸข 78% Match\nNBFC"]
    end

    CHIT --> LOAN
    LOAN --> PROV

    style CHIT fill:#0f3460,stroke:#0f3460,color:#fff
    style LOAN fill:#16213e,stroke:#16213e,color:#fff
    style PROV fill:#1a1a2e,stroke:#1a1a2e,color:#fff
    style C6 fill:#1a1a2e,stroke:#e94560,color:#fff
    style C9 fill:#1a1a2e,stroke:#e94560,color:#fff
    style C12 fill:#1a1a2e,stroke:#e94560,color:#fff
    style C18 fill:#1a1a2e,stroke:#e94560,color:#fff
    style C24 fill:#1a1a2e,stroke:#e94560,color:#fff
    style L1 fill:#1a1a2e,stroke:#0f3460,color:#fff
    style L2 fill:#1a1a2e,stroke:#0f3460,color:#fff
    style L3 fill:#1a1a2e,stroke:#0f3460,color:#fff
    style L4 fill:#1a1a2e,stroke:#0f3460,color:#fff
    style P1 fill:#1a1a2e,stroke:#16213e,color:#fff
    style P2 fill:#1a1a2e,stroke:#16213e,color:#fff
    style P3 fill:#1a1a2e,stroke:#16213e,color:#fff
Loading

๐Ÿ“‹ Chit Fund Schemes

Choose from 5 investment cycles tailored to Indian community finance:

Scheme Monthly Total Duration
๐Ÿฅ‰ Starter โ‚น1,000 โ‚น6,000 6 months
๐Ÿฅˆ Standard โ‚น1,500 โ‚น13,500 9 months
๐Ÿฅ‡ Premium โ‚น2,000 โ‚น24,000 12 months
๐Ÿ’Ž Gold โ‚น2,500 โ‚น45,000 18 months
๐Ÿ‘‘ Diamond โ‚น3,000 โ‚น72,000 24 months

Each scheme includes detailed benefits, rules, eligibility, and interactive modals.

โšก Quick Udhaari (Instant Loans)

Micro-loan engine with real-time calculations:

  • ๐ŸŽš๏ธ Adjustable Slider โ€” Drag to set loan amount
  • ๐Ÿ“Š Live Interest โ€” Rates computed instantly
  • โฑ๏ธ Flexible Tenure โ€” 3, 6, 9, or 12 months
  • ๐Ÿงฎ Total Preview โ€” See exact repayment amount

๐Ÿฆ Multi-Provider Marketplace

Provider Type Max Loan Interest Speed
PaySense Fintech โ‚น5L 16-36% 24hrs
HDFC Bank โ‚น40L 10.5-21% 3-7d
Bajaj NBFC โ‚น25L 13-30% 2-4hrs

๐Ÿง  Salah โ€” Expert Financial Advice & AI Recommendations

"Certified experts and AI intelligence, both at your fingertips."

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#e94560', 'fontFamily': 'Fira Code'}}}%%
flowchart TB
    subgraph SCORE["๐Ÿ“Š Financial Health Engine"]
        direction LR
        S1["๐Ÿ” Analyze Debts\n& Savings"] --> S2["๐Ÿ“ˆ Calculate Score\n720 / 850"]
        S2 --> S3["๐Ÿท๏ธ Rate: GOOD\n๐ŸŸข Above Average"]
        S3 --> S4["๐Ÿ’ก Improvement\nSuggestions"]
    end

    subgraph EXPERT["๐Ÿ‘จโ€๐Ÿ’ผ Expert Advisory Network"]
        direction LR
        E1["๐ŸŽ“ CA Rajesh Kumar\nโญ 4.8 โ€ข Tax Planning\n๐ŸŸข Available"]
        E2["๐Ÿ’ผ Priya Mehta\nโญ 4.6 โ€ข Investments\n๐Ÿ”ด Busy"]
        E3["๐Ÿ† Dr. Amit Sharma\nโญ 4.9 โ€ข Debt Mgmt\n๐ŸŸข Available"]
    end

    subgraph AIENG["๐Ÿค– AI Recommendation Engine"]
        direction LR
        A1["โšก URGENT\nClear โ‚น800\nKirana Debt"]
        A2["๐Ÿ“ˆ INVEST\nStart โ‚น500/mo\nELSS SIP"]
        A3["๐Ÿ›ก๏ธ PROTECT\nBuild โ‚น1L\nEmergency Fund"]
    end

    SCORE --> EXPERT
    SCORE --> AIENG

    style SCORE fill:#0f3460,stroke:#0f3460,color:#fff
    style EXPERT fill:#16213e,stroke:#16213e,color:#fff
    style AIENG fill:#1a1a2e,stroke:#e94560,color:#fff
    style S1 fill:#1a1a2e,stroke:#0f3460,color:#fff
    style S2 fill:#1a1a2e,stroke:#0f3460,color:#fff
    style S3 fill:#1a1a2e,stroke:#0f3460,color:#fff
    style S4 fill:#1a1a2e,stroke:#0f3460,color:#fff
    style E1 fill:#1a1a2e,stroke:#16213e,color:#fff
    style E2 fill:#1a1a2e,stroke:#16213e,color:#fff
    style E3 fill:#1a1a2e,stroke:#16213e,color:#fff
    style A1 fill:#e94560,stroke:#e94560,color:#fff
    style A2 fill:#0f3460,stroke:#0f3460,color:#fff
    style A3 fill:#16213e,stroke:#16213e,color:#fff
Loading

๐Ÿ“Š Financial Health Score

Your credit-worthiness at a glance:

Score: 720 / 850          Rating: ๐ŸŸข GOOD
โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘   84.7%

๐Ÿ’ก Keep clearing debts to reach 750+
   for better loan rates!

๐Ÿ‘จโ€๐Ÿ’ผ Expert Advisory Network

Connect with certified financial professionals:

  • ๐ŸŽ“ Chartered Accountants โ€” Tax planning experts
  • ๐Ÿ’ผ Financial Advisors โ€” Investment strategists
  • ๐Ÿ† Debt Specialists โ€” Debt management pros
  • ๐Ÿ’ฌ Chat or ๐Ÿ“ž Call โ€” Instant consultation
  • โญ Ratings + years of experience per advisor

๐Ÿค– AI Recommendation Tiers

โšก IMMEDIATE ACTION Clear your high-priority โ‚น800 debt with Local Kirana to improve local credit standing

๐Ÿ“ˆ INVESTMENT TIP Start a SIP of โ‚น500/month in ELSS funds for tax savings and long-term growth

๐Ÿ›ก๏ธ GOAL PLANNING Create a dedicated emergency fund goal of โ‚น1 lakh for better financial security

๐Ÿฆ Loan Details Modal

One-click deep dive into any loan provider:

  • ๐Ÿ“Š Eligibility score with match percentage
  • ๐Ÿ’น Interest rate breakdown
  • โฑ๏ธ Processing time estimates
  • โœ… Feature comparison badges
  • ๐Ÿ”— Direct apply on provider website

๐ŸŽค Voice-First Financial Input

"Speak naturally in your mother tongue โ€” LenDen understands."

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#0f3460', 'fontFamily': 'Fira Code'}}}%%
sequenceDiagram
    participant U as ๐Ÿ—ฃ๏ธ User
    participant V as ๐ŸŽค Voice Engine
    participant N as ๐Ÿง  NLP Processor
    participant A as ๐Ÿ“ฑ LenDen App

    U->>V: "เคฎเฅˆเค‚เคจเฅ‡ เคšเคพเคฏ เคชเคฐ 20 เคฐเฅเคชเคฏเฅ‡ เค–เคฐเฅเคš เค•เคฟเค"
    activate V
    V->>N: Raw audio transcript
    activate N
    Note over N: Stage 1: Understanding words...
    N->>N: Stage 2: Analyzing transaction...
    N->>A: Stage 3: Adding to account...
    deactivate N
    activate A
    A-->>U: โœ… Added: โ˜• Tea โ€” โ‚น20 (Food)
    deactivate A
    deactivate V
    Note over U,A: ๐ŸŽ‰ Transaction logged in 3 seconds!
Loading

๐Ÿ—ฃ๏ธ Multilingual Voice Commands

Speak naturally in Hindi, English, or any supported language:

๐Ÿ—ฃ๏ธ "เคฎเฅˆเค‚เคจเฅ‡ เคšเคพเคฏ เคชเคฐ 20 เคฐเฅเคชเคฏเฅ‡ เค–เคฐเฅเคš เค•เคฟเค"
   โ†’ โ˜• Tea Expense โ€ข โ‚น20 โ€ข Food

๐Ÿ—ฃ๏ธ "I spent 50 rupees on auto rickshaw"
   โ†’ ๐Ÿ›บ Auto Rickshaw โ€ข โ‚น50 โ€ข Transport

๐Ÿ—ฃ๏ธ "เค‘เคŸเฅ‹ เคฎเฅ‡เค‚ 45 เคฐเฅเคชเคฏเฅ‡ เคฆเคฟเค"
   โ†’ ๐Ÿ›บ Auto Rickshaw โ€ข โ‚น45 โ€ข Transport

๐Ÿ—ฃ๏ธ "Add 500 rupees grocery expense"
   โ†’ ๐Ÿ›’ Grocery โ€ข โ‚น500 โ€ข Food

๐Ÿ—ฃ๏ธ "เคฐเคพเคนเฅเคฒ เค•เฅ‹ 200 เคฐเฅเคชเคฏเฅ‡ เค‰เคงเคพเคฐ เคฆเคฟเค"
   โ†’ ๐Ÿ’ฐ Lent to Rahul โ€ข โ‚น200 โ€ข Udhaari

๐Ÿ—ฃ๏ธ "Received 15000 salary"
   โ†’ ๐Ÿ’ต Salary Credit โ€ข โ‚น15,000 โ€ข Income

๐Ÿง  3-Stage NLP Processing Pipeline

๐Ÿ”ต Stage 1 โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” Understanding
   Speech-to-text in detected language

๐ŸŸก Stage 2 โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” Analyzing
   Extract: Amount โ€ข Category โ€ข Type

๐ŸŸข Stage 3 โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” Recording
   Auto-create transaction entry

๐Ÿ”Š Voice Biometrics Security

  • ๐ŸŽค Voice Recognition Training โ€” Unique voiceprint
  • ๐Ÿ”’ Secure Authentication โ€” Unlock with your voice
  • ๐Ÿ›ก๏ธ Anti-Spoofing โ€” Liveness detection built-in

๐Ÿ’ก Smart Suggestion Chips

Pre-built voice command templates appear as tappable chips, making it easy for first-time users.

โš™๏ธ Settings & Security Hub

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#16213e', 'fontFamily': 'Fira Code'}}}%%
mindmap
  root((โš™๏ธ Settings))
    ๐Ÿ‘ค Profile
      Verification Badges
      Account Details
      Edit Information
    ๐Ÿ”— Linked Accounts
      ๐Ÿฆ SBI Bank
      ๐Ÿ’ณ Google Pay
      ๐Ÿ’ฐ Paytm Wallet
    ๐ŸŒ Language & Voice
      6 Indian Languages
      Voice Training
      Dialect Selection
    ๐Ÿ”’ Security
      Two-Factor Auth
      Voice Biometrics
      PIN / Biometric Lock
      Privacy Controls
    ๐Ÿ”” Notifications
      Transaction Alerts
      Payment Reminders
      Savings Updates
      Expert Tips
Loading

๐Ÿ›  Tech Stack

Frontend Core

React TypeScript Vite

Styling & UI

Tailwind CSS shadcn/ui Radix UI Lucide

Animation & Motion

GSAP Framer Motion

Data & Forms

Recharts React Hook Form Zod

Internationalization

i18next react-i18next

Routing

React Router

Backend

Node.js Express PostgreSQL

AI & APIs

Gemini API Web Speech API Razorpay

DevOps

GitHub Actions

๐Ÿ“ฆ Full Dependency Tree (click to expand)
Category Package Version
Core react ^18.3.1
react-dom ^18.3.1
react-router-dom ^7.9.3
UI Library @radix-ui/* Various (20+ primitives)
class-variance-authority ^0.7.1
clsx + tailwind-merge Latest
cmdk ^1.1.1
Animation gsap ^3.13.0
framer-motion ^12.23.22
Charts recharts ^2.15.2
Forms react-hook-form ^7.64.0
@hookform/resolvers ^5.2.2
zod ^4.1.11
i18n i18next ^25.5.3
react-i18next ^16.0.0
Other embla-carousel-react ^8.6.0
input-otp ^1.4.2
react-day-picker ^8.10.1
react-resizable-panels ^2.1.7
sonner ^2.0.3
vaul ^1.1.2
Build vite 6.3.5
@vitejs/plugin-react-swc ^3.10.2

๐Ÿ–ผ Application Gallery

Homepage
๐Ÿ  Dashboard
Udhaari and Gullack
๐Ÿ’ฐ Udhaari & Gullack
Chit Fund
๐Ÿฆ Community Chit Funds
Expert Advice
๐Ÿง  Salah (Advice)
Profile
๐Ÿ‘ค User Profile
LenDen Logo
๐Ÿท๏ธ Brand Identity

๐Ÿš€ Getting Started

Prerequisites

โœ… Node.js โ‰ฅ 16
โœ… npm or yarn
โœ… Git

Installation

# Clone the repository
git clone https://github.com/your-username/LenDen.git

# Navigate to the project directory
cd LenDen

# Install dependencies
npm install

Development

# Start development server
npm run dev

๐ŸŒ The app will be available at http://localhost:3000 (configured in vite.config.ts)

Production Build

# Create optimized production build
npm run build

๐Ÿ“ Build output is generated in the build/ directory


๐Ÿ— Architecture

LenDen/
โ”œโ”€โ”€ ๐Ÿ“„ index.html                    # Entry point
โ”œโ”€โ”€ ๐Ÿ“ฆ package.json                  # Dependencies & scripts
โ”œโ”€โ”€ โš™๏ธ vite.config.ts                # Vite build config + aliases
โ”‚
โ”œโ”€โ”€ ๐Ÿ“‚ src/
โ”‚   โ”œโ”€โ”€ ๐Ÿš€ main.tsx                  # App bootstrap
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ฑ App.tsx                   # Main app (1490 lines, all pages)
โ”‚   โ”œโ”€โ”€ ๐ŸŽฌ AppGSAP.tsx              # GSAP-animated variant with i18n
โ”‚   โ”œโ”€โ”€ ๐ŸŒ i18n.ts                  # i18next configuration
โ”‚   โ”œโ”€โ”€ ๐ŸŽจ index.css                # Global styles + Tailwind
โ”‚   โ”‚
โ”‚   โ”œโ”€โ”€ ๐Ÿ“‚ components/
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“Š ModernDashboard.tsx   # Financial overview dashboard
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ’ฐ ModernUdhaariGullack.tsx  # Debt & savings manager
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿค CommunityTab.tsx     # Chit funds & quick loans
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿง  ModernSalah.tsx      # Expert advice & loan marketplace
โ”‚   โ”‚   โ”œโ”€โ”€ โš™๏ธ ModernSettings.tsx    # Settings with linked accounts
โ”‚   โ”‚   โ”œโ”€โ”€ ๐ŸŽค ModernVoiceInput.tsx  # Voice transaction input
โ”‚   โ”‚   โ”œโ”€โ”€ ๐ŸŽ“ Onboarding.tsx       # New user onboarding flow
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ‘‘ ModernPremium.tsx     # Premium features module
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ“ ModernLayout.tsx      # Responsive app layout
โ”‚   โ”‚   โ”‚
โ”‚   โ”‚   โ””โ”€โ”€ ๐Ÿ“‚ ui/                   # 49 shadcn/ui components
โ”‚   โ”‚       โ”œโ”€โ”€ button.tsx, card.tsx, dialog.tsx ...
โ”‚   โ”‚       โ”œโ”€โ”€ tabs.tsx, badge.tsx, progress.tsx ...
โ”‚   โ”‚       โ””โ”€โ”€ chart.tsx, carousel.tsx, sidebar.tsx ...
โ”‚   โ”‚
โ”‚   โ”œโ”€โ”€ ๐Ÿ“‚ locales/                  # Translation files
โ”‚   โ”‚   โ”œโ”€โ”€ ๐Ÿ‡ฌ๐Ÿ‡ง en.json
โ”‚   โ”‚   โ””โ”€โ”€ ๐Ÿ‡ฎ๐Ÿ‡ณ hi.json (+ te, ta, mr, sd)
โ”‚   โ”‚
โ”‚   โ”œโ”€โ”€ ๐Ÿ“‚ styles/                   # Additional stylesheets
โ”‚   โ”œโ”€โ”€ ๐Ÿ“‚ mockups/                  # Design mockups
โ”‚   โ””โ”€โ”€ ๐Ÿ“‚ guidelines/              # Design guidelines
โ”‚
โ””โ”€โ”€ ๐Ÿ“‚ public/                       # Static assets
    โ”œโ”€โ”€ ๐Ÿ–ผ๏ธ homepage.jpg, profile.jpg, etc.
    โ”œโ”€โ”€ ๐Ÿ“น prototype.mp4
    โ””โ”€โ”€ ๐ŸŽจ logo.jpg, pfp.png

Component Architecture

%%{init: {'theme': 'dark', 'themeVariables': { 'primaryColor': '#e94560', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#0f3460', 'lineColor': '#e94560', 'secondaryColor': '#16213e', 'tertiaryColor': '#1a1a2e', 'fontFamily': 'Fira Code'}}}%%
graph TD
    A["main.tsx"] --> B["App.tsx"]
    B --> C["๐Ÿ  Home Dashboard"]
    B --> D["๐Ÿ’ฐ Udhaari/Gullack"]
    B --> E["๐Ÿค Community Tab"]
    B --> F["๐Ÿง  Salah Advice"]
    B --> G["โš™๏ธ Settings"]

    C --> H["Balance Card"]
    C --> I["Quick Stats"]
    C --> J["Budget Progress"]
    C --> K["Transactions"]

    D --> L["Debt Tracker"]
    D --> M["Savings Goals"]
    D --> N["AI Suggestions"]

    E --> O["Chit Schemes"]
    E --> P["Quick Udhaari Loans"]

    F --> Q["Health Score"]
    F --> R["Expert Advisors"]
    F --> S["Loan Marketplace"]
    F --> T["AI Recommendations"]

    B --> U["๐ŸŽค Voice Input Modal"]
    B -.-> V["AppGSAP.tsx โ€” GSAP Variant"]

    style A fill:#e94560,color:#fff
    style B fill:#0f3460,color:#fff
    style C fill:#16213e,color:#fff
    style D fill:#16213e,color:#fff
    style E fill:#16213e,color:#fff
    style F fill:#16213e,color:#fff
    style G fill:#16213e,color:#fff
Loading

๐ŸŒ Internationalization

LenDen is built for India's linguistic diversity with full i18n support:

Language Flag Code Status
English ๐Ÿ‡ฌ๐Ÿ‡ง en โœ… Complete
Hindi (เคนเคฟเค‚เคฆเฅ€) ๐Ÿ‡ฎ๐Ÿ‡ณ hi โœ… Complete
Telugu (เฐคเฑ†เฐฒเฑเฐ—เฑ) ๐Ÿ‡ฎ๐Ÿ‡ณ te ๐Ÿ”„ In Progress
Tamil (เฎคเฎฎเฎฟเฎดเฏ) ๐Ÿ‡ฎ๐Ÿ‡ณ ta ๐Ÿ”„ In Progress
Marathi (เคฎเคฐเคพเค เฅ€) ๐Ÿ‡ฎ๐Ÿ‡ณ mr ๐Ÿ”„ In Progress
Sindhi (ุณู†ฺŒูŠ) ๐Ÿ‡ฎ๐Ÿ‡ณ sd ๐Ÿ”„ In Progress

๐Ÿ“ Translation files located in src/locales/ โ€ข Powered by react-i18next


๐ŸŽจ Design Philosophy

Principle Implementation
๐ŸŽฏ Mobile-First Optimized for smartphones with max-w-md responsive layout
๐ŸŽจ Gradient-Rich UI Layered gradients with glassmorphism effects throughout
โœจ Micro-Animations GSAP scroll triggers + Framer Motion page transitions
โ™ฟ Accessibility Voice-first design for users with limited literacy
๐Ÿงฉ Component System 49 shadcn/ui primitives for consistent design language
๐Ÿ‡ฎ๐Ÿ‡ณ Culturally Aware Indian financial terminology (Udhaari, Gullack, Salah)

๐Ÿ“š Resources

Documentation API Reference Community Support


๐Ÿ‘ฅ Contributors

LenDen Team

Aaditya Jaiswar Samyak Dandge Shreyash Mane Rutuja Katagi
Core Architecture & Components Design System & UX Testing & QA Documentation & Guides
GitHub LinkedIn GitHub LinkedIn GitHub LinkedIn GitHub LinkedIn

๐Ÿ“„ License

This project is licensed under the MIT License โ€” see the LICENSE file for details.


MIT License โ€ข Copyright (c) 2025 Aaditya Jaiswar

Star Fork Issues

Built with ๐Ÿ’– by the LenDen Team | Making financial management accessible for every Indian

About

LenDen - Personal Finance Management App ๐Ÿ’ฐ ๐Ÿ“‹ Project Overview LenDen is a ๐ŸŽค voice-first personal finance management app designed specifically for low-income households in India ๐Ÿ‡ฎ๐Ÿ‡ณ. The app combines traditional PFM features with innovative ๐ŸŽฎ

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors