Chit Fund Calculator & Tracker

A comprehensive web application for modeling, analyzing, and tracking Indian chit fund investments. This tool helps both organizers and participants calculate payments, dividends, and returns for each month with full flexibility.

Features

• Chit Fund Parameter Input: Configure chit value, duration, members, and commission
• Monthly Auction Management: Manual input for auction amounts with quick-fill patterns
• Automatic Calculations: Real-time calculation of commissions, dividends, installments, and discount percentages
• Analysis & Reporting: Payment schedules, scenario comparisons, and ROI analysis
• Excel Export: Export all calculations and schedules to Excel format
• Responsive Design: Works seamlessly on desktop and mobile devices

Tech Stack

• Framework: Next.js 15 with TypeScript
• Styling: Tailwind CSS
• Icons: Lucide React
• Charts: Recharts
• Excel Export: SheetJS (xlsx)
• Deployment: Vercel

Getting Started

Prerequisites

• Node.js 18+
• npm or yarn

Installation

1. Clone the repository:

git clone <repository-url>
cd chitfund

2. Install dependencies:

npm install

3. Run the development server:

npm run dev

4. Open http://localhost:3000 in your browser.

Deployment

Deploy to Vercel

1. Push your code to a Git repository (GitHub, GitLab, or Bitbucket)

2. Visit vercel.com and sign up/login

3. Click "New Project" and import your repository

4. Vercel will automatically detect it's a Next.js project and configure the build settings

5. Click "Deploy" and your application will be live!

Manual Deployment

You can also deploy using Vercel CLI:

npm install -g vercel
vercel

Usage

1. Set Parameters: Enter your chit fund's basic parameters (value, months, members, commission)
2. Configure Auctions: Input monthly auction amounts manually or use quick-fill patterns
3. Analyze Results: View payment schedules, compare scenarios, and analyze ROI
4. Export Data: Download Excel reports with all calculations

Project Structure

src/
├── app/                    # Next.js app directory
│   ├── globals.css        # Global styles
│   ├── layout.tsx         # Root layout
│   └── page.tsx           # Main page
├── components/            # React components
│   ├── AnalysisSection.tsx
│   ├── AuctionSection.tsx
│   ├── AuctionTable.tsx
│   ├── Header.tsx
│   ├── ParametersSection.tsx
│   └── PaymentScheduleModal.tsx
├── hooks/                 # Custom React hooks
│   └── useChitFund.tsx
└── lib/                   # Utility functions
    └── utils.ts

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License.