AY-OmoP/AjoCircle

AjoCircle is a digital re-imagining of the traditional Ajo/Esusu cooperative savings system widely practiced across Africa. Built for transparency, automation, and financial growth, AjoCircle helps groups save together, track weekly interest, and earn collectively, all inside a modern web experience. # AjoCircle — Play-to-Earn Savings Simulator A modern React-based web application for simulating and managing savings groups with interest accrual, weekly compounding, and gamified returns. Built with TypeScript, React, Tailwind CSS, and Vite. ## 🎯 Overview AjoCircle is an interactive savings group simulator that demonstrates financial concepts like: - **Principal & Interest Tracking**: Monitor each member's savings and accumulated interest - **Weekly Compounding**: Optionally compound principal with earned interest - **Tiered Savings**: Choose from 3 tiers (₦10,000, ₦20,000, ₦30,000) - **Game Mechanics**: Simulate 20% returns and distribute profits proportionally - **Member Management**: Add, simulate, and withdraw members seamlessly Perfect for educational purposes, financial literacy demonstrations, and understanding how savings groups work. --- ## 🚀 Getting Started ### Prerequisites - **Node.js** 18+ (required by the deployment workflow) - **npm** or **yarn** ### Installation 1. **Clone the repository** ```bash git clone github.com cd AjoCircle ``` 2. **Install dependencies** ```bash npm install ``` 3. **Start the development server** ```bash npm run dev ``` Open localhost in your browser. ### Build for Production ```bash npm run build ``` Output is generated in the `dist/` directory, optimized for GitHub Pages deployment. ### Preview Production Build ```bash npm run preview ``` ### Run Tests ```bash npm test ``` --- ## 📖 How to Use ### 1. **Register a Member** - Enter the member's name in the **"Name"** field - Select a savings tier: - **Tier 1**: ₦10,000 principal, 5% weekly interest - **Tier 2**: ₦20,000 principal, 10% weekly interest - **Tier 3**: ₦30,000 principal, 20% weekly interest - Click **"Add Member"** to register ### 2. **Simulate Weekly Interest** - Click **"Simulate 1 Week"** to apply weekly interest to all members - Each member earns interest based on their tier's weekly rate - …