Lumière — Premium DTC Ecommerce
Full-stack premium ecommerce platform with a NestJS API (PostgreSQL, Redis, JWT auth, RBAC, Cloudinary, analytics) and a Next.js 16 storefront + admin dashboard featuring Zustand state management, light/dark mode, and recharts analytics.
- Role
- Solo Developer
- Timeline
- Active Development
- Status
- Production
Result Fully functional ecommerce platform with admin dashboard, real-time inventory, and sales analytics
1 / 11
Overview
A modern direct-to-consumer ecommerce platform built from scratch. Features a polished customer storefront (product browsing, cart, checkout, order history) alongside a full admin dashboard for managing products, inventory, orders, customers, and sales analytics — all backed by a production-hardened NestJS API with PostgreSQL, Redis, JWT auth, and Cloudinary image uploads.
The problem
Build a production-grade ecommerce platform with separate customer and admin experiences, real-time inventory management, guest-to-authenticated cart merging, and actionable sales analytics — all with a premium design system.
The solution
Monorepo with NestJS backend (TypeORM + PostgreSQL for persistence, Redis for cart sessions, JWT + RBAC for auth) and Next.js 16 App Router frontend (Zustand stores, Tailwind v4, framer-motion). Admin dashboard and storefront share the same API but with role-gated access.
Process
- Infrastructure & Setup: Configured the monorepo architecture and Docker environments for PostgreSQL and Redis.
- Auth & Backend Modules: Implemented rigid JWT authentication alongside RBAC gates and engineered the core 8 feature modules.
- State Management & Cart Logic: Built the client-side Zustand stores and managed complex guest-to-user cart sessions via Redis.
- Analytics & Frontend Build-out: Iteratively designed 10+ storefront pages, 7 admin pages, and integrated data visualizations using Recharts.
What I learned
-Session Merging: Guest-to-authenticated cart merging requires precise handling of TTL configurations and active stock validation.
- Concurrency Protection: Applying transactional stock deduction with pessimistic locking is essential to successfully prevent overselling.
- Upfront Specifications: Establishing a meticulous design and API spec early on drastically streamlines frontend implementation.
Features
- JWT authentication with strict Role-Based Access Control (RBAC).
- Redis-backed high-performance cart (handles both guests and users).
- Transactional checkout with robust stock deduction algorithms.
- Cloudinary cloud integration for responsive media and image uploads.
- Interactive sales analytics (revenue mapping, top sellers, category breakdown).
- Comprehensive admin dashboard to manage products, inventory, orders, and customers.
Results
- Successfully engineered a production-hardened API layer protected by Helmet, CORS, and rate-limiting.
- Developed 17+ distinct responsive client pages with built-in dark/light modes.
- Maintained clean version history across 29 focused commits with graceful shutdown logic.
My contribution
- Formulated end-to-end API design and mapped structural PostgreSQL database schemas.
- Built out the entire state architecture and component logic on the frontend.
- Handled application deployment configurations, security protocols, and data seeding scripts.