Multi-Tenant E-commerce Platform

Built using a microservices architecture and Turborepo for monorepo management.

Project Structure

Applications (/apps)

• api-gateway: Central API Gateway for routing and request management
• auth-service: Authentication and authorization service with JWT
• storefront: Customer-facing Next.js application
• vendor-dashboard: Vendor management dashboard
• vendor-service: Vendor profile and business logic management
• user-service: User account and profile management
• upload-service: File upload and media management
• product-service: Product catalog and inventory management
• order-service: Order processing and fulfillment
• payment-service: Payment processing and transaction handling
• cart-service: Shopping cart management and persistence

Shared Packages (/packages)

• @repo/ui: Shared UI components library with Tailwind CSS
• @repo/shared-server: Common server utilities and configurations
• @repo/eslint-config: Centralized ESLint configurations
• @repo/typescript-config: TypeScript configurations for the monorepo
• @repo/types: Shared TypeScript type definitions
• @repo/shared-client: Common utilities and helper functions
• @repo/messaging: RabbitMQ message broker integration
• @repo/redis: Redis client configuration and utilities
• @repo/email: Email service templates and sending logic

Technology Stack

Frontend

• Next.js 15
• React 19
• Tailwind CSS v4
• TypeScript

Backend

• Express.js
• Drizzle ORM
• PostgreSQL - Primary database

Infrastructure & DevOps

• Docker
• Turborepo
• PNPM
• Redis
• RabbitMQ
• MinIO - S3-compatible object storage
• MailHog - Email testing in development

Analytics

• PostHog

Development Tools

• ESLint & Biome - Code linting and formatting
• Vitest - Unit testing framework
• TSup - TypeScript bundler

Getting Started

1. Install dependencies:

   pnpm install

2. Start infrastructure services:

   ./scripts/start-services.sh
   # or
   docker-compose -f docker-compose.dev.yml up -d

3. Start development servers:

   pnpm dev

4. Stop infrastructure services:

   ./scripts/stop-services.sh

Development

• Build all packages: pnpm build
• Lint code: pnpm lint
• Type checking: pnpm check-types
• Run tests: pnpm test
• Format code: pnpm format

Scripts & Management

• pnpm db: Database management utility
• scripts/start-services.sh: Start infrastructure services
• scripts/stop-services.sh: Stop infrastructure services
• docker-compose.dev.yml: Development infrastructure configuration