Skip to main content

​
Applications Overview

The MOOD MNKY monorepo contains multiple applications, each serving a specific purpose in the ecosystem. This section provides comprehensive documentation for each application, including architecture, setup, development workflows, and deployment guides.
All applications in the monorepo share common infrastructure and follow consistent development patterns. See Monorepo Structure for details on the overall architecture.

​
Application Architecture

The MOOD MNKY ecosystem consists of several integrated applications working together:

MNKY VERSE

Central hub for the MOOD MNKY ecosystem with multi-agent interaction

TRVLR Sync

Bungie.net/Destiny 2 sync service with OAuth and manifest management

Shopify App

Shopify integration for fragrance oils and custom blend management

MNKY Agents Demo

Python FastAPI demo application for agent interactions

​
Application Comparison

ApplicationPurposeTech StackPrimary Users
MNKY VERSECentral ecosystem hubNext.js 14, React, SupabaseEnd users, Community members
TRVLR SyncDestiny 2 data syncNext.js 15, Supabase, Bungie APIGamers, Developers
Shopify AppE-commerce integrationNext.js 15, Shopify API, Notion APIOperations, Merchants
MNKY Agents DemoAgent framework demoPython, FastAPIDevelopers, AI engineers

​
Getting Started with Applications

​
For New Developers

  1. Understand the Ecosystem: Start with the Introduction to understand the Three Pillars
  2. Set Up Environment: Follow the Environment Setup Guide
  3. Choose an Application: Review application overviews to find where you want to contribute
  4. Read Application Docs: Deep dive into the specific application’s documentation
  5. Start Contributing: Follow the Contribution Guidelines

​
Common Patterns Across Applications

All applications in the monorepo share common patterns:
  • Shared Packages: Use @repo/ui, @repo/supabase-client, and shared configs
  • Consistent Structure: Follow the same directory organization patterns
  • TypeScript: All applications use TypeScript for type safety
  • Supabase Integration: Unified authentication and database access
  • Deployment: Consistent deployment workflows via Vercel

​
Application Development Workflow

​
Local Development

# Start all applications
pnpm dev

# Start specific application
pnpm --filter mnky-verse dev
pnpm --filter trvlr-sync dev
pnpm --filter shopify-app dev

​
Building Applications

# Build all applications
pnpm build

# Build specific application
pnpm --filter mnky-verse build

​
Testing Applications

# Run tests for all applications
pnpm test

# Run tests for specific application
pnpm --filter mnky-verse test

​
Integration Points

Applications integrate with each other and shared infrastructure:
  • Shared Authentication: All apps use Supabase Auth
  • Shared Database: Common Supabase database with RLS
  • Shared UI Components: @repo/ui package provides consistent design
  • API Integration: Applications consume shared APIs and services
  • Agent Framework: Applications integrate with MOOD, CODE, and SAGE agents

​
Application Comparison

ApplicationPrimary Use CaseKey TechnologiesDeployment
MNKY VERSEUser-facing hubNext.js 14, React, SupabaseVercel
TRVLR SyncGame data syncNext.js 15, Supabase Edge FunctionsVercel + Supabase
Shopify AppE-commerce integrationNext.js 15, Shopify API, Notion APIVercel
MNKY Agents DemoAgent testingPython, FastAPI, DockerDocker

​
Choosing the Right Application

​
For End Users

  • MNKY VERSE: Main interface for interacting with agents and ecosystem

​
For Developers

  • MNKY Agents Demo: Test agent interactions and develop agent features
  • TRVLR Sync: Example of OAuth integration and Edge Functions
  • Shopify App: Example of multi-API integration

​
For Operations

  • Shopify App: Manage product catalog and sync operations
  • TRVLR Sync: Monitor sync status and manifest updates