🚚 No-Wheels – 10 Minute Delivery Backend
Backend system for a hyperlocal e-commerce delivery platform that delivers daily essentials in under 10 minutes. No-Wheels powers a real-time delivery workflow similar to Blinkit / Zepto / Swiggy Instamart – from user ordering to rider assignment and order tracking.
⚡ What is No-Wheels? No-Wheels is the backend engine for a hyperlocal quick-commerce platform where users can: Browse daily essentials Place instant orders Get matched with nearby delivery partners Receive products within 10 minutes Built with performance, modularity, and scalability in mind.
🧩 Core Features User Side User authentication (JWT) Product listing & categories Add to cart Place orders Live order status Admin Side Manage products & inventory Manage users Order management Delivery partner assignment Super Admin Platform-level controls Admin creation Analytics access System configurations
🛠 Tech Stack Python 3.13 Flask Flask-SQLAlchemy Alembic (DB Migrations) JWT Authentication PostgreSQL / SQLite REST APIs
🗂 Project Structure no-wheels/ │ ├── app.py # App entry point ├── model.py # Database models │ ├── routes/ │ ├── user_routes.py # User APIs │ ├── admin_routes.py # Admin APIs │ └── super_adminRoutes.py │ ├── utils/ │ ├── config.py # Environment config │ ├── extensions.py # DB, JWT, etc │ └── middlewares.py # Auth & guards │ ├── migrations/ # Alembic migrations ├── requirements.txt └── README.md
⚙️ Setup & Installation
-
Clone the repo git clone https://github.com/addityaasharma/no-wheels.git cd no-wheels
-
Create virtual environment python -m venv venv
Activate: Windows venv\Scripts\activate
Mac/Linux source venv/bin/activate
-
Install dependencies pip install -r requirements.txt
-
Create .env DATABASE_URL=sqlite:///app.db SECRET_KEY=super-secret-key JWT_SECRET=jwt-secret-key
-
Run migrations alembic upgrade head
-
Start server python app.py
Server: http://localhost:5000
🔄 Typical Order Flow User logs in User adds items to cart User places order Admin dashboard receives order Delivery partner assigned Order status updated in real-time Delivered in under 10 minutes
🚀 System Design Goals This backend is designed to support: High concurrent users Fast API response Scalable delivery workflow Modular service structure Easy microservice split later
🧠 Why the name "No-Wheels"? Because the system focuses on delivery logic, routing, and orchestration – not frontend fluff. The wheels (riders) are abstracted. The intelligence is in the backend.
🛣 Roadmap Real-time tracking (WebSockets) Redis for cart & sessions Payment gateway integration Rider location system ETA prediction Push notifications Docker & CI/CD Microservices split (Orders, Users, Inventory)
📦 Future Scale Vision Designed to evolve into: Multi-city delivery Multiple warehouses Smart rider allocation AI-based demand prediction 1M+ users architecture
👨💻 Author Aditya Sharma Backend & Systems Engineer Building real-world delivery infrastructure.
⭐ Support If this project helps you understand how real quick-commerce systems work, consider giving it a ⭐ on GitHub.
This backend is not a toy. It’s a mini Blinkit in the making.