DebbsIo/SaveCircle-Frontend

SaveCircle is an open-source platform that digitizes informal savings circles (Ajo, Chama, Tanda) on the Stellar network. It eliminates fraud, automates payouts, and builds verifiable on-chain credit histories that unlock access to microloans for underserved communities globally. # SaveCircle Frontend *Save Together. Trust the Chain.* SaveCircle is an open-source platform that digitizes informal savings circles (Ajo, Chama, Tanda) on the Stellar network. It eliminates fraud, automates payouts, and builds verifiable on-chain credit histories that unlock access to microloans for underserved communities globally. ## 🚀 Features - **Group Management**: Create and join savings circles with customizable contribution schedules - **Smart Contract Integration**: Secure fund management using Stellar Soroban contracts - **On-Chain Credit Scoring**: Build portable credit scores from savings behavior - **Microloan Module**: Access loans backed by your savings history - **Mobile-First PWA**: Works offline on low-end Android devices - **Multi-Language Support**: Designed for global accessibility - **Notifications**: SMS and push notifications for reminders and updates ## 🏗️ Architecture This frontend application is built with: - **React.js**: Component-based UI framework - **Tailwind CSS**: Utility-first CSS framework - **Workbox**: Service worker for PWA offline capabilities - **Stellar SDK**: Integration with Stellar blockchain - **Progressive Web App**: Installable on mobile devices ## 📋 Prerequisites - Node.js 18+ - npm or yarn - Stellar wallet (Freighter recommended) ## 🛠️ Installation 1. Clone the repository: ```bash git clone github.com cd SaveCircle-Frontend ``` 2. Install dependencies: ```bash npm install ``` 3. Start the development server: ```bash npm start ``` 4. Open localhost in your browser. ## 📜 Available Scripts - `npm start` - Runs the app in development mode - `npm test` - Launches the test runner - `npm run build` - Builds the app for production - `npm run eject` - Ejects from Create React App (irreversible) ## 🔧 Configuration Create a `.env` file in the root directory with the following variables: ```env REACT_APP_STELLAR_NETWORK=testnet # or mainnet REACT_APP_A …