Mirelle — Luxury E-Commerce & Dual-App Monorepo Platform

Problem

High-end boutique luxury brands face significant operational hurdles when selling internationally: standard e-commerce templates look generic and lack dark luxury aesthetics; managing separate customer-facing stores and administrative operations creates code fragmentation; supporting trilingual RTL Arabic, Turkish, and English often breaks typography and currency alignment; and international assisted-payment flows (bank transfer verification and WhatsApp ordering) are rarely natively integrated with real-time inventory and order lifecycle state machines.

Solution

Engineered a production-ready Turborepo monorepo housing two Next.js applications (apps/storefront and apps/admin) powered by 25 shared domain packages. The platform features an exclusive 5-color dark-only luxury design system with Cairo/Noto typography and strict isolation; an assisted payment verification desk with receipt upload and automated WhatsApp routing; a dual-state order machine (order_status & payment_status); a global Digital Asset Manager with server-side Sharp validation; financial minor units (bigint) stored across 35+ relational tables; and real-time customer support ticketing.

Outcome

Achieved sub-second server-rendered page loads across both applications, 100% strict financial integrity with zero floating-point math errors, seamless trilingual RTL parity (Arabic, Turkish, English), automated Excel (.xlsx) BI reporting, and complete operational decoupling between customer shopping and back-office management.

Key Features

• •

  Dual-App Architecture: High-conversion luxury customer Storefront (Port 3000) and enterprise Admin Panel (Port 3001) in a unified Turborepo monorepo

• •

  25 Modular Shared Packages: Clean domain boundaries for catalog, cart, orders, payments, shipping, discounts, CRM, media, analytics, and reports

• •

  Dark-Only Luxury Design System: Curated 5-color palette (#130517, #1F0D25, #D9BE8D Champagne Gold) with custom shadcn primitives and Tabler icons

• •

  True Trilingual RTL Parity: Native English, Turkish, and Arabic with Cairo typography and bidirectional isolation for prices/SKUs

• •

  Assisted Payment & WhatsApp Integration: Bank transfer verification workflow with receipt upload and one-click pre-filled WhatsApp order confirmation

• •

  Two-State Order Machine: Independent lifecycles for order fulfillment (pending → delivered) and payment verification (awaiting → paid) with immutable audit events

• •

  Global Digital Asset Manager: Centralized Media Library with Sharp image validation, SHA-256 byte deduplication, and safe deletion protection

• •

  Enterprise Admin Control: Real-time BI dashboard, multi-tab product editor with publish guardrails, customer CRM, and dynamic CMS page/navigation builder

• •

  Customer Support Desk: Bi-directional real-time ticketing system with live chat between customers and administrators via Supabase Realtime

• •

  Multi-Sheet Excel BI Reporting: Formatted .xlsx financial and operational workbook generation with dark/gold executive styling via ExcelJS

Architecture

Architected as a Turborepo monorepo containing Next.js 15 App Router applications (storefront and admin) with React 19 and Tailwind CSS. The backend relies on Supabase (PostgreSQL 15+) with 65+ versioned migrations, rigorous Row-Level Security (RLS), and atomic SECURITY DEFINER RPC functions. Financial values are stored as integer minor units (bigint), assets are managed via Sharp and Supabase Storage, and client/server validation is enforced through centralized Zod schemas.

Technical Challenges

• •

  Architecting 25 shared TypeScript packages within a Turborepo monorepo to ensure zero circular dependencies and optimal tree-shaking across both Next.js apps

• •

  Enforcing strict database-level financial integrity using integer minor units (bigint) and idempotent RPC order placement functions to prevent race conditions

• •

  Building a resilient trilingual RTL architecture with automatic font switching (Cairo for Arabic, Noto Sans for Latin) and bidirectional text isolation for monetary values

• •

  Designing a two-state order lifecycle machine that cleanly decouples manual payment verification from physical fulfillment stages

• •

  Creating an enterprise Digital Asset Manager with server-side Sharp byte validation, cryptographic SHA-256 deduplication, and relational reference tracking

Key Learnings

• •

  Enterprise Monorepo Engineering: Managing Turborepo workspaces, shared design tokens, and modular domain-driven package architecture

• •

  PostgreSQL Data Modeling & Security: Writing versioned SQL migrations, atomic RPC stored procedures, and fine-grained Row-Level Security policies

• •

  Luxury E-Commerce UX & RTL Mastery: Crafting dark-mode-only aesthetics, micro-interactions, and bidirectional Arabic layout stability

• •

  Assisted Commerce Workflows: Bridging modern web checkouts with manual payment verification and WhatsApp communication channels

• •

  Full-Stack Type Safety & Performance: End-to-end validation with Zod, server-side image processing with Sharp, and multi-sheet Excel generation

Impact

Delivered an end-to-end digital flagship for luxury fragrance and wellness brands, streamlining customer acquisitions across the Middle East and Turkey while giving operations teams complete control over orders, stock, content, and financial analytics.