Skip to main content
CODE MNKY Agent

​
Technology Foundation

The MOOD MNKY ecosystem is powered by a modern, unified technology stack. A single Next.js application hosts MNKY VERSE (storefront), The Dojo (private hub), and MNKY LABZ (admin dashboard), deployed on Vercel with Supabase and Shopify integrations.
Foundation Tagline: “Developer-centric infrastructure that powers our universe.”
For design tokens, palettes, and section mapping see Design System. For route and layout architecture (Main, MNKY DOJO, LABZ) see Systems Architecture. Technical Infrastructure

​
Technology Stack

​
Frontend

  • Framework: Next.js 14+ (App Router)
  • UI: React, TypeScript, shadcn/ui, Tailwind CSS
  • E-commerce: Hydrogen React (@shopify/hydrogen-react) for Storefront API—not Remix Hydrogen

​
Backend & Data

  • Database: Supabase (PostgreSQL)
  • Auth: Supabase Auth
  • Realtime: Supabase Realtime
  • Storage: Supabase Storage

​
Integrations

  • Shopify: Storefront API (catalog, cart, checkout); Admin API (LABZ store management)
  • Notion: Sync for fragrance oils, formulas, glossary, blog posts
  • Flowise: AI orchestration and chatbots
  • OpenAI: GPT models for CODE MNKY and agents
  • ElevenLabs: Voice synthesis (optional)

​
Infrastructure

  • Hosting: Vercel (Next.js)
  • Database: Supabase (hosted PostgreSQL)
  • Theme: Liquid theme in Shopify/theme/; app extension in extensions/mood-mnky-theme/

​
Architecture Overview

mood-mnky-command/
├── apps/web/          # Single Next.js app
│   ├── (storefront)/  # MNKY VERSE routes
│   ├── dojo/          # The Dojo routes
│   └── (dashboard)/   # MNKY LABZ routes
├── Shopify/theme/     # Liquid theme
├── extensions/        # Theme app extension
└── supabase/          # Migrations, Edge Functions

​
MNKY LABZ as Backstage

MNKY LABZ is the operational face of the technology foundation. It provides:
  • Formulas, fragrance oils, glossary management
  • Shopify Admin integration
  • Notion sync
  • CODE MNKY assistant (tools for formulas, oils, glossary)
  • Platform tools (SQL editor, Flowise, funnels)
  • Verse backoffice (manga, XP, UGC)
See MNKY LABZ for details.

​
API Ecosystem

  • Storefront API: Products, collections, cart (MNKY VERSE)
  • Shopify Admin API: Products, orders, customers (LABZ)
  • Supabase: Auth, database, storage, realtime
  • Internal APIs: /api/verse/*, /api/labz/*, /api/xp/*, /api/quests/*, etc.

​
Developer Experience

  • Documentation: Mintlify (this site)
  • Monorepo: mood-mnky-command (Next.js app, Shopify theme, extensions, Supabase)
  • Local development: pnpm dev from repo root
  • Deployment: Vercel with Turborepo
MNKY VERSE Technical Architecture

​
Integration with Other Domains

  • With MNKY VERSE: Powers storefront, blog, gamification, agents
  • With The Dojo: Auth, profiles, XP, quests, Blending Lab data
  • With MNKY LABZ: Full operational toolset

MNKY LABZ

Admin dashboard and command center

Developer Resources

Get started with development

Mono-repo Structure

Repository organization

API Hub

API documentation