A modern peer-to-peer marketplace connecting buyers and sellers across Africa

Asso is a mobile-first e-commerce platform designed specifically for the African market, enabling individuals to buy and sell pre-owned and new items directly with each other. Inspired by successful C2C marketplaces, Asso creates a trusted community where users can discover unique items, declutter their homes, and practice sustainable consumption.

• Easy Listing Creation - Upload photos, add descriptions, and set prices in minutes
• Secure Payments - Integrated payment processing with local payment methods
• Shipping Solutions - Flexible shipping options including meetup and delivery
• Analytics Dashboard - Track views, likes, and sales performance
• Seller Rating System - Build reputation through verified transactions

• Smart Search & Filters - Find exactly what you're looking for with advanced filters
• Secure Transactions - Payment protection and buyer guarantee
• In-App Messaging - Communicate directly with sellers
• Wishlist & Notifications - Save items and get alerts on price drops
• Review System - Make informed decisions with community reviews

• Multi-Currency Support - Transact in local currencies across different African countries
• Mobile Money Integration - Support for popular mobile payment platforms
• Multi-Language Support - Available in English, French, and local languages
• Verification System - ID verification for enhanced trust and safety
• Community Guidelines - Clear policies ensuring safe and fair transactions

• Frontend: React Native / Flutter
• State Management: Redux / Provider
• Authentication: Firebase Auth / Custom JWT

• API: Node.js with Express / Python with FastAPI
• Database: PostgreSQL with Redis caching
• Storage: AWS S3 / Cloudinary for media files
• Search: Elasticsearch / Algolia

• Hosting: AWS / Google Cloud Platform
• CDN: CloudFront / Cloudflare
• Monitoring: Sentry, New Relic
• CI/CD: GitHub Actions / GitLab CI

node >= 16.x
npm >= 8.x
react-native-cli >= 2.x

1. Clone the repository

git clone https://github.com/yourusername/asso.git
cd asso

2. Install dependencies

npm install

3. Set up environment variables

cp .env.example .env
# Edit .env with your configuration

4. Run the development server

# For iOS
npm run ios

# For Android
npm run android

Create a .env file in the root directory:

API_URL=https://api.asso.com
PAYMENT_GATEWAY_KEY=your_key_here
FIREBASE_CONFIG=your_config_here
AWS_S3_BUCKET=your_bucket_name

asso/
├── src/
│   ├── components/      # Reusable UI components
│   ├── screens/         # App screens
│   ├── navigation/      # Navigation configuration
│   ├── services/        # API and external services
│   ├── store/           # State management
│   ├── utils/           # Helper functions
│   └── assets/          # Images, fonts, etc.
├── android/             # Android native code
├── ios/                 # iOS native code
└── tests/               # Test files

API documentation is available at https://api.asso.com/docs

Key endpoints:

• POST /api/auth/register - User registration
• POST /api/listings - Create new listing
• GET /api/listings - Browse listings
• POST /api/transactions - Process transaction
• GET /api/users/:id - User profile

We welcome contributions from the community! Please read our Contributing Guidelines before submitting pull requests.

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

Security is a top priority. If you discover a security vulnerability, please email [email protected] instead of using the issue tracker.

• Launch in 5 African countries (Q1 2025)
• Implement AI-powered product recommendations
• Add live chat support
• Introduce subscription tiers for power sellers
• Expand to 15+ countries (Q4 2025)
• Launch web platform

• Documentation: docs.asso.com
• Email: [email protected]
• Twitter: @AssoAfrica
• Discord: Join our community

This project is licensed under the MIT License - see the LICENSE file for details.

• Thanks to all our contributors and early adopters
• Inspired by the circular economy movement
• Built with love for Africa 🌍

Made with ❤️ by the Asso Team