Urban Store is a complete, self-hosted e-commerce solution for urban fashion brands. It combines a Next.js 16 storefront with a Django REST Framework backend, MongoDB Atlas persistence, Stripe payment processing, and a built-in analytics dashboard — all deployable in minutes with Docker Compose.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ALEJ4NDRO2025/urban-store/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Get Urban Store running locally in under 10 minutes with Docker Compose.
Architecture
Understand the system design: frontend, backend, database, and services.
API Reference
Full REST API documentation for users, products, cart, orders, and analytics.
Admin Dashboard
Real-time sales analytics, RFM segmentation, and smart alerts.
What’s Included
Urban Store ships with everything you need to run a production urban fashion store:Product Catalog
Filterable catalog with per-variant inventory tracking (size + color).
Shopping Cart
Persistent cart with localStorage and backend sync via Zustand.
Stripe Payments
Stripe PaymentIntent flow with automatic order confirmation.
Order Management
Full order lifecycle with automatic stock restoration on cancellation.
Authentication
JWT-based auth with email verification and password reset flows.
Analytics
Conversion funnel, RFM segmentation, traffic sources, and smart alerts.
Get Started
Configure environment variables
Copy the example env files and fill in your credentials for MongoDB, Stripe, Cloudinary, and Gmail SMTP.
See the Environment Variables guide for all required keys.
Start with Docker Compose
http://localhost:3000 and the backend API on http://localhost:8000.Create your first admin user and product
Register a user, promote them to admin via MongoDB, then use the admin panel to add products. See the Product Management guide.
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | Next.js 16, React 18, Tailwind CSS, Zustand, GSAP, Three.js |
| Backend | Django 6, Django REST Framework, PyJWT, bcrypt |
| Database | MongoDB Atlas via MongoEngine |
| Payments | Stripe (PaymentIntent API, COP currency) |
| Storage | Cloudinary (product images) |
| Gmail SMTP with styled HTML templates | |
| Infrastructure | Docker Compose |
Urban Store is designed for the Colombian market — prices are in COP (Colombian Peso) and the timezone is set to
America/Bogota. These defaults can be changed in the backend settings.py.