Skip to main content

​
Dojo Platform Features

Dojo Platform Features

​
Overview

The Dojo is the members’ private hub in the MNKY VERSE. This document details the core features implemented in the current application.
The Dojo integrates with MNKY VERSE for gamification (quests, profile), shopping, and content. Future roadmap items (mood tracking, fragrance studio, wellness rituals) may expand these capabilities.

​
Implemented Features

XP & Level

Gamification progress displayed on the Dojo home. Fetches from xp_state; links to profile.

Quests

Active quests and completed count. Links to /verse/quests.

Blending Lab

Create and save custom fragrance blends. Access via Crafting context.

Saved Blends

User’s saved fragrance blends, stored in Supabase.

MNKY CHAT

Chat interface with Flowise integration. New chat, saved chats, Flowise config.

Preferences

Default agent selection and user settings.
The Dojo sidebar supports four contexts (Team Switcher):
ContextFocusNav Items
HomeDojo hubHome, MNKY CHAT, Preferences; MNKY VERSE links
CraftingBlendingBlending Lab, Saved Blends, MNKY CHAT; Glossary, Shop
VerseMNKY VERSEVerse Home, Shop, Chat, Profile, Issues, UGC; Dojo links
ChatMNKY CHATNew chat, Saved chats, Folders, Flowise config, Settings

​
Quick Actions

From the Dojo home, members can quickly access:
  • Preferences
  • MNKY VERSE Shop
  • Chat
  • Issues (manga)
  • UGC (user-generated content)

​
APIs

EndpointPurpose
GET /api/xp/stateXP and level state
GET /api/xp/awardAward XP (internal)
GET /api/xp/rulesXP rules
GET /api/questsQuests list
GET /api/quests/my-progressUser quest progress
GET /api/dojo/profileDojo profile
GET /api/dojo/musicMusic playlists

​
Auth Model

  • Required: All Dojo routes require Supabase Auth.
  • Redirect: Unauthenticated users → /auth/login.
  • RLS: Dojo data (profiles, saved_blends, xp_state, quest_progress) protected by Row Level Security.

​
Components

Key components in apps/web/components/dojo/:
  • dojo-dashboard-layout.tsx — Layout with SidebarProvider
  • dojo-sidebar.tsx — Sidebar with nav groups
  • dojo-xp-card.tsx, dojo-quests-card.tsx — Gamification cards
  • dojo-quick-actions-card.tsx — Quick action buttons
  • dojo-blending-lab.tsx, dojo-saved-blends-list.tsx — Crafting
  • dojo-chat-sidebar.tsx, dojo-flowise-chatbot.tsx — Chat
  • dojo-auth-context.tsx — Auth and redirect

Dojo Overview

Architecture and route structure

Reward System

XP, quests, and rewards design

MNKY VERSE

The web portal