Koomand is an innovative delivery application specifically designed for the Mauritanian market, connecting customers, merchants, and drivers in an integrated tripartite system. The app features a user-friendly interface and high performance even with limited internet connectivity.
- Multi-language support (Arabic, French, English)
- Full RTL support for Arabic
- Offline mode detection
- Responsive design for all device sizes
- Dark/Light theme support
- Multi-option login system (phone number, email, Google accounts)
- Smart map-based location selection with saved favorite addresses
- Store browsing with advanced filters (distance, ratings, cuisine type)
- Smart shopping cart with product suggestions and promotions
- Live tracking showing driver location and estimated arrival time
- 5-star rating system with comment and photo upload options
- Multiple payment methods (cash, PayTech, credit cards)
- Comprehensive merchant dashboard
- Administrative panel for system management
- Next.js 15.2.0
- TypeScript
- Tailwind CSS
- shadcn/ui components
- i18next for internationalization
- React Co 8395 ntext API for state management
- Mapbox (planned) for location services
- Node.js (v18 or later recommended)
- Bun package manager
- Clone the repository
git clone <repository-url>
cd koomand- Install the dependencies
bun install- Start the development server
bun run dev- Open http://localhost:3000 in your browser to see the result.
koomand/
├── public/ # Public assets
├── src/
│ ├── app/ # Next.js app router
│ ├── components/ # Reusable components
│ ├── contexts/ # React context providers
│ ├── i18n/ # Internationalization config and translations
│ │ └── locales/ # Language translation files
│ ├── lib/ # Utility functions
│ └── types/ # TypeScript type definitions
└── README.md # Project documentation
The application supports three languages:
- English (default)
- Arabic (with RTL support)
- French
Language files are located in src/i18n/locales/ directory.
The application includes full Right-to-Left (RTL) support for the Arabic language. This is managed through the LanguageContext which sets the document direction based on the selected language.
Koomand is designed to function with weak internet connectivity. The application includes an offline mode indicator that appears when the device loses internet connection.
- Implement authentication system with multiple login options
- Create map integration with Mapbox for location selection and tracking
- Develop customer app flow
- Design merchant dashboard
- Build driver interface
- Create admin panel
For questions or support, please contact the development team at example@koomand.com.