Logisticore is a revolutionary logistics platform connecting Nigerian customers and businesses with verified delivery companies through a seamless, transparent marketplace. Tired of unreliable deliveries, hidden fees, and poor tracking? Logisticore solves these problems with real-time price comparison, instant booking, and comprehensive tracking - all in one beautiful app.
Built for Nigeria's booming e-commerce market (valued at ₦3 trillion+), Logisticore leverages modern tech to deliver smarter, faster, and more reliably.
- Real-time Price Comparison - Compare quotes from multiple verified delivery companies
- Instant Booking - Book deliveries with Paystack integration (Pay Now / Cash on Delivery)
- Live Tracking - Real-time GPS tracking with status updates
- Transparent Pricing - No hidden fees, dynamic pricing based on weight/distance
- Multiple Payment Options - Secure payments with Nigeria's leading gateways
- New Customer Pipeline - Access verified orders matching your service areas
- Automated Order Management - Accept/reject orders via intuitive dashboard
- Flexible Pricing Rules - Set base rates, weight surcharges, peak hour pricing
- Real-time Payouts - Weekly settlements to your Nigerian bank account
- Analytics Dashboard - Track performance, earnings, and customer ratings
- Modern Glassmorphism UI - Built with React 18, Tailwind CSS, Lucide React
- RESTful API - Node.js/Express backend with MongoDB
- TypeScript - Fully typed frontend and backend
- Responsive Design - Perfect on mobile, tablet, desktop
- Real-time Updates - WebSocket-ready architecture
- Admin Dashboard - Complete order and company management
Frontend:
├── React 18
├── Tailwind CSS 3.x
├── Lucide React Icons
├── React Router 6
├── Axios
└── Vite (Build Tool)
Backend:
├── Node.js 18 + Express
├── MongoDB + Mongoose
├── TypeScript
├── Paystack Integration
├── JWT Authentication
└── Nodemon (Development)
Database:
├── MongoDB (Primary)
├── Indexes for performance
└── Schemas for Orders, Companies, Users
| Delivery Selection | Order Tracking | Company Onboarding |
|---|---|---|
- Node.js 18+
- MongoDB 6+ (or MongoDB Atlas)
- Paystack Account (Sandbox for development)
# Clone the repository
git clone https://github.com/yourusername/logisticore.git
cd logisticore
# Frontend
cd client
npm install
npm run dev
# Backend (new terminal)
cd server
npm install
cp .env.example .env
npm run dev
Server (.env)
MONGODB_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret
PAYSTACK_SECRET_KEY=sk_test_your_paystack_secret
PORT=5000
Client (.env)
VITE_API_URL=http://localhost:5000/api
VITE_PAYSTACK_PUBLIC_KEY=pk_test_your_paystack_public
logisticore/
├── client/ # React Frontend
│ ├── src/
│ │ ├── components/
│ │ ├── pages/
│ │ ├── utils/
│ │ └── types/
├── server/ # Node.js Backend
│ ├── src/
│ │ ├── controllers/
│ │ ├── models/
│ │ ├── routes/
│ │ ├── middleware/
│ │ └── utils/
└── README.md
1. Create Order → 2. Compare Companies → 3. Book & Pay → 4. Track Live → 5. Delivery Complete
1. Onboard → 2. Set Pricing → 3. Receive Orders → 4. Update Status → 5. Get Paid
- Transaction Fees: 5-10% commission per delivery
- Premium Listings: Delivery companies pay for priority placement
- API Subscriptions: E-commerce integration (future)
- Value-Added Services: Insurance, express delivery upsells
Nigeria Logistics Market: ₦3 Trillion+ (2025)
E-commerce Growth: 25% CAGR
Last-mile Delivery: 60% of total logistics cost
Urban Population: 50%+ by 2025
- Customer order creation
- Delivery company comparison
- Paystack payment integration
- Real-time order tracking
- Company onboarding
- Driver mobile app
- Admin dashboard
- Push notifications
- Analytics & reporting
- E-commerce API
- Cross-border delivery
- Insurance partnerships
- AI route optimization
- JWT Authentication
- Input validation & sanitization
- Rate limiting
- HTTPS enforced
- GDPR/Nigeria Data Protection compliant
- Secure payment handling
- Massive Market: 200M+ population, ₦3T+ logistics spend
- E-commerce Boom: Jumia, Konga, Opay driving demand
- Urbanization: 50%+ urban population by 2025
- Mobile Penetration: 85% smartphone adoption
- Young Population: Tech-savvy millennials driving change
- Issues: Create GitHub Issue
- Discord: Join our developer community
- Email: hello@logisticore.com
This project is MIT licensed - free for personal & commercial use.
- Fork the repository
- Create feature branch (
git checkout -b feature/amazing-feature) - Commit changes (
git commit -m 'Add amazing feature') - Push to branch (
git push origin feature/amazing-feature) - Open Pull Request
Give a ⭐ if this project helped you!
Built with ❤️ for Nigeria's logistics revolution
Logisticore - Delivering Nigeria's Future 🚀