Transform your e-commerce vision into reality with our cutting-edge multi-seller dropshipping platform that combines the power of AI, modern web technologies, and intelligent business automation.
- Dynamic Product Variants: Each product can have multiple seller versions with custom pricing
- Seller Dashboard: Comprehensive analytics and product management tools
- Price Comparison: Buyers can compare prices across different sellers
- Verified Sellers: Trust system with seller verification and ratings
- Machine Learning Recommendations: LightFM-based recommendation engine
- Predictive Analytics: Sales forecasting and trend analysis
- Smart Pricing: Dynamic pricing optimization
- Market Intelligence: Social trend analysis and competitive insights
- Cryptocurrency Support: Bitcoin, Ethereum, and other crypto payments
- P2P Marketplace: Peer-to-peer trading capabilities
- Bybit Integration: Professional crypto trading integration
- Traditional Payments: Stripe and other payment processors
- Multi-Currency Support: Real-time exchange rate conversion
- Localization: Specialized support for Gulf markets (UAE, Saudi Arabia, Kuwait, Qatar, Bahrain, Oman)
- International Shipping: Global logistics and tracking
- Bulk Pricing: Volume discounts and wholesale pricing
- Real-Time Analytics: Live sales tracking and performance metrics
- Order Batching: Advanced order management and processing
- Inventory Management: Smart stock tracking and alerts
- Marketing Tools: Campaign management and advertising features
graph TD
A[Next.js Frontend] --> B[API Routes]
B --> C[Service Layer]
C --> D[MongoDB Database]
B --> E[Python AI Engine]
E --> F[ML Models]
C --> G[External APIs]
G --> H[Exchange Rates]
G --> I[Product Scraping]
Frontend Layer
- Next.js 15 with App Router
- TypeScript for type safety
- Tailwind CSS for responsive design
- React Context for state management
Backend Services
- 30+ Specialized Services handling different business domains
- FastAPI Python Engine for AI/ML operations
- Dynamic Service Management with health monitoring
- RESTful APIs with comprehensive endpoints
Database & Storage
- MongoDB for scalable document storage
- Optimized Collections for multi-seller architecture
- Performance Indexes for fast queries
- Analytics-Friendly data structure
- Node.js 18+
- npm 8+
- Python 3.8+
- MongoDB (local or cloud)
- Git
-
Clone the Repository
git clone https://github.com/yourusername/midostore.git cd midostore -
Install Dependencies
npm install
-
Setup Environment
cp env.example .env.local # Edit .env.local with your configuration -
Setup AI Services
npm run ai:setup
-
Initialize Database
npm run db:generate npm run db:push npm run db:seed
-
Start Development Server
npm run quick:start
Visit http://localhost:3000 to see your application running!
- API Endpoints - Complete API documentation
- Multi-Seller System - Architecture overview
- Dynamic Services - Service management guide
- WARP Integration - AI assistant guidance
- Environment Setup - Configuration guide
- Scripts Documentation - Development scripts
- Deployment Guide - Production deployment
# Development
npm run dev # Start Next.js development server
npm run quick:start # Start all services (Next.js + AI)
npm run services:start # Start dynamic services
# Building
npm run build # Production build
npm run build:deploy # Build and deploy
# Database
npm run db:studio # Open Prisma Studio
npm run db:seed # Seed with sample data
# AI Services
npm run ai:start # Start AI service
npm run ai:train # Train ML models
# Testing
npm run test:all # Run all tests
npm run test:apis # Test API endpoints
# Deployment
npm run netlify:deploy # Deploy to NetlifyThe platform is built with a service-oriented architecture:
Core Business Services:
seller-service.ts- Multi-seller managementbuyer-service.ts- Product browsing and comparisonproduct-service.ts- Product catalog managementorder-batching-service.ts- Advanced order processing
AI & Analytics:
ai-orchestrator-service.ts- Central AI decision makingrecommendation-service.ts- ML-powered recommendationsanalytics-service.ts- Business intelligencesocial-trend-analysis-service.ts- Market analysis
Payment & Financial:
crypto-payment-service.ts- Cryptocurrency processingp2p-marketplace-service.ts- P2P tradingexchange-rate-service.ts- Multi-currency support
-
Configure Environment
# Copy environment template cp netlify.env.example netlify.env -
Deploy
npm run netlify:deploy:optimized
- Direct Deployment:
npm run deploy:direct - Docker: Coming soon
- Self-hosted: Manual server deployment
# Database
DATABASE_URL=mongodb://localhost:27017/midostore
# Authentication (optional)
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_key
CLERK_SECRET_KEY=your_key
# AI Services
AI_SERVICE_URL=http://localhost:8000
# Payment Processing
STRIPE_SECRET_KEY=your_key
BYBIT_API_KEY=your_key
BYBIT_SECRET_KEY=your_key
# External APIs
EXCHANGE_RATE_API_KEY=your_keyThe platform uses dynamic service configuration:
# View current configuration
npm run services:config
# Save configuration
npm run services:status
# Generate environment template
npm run services:env-template- ✅ API Endpoints - Comprehensive API testing
- ✅ AI Systems - ML model performance testing
- ✅ Services - Individual service functionality
- ✅ Authentication - Security testing
- ✅ Integration - End-to-end workflows
# All tests
npm run test:all
# Specific test suites
npm run test:apis # API endpoints
npm run test:orchestrator # AI orchestrator
npm run test:agents # AI agents
npm run test:auth # Authentication
npm run test:scraping # Data scraping- Page Load Time: < 2 seconds
- API Response: < 200ms average
- Database Queries: Optimized with indexes
- AI Recommendations: < 500ms response time
- Multi-Service Architecture: Horizontal scaling
- Database Optimization: Indexed MongoDB collections
- Caching Strategy: Redis integration ready
- CDN Support: Static asset optimization
We welcome contributions! Please see our Contributing Guide for details.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Make your changes
- Add tests for new functionality
- Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- TypeScript: Strict type checking
- ESLint: Code quality enforcement
- Prettier: Code formatting
- Testing: Required for new features
This project is licensed under the MIT License - see the LICENSE file for details.
- Next.js Team - Amazing React framework
- MongoDB - Scalable database solution
- LightFM - Recommendation algorithm
- Tailwind CSS - Utility-first CSS framework
- FastAPI - High-performance Python web framework
- Documentation: Check our comprehensive docs above
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: support@midostore.com
- Multi-seller marketplace
- AI-powered recommendations
- Payment processing
- Gulf market localization
- Mobile applications
- Advanced analytics dashboard
- API marketplace
- Third-party integrations
- Blockchain integration
- Advanced ML features
- International expansion
- Enterprise solutions
🚀 Ready to revolutionize e-commerce?
Get Started • View Demo • Read Docs
Built with ❤️ for the future of commerce