Skip to content

Gbese-app/gbese-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

143 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gbese

Gbese is a revolutionary peer-to-peer credit transfer platform that enables users to redistribute financial obligations through consent-based debt transfers. It’s designed for people to share or relieve debts in a fair, friendly, and legally sound way.

🚀 Getting Started

Prequisite

Ensure you have the following installed on your system:

  • Node.js (v16+ recommended)
  • npm or yarn
  • Git

Startup

  1. git clone repo
  2. npm install
  3. npm run start

🏗️ Project Structure

  src/
  
  ├── components/       # Reusable UI components
  ├── pages/            # Route-based components
  ├── services/         # API calls and data fetching
  ├── utils/            # Helper functions
  ├── context/          # Global state (e.g., auth, user profile)
  ├── assets/           # Images, icons, illustrations
  └── styles/           # Global and modular CSS

🧠 Design Philosophy

Gbese’s frontend is designed to be:

  • Empathetic UI: Uses calm visuals and friendly language to handle the topic of debt.
  • Clean and intuitive: Focus on reducing friction and cognitive load.
  • Secure by design: Progressive disclosure and clear consent flows for each action.
  • Gamified motivation: Visual elements like “Debt Thermometer” and “Wealth Redistribution Index” to engage users.

🧪 Key Features & Screens

  • Onboarding & KYC
  • User Dashboard — See balance, credit, obligations
  • Send/Receive Debt — Attach debt to a transfer
  • Debt Transfer Center — Discover & accept others’ debt
  • Notifications — Alerts, approvals, insights
  • Gamification UI — Wealth Redistribution visuals
  • DAO Governance — Participate in platform decisions

🛠️ Tech Stack

  • React.js (Vite )
  • Tailwind CSS for styling
  • React Query or Axios for API handling
  • Redux for state management
  • Framer Motion for animations
  • ESLint + Prettier for consistent code style

🧩 Future Improvements

  • Integrate Web3 wallet connection (for Debt NFTs)
  • Add unit & integration tests using Jest + Testing Library
  • Mobile-first optimizations & accessibility audits
  • Internationalization (i18n) support

🤝 Contributing

Pull requests are welcome! Please open an issue first to discuss what you would like to change.

📄 License

MIT

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors