Tontineo App Website

About the Project

Tontineo App is a platform designed to facilitate the management of tontines, a traditional rotating savings and credit association common in Africa. It empowers users to create and join tontine groups, contribute funds, track contributions, request loans, and manage group operations effectively.

Key Features

  • Group Creation and Management:
    • Tontine leaders can create new groups, set rules, and schedule reminders.
    • Members can join groups, view group details, and contribute funds.
  • Contribution Management:
    • Leaders and members can contribute money, view contribution histories, and receive notifications.
  • Loan Management:
    • Members can submit loan requests, specifying purpose and amount.
    • Leaders can review and accept loan requests.
  • Cash Management:
    • Leaders can record cash contributions and initiate withdrawal requests.
  • User Profiles:
    • Users can view their personal profiles, including contribution details.

Technologies Used

  • Frontend: React, Vite
  • Backend: Node.js, Express
  • Database: PostgreSQL
  • Deployment: Coolify (self-hosted platform for managing servers and applications)

User Stories

See the user_stories.md file for a detailed breakdown of user stories for both leaders and members.

Getting Started

  1. Clone the repository: git clone https://github.com/samsonroyal/tontineo-landingpage.git
  2. Install dependencies: npm install
  3. Set up Coolify (refer to Coolify documentation)
  4. Start the development server: npm run dev

Contributing

We welcome contributions! Please see the CONTRIBUTING.md file for guidelines.

License

This project is licensed under the MIT License.

Additional Information