Skip to main content

​
Applications Overview

The mood-mnky-command monorepo contains a single Next.js application that serves three experiences: MNKY VERSE (storefront), The Dojo (private hub), and MNKY LABZ (admin dashboard). The Shopify theme and app extension complement the app.
See Monorepo Structure for the full directory layout. All three experiences share apps/web/ and deploy as one Vercel project.

​
Application Architecture

MNKY VERSE

Web experiential portal: storefront, blog, agents, gamification

The Dojo

Members’ private hub: XP, quests, Blending Lab, MNKY CHAT

MNKY LABZ

Admin dashboard: formulas, oils, Shopify, Notion, CODE MNKY

Shopify Theme

Liquid theme and app extension

​
Application Comparison

ExperiencePurposeRoutesPrimary Users
MNKY VERSEWeb portal/verse/*End users, customers
The DojoPrivate hub/dojo/*Authenticated members
MNKY LABZAdmin dashboard/, /formulas, /store/*, etc.Operations, product, dev

​
Single App, Multiple Experiences

All three experiences live in apps/web/: 
apps/web/app/
├── (storefront)/verse/   # MNKY VERSE
├── dojo/                 # The Dojo
└── (dashboard)/          # MNKY LABZ
  • MNKY VERSE: Public storefront, blog, agents, gamification
  • The Dojo: Auth-required; XP, quests, Blending Lab, chat
  • MNKY LABZ: Auth-required; formulas, fragrance oils, Shopify Admin, Notion sync, CODE MNKY

​
Other Applications (Reference)

The following applications may exist in separate repositories or as future additions:
ApplicationStatusPurpose
TRVLR SyncOptional/deprecatedBungie.net/Destiny 2 sync
Shopify AppIntegratedShopify Admin API usage is in LABZ
MNKY Agents DemoOptionalPython FastAPI agent demo

​
Getting Started

​
For New Developers

  1. Understand the Ecosystem: Start with the Introduction (Three Pillars)
  2. Set Up Environment: Follow Environment Setup
  3. Run the app: pnpm dev from repo root
  4. Explore: MNKY VERSE at /verse, Dojo at /dojo, LABZ at /

​
Local Development

# Start development server (runs apps/web)
pnpm dev

# Build
pnpm build
App runs at http://localhost:3000. MNKY VERSE: /verse; Dojo: /dojo; LABZ: /.

​
Deployment

  • Vercel: Root directory set to apps/web; Turborepo build from repo root
  • Environment variables: Supabase, Shopify, optional Notion/OpenAI