Shop Microservers is a production-ready e-commerce reference architecture built entirely on microservices. Four independent Node.js/TypeScript services — authentication, product catalog, shopping cart, and order processing — sit behind an Nginx API gateway, with a Next.js 15 frontend as the user interface. The whole stack spins up with one command using Docker Compose.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/astrxnomo/shop-microservers/llms.txt
Use this file to discover all available pages before exploring further.
Quickstart
Get the full stack running locally in under five minutes
Architecture
Understand how the services, gateway, and databases connect
API Reference
Explore every endpoint across all four microservices
Configuration
Configure environment variables, ports, and secrets
What’s inside
Auth Service
JWT-based registration and login backed by PostgreSQL
Catalog Service
Product listing and stock management with auto-seeding
Cart Service
Ephemeral per-user cart stored in Redis with 7-day TTL
Orders Service
Transactional checkout: verify stock, persist order, clear cart
Nginx Gateway
Single entry point routing all traffic to upstream services
Next.js Frontend
App Router SPA communicating exclusively through the gateway
Getting started
Set up environment variables
.env and set a strong JWT_SECRET. All other defaults work out of the box.Start the stack
Open the app
Navigate to http://localhost in your browser. The catalog is pre-seeded with 12 products — register an account and start shopping.
Tech stack
| Layer | Technology |
|---|---|
| Backend services | Node.js, TypeScript, Express, Prisma |
| Frontend | Next.js 15, React 19, Tailwind CSS, Radix UI |
| Databases | PostgreSQL 16 (catalog, orders — shared by auth and orders), Redis 7 (cart) |
| Gateway | Nginx |
| Orchestration | Docker Compose |