MNKY VERSE: The Web Experience
MNKY VERSE is the web experiential portal to the MOOD MNKY brand—a unified digital destination where customers explore products, engage with AI agents, read the blog, participate in gamification, and connect with the community. It is the public-facing heart of our ecosystem.MNKY VERSE Tagline: “Bespoke fragrance in the MNKY VERSE. Always scentsing the MOOD.”
Overview
MNKY VERSE is built as a Next.js application using Hydrogen React and the Shopify Storefront API. It serves as the primary customer touchpoint, complementing the Shopify store theme and providing a richer, app-based experience for exploration, shopping, learning, and community.Key Features
- Storefront & Catalog: Products and collections via Shopify Storefront API; cart and checkout powered by Hydrogen React
- MNKY VERSE Blog: Supabase-hosted blog synced from Notion; stories and content from the brand
- AI Agents Directory: Agent profiles (MOOD MNKY, CODE MNKY, SAGE MNKY) with chat interfaces
- Gamification: XP, levels, quests, and rewards tied to engagement
- Manga/Issues: Collection manga with chapters, reader, and quizzes
- Community: Community hub, UGC (user-generated content), Discord integration
- Fragrance Tools: Fragrance wheel, oils catalog, formulas library, glossary, blending guide
- Music & Voice: Background music player; optional realtime voice chat
- The Dojo: Links to the members’ private portal for preferences, Blending Lab, and saved blends
MNKY VERSE Routes
| Path | Description |
|---|---|
/verse | Portal homepage (MNKY PORTAL) |
/verse/explore | Explore page |
/verse/blog | MNKY VERSE blog |
/verse/blog/[slug] | Blog post detail |
/verse/agents | AI agents directory |
/verse/agents/[slug] | Agent profile page |
/verse/products | Product catalog |
/verse/products/[handle] | Product detail |
/verse/collections | Collections list |
/verse/collections/[handle] | Collection detail |
/verse/shop | Shop page |
/verse/cart | Shopping cart |
/verse/chat | Chat interface |
/verse/profile | User profile |
/verse/quests | Quests and gamification |
/verse/issues | Manga/issues list |
/verse/issues/[slug] | Issue detail, reader, quiz |
/verse/ugc | User-generated content |
/verse/community | Community hub |
/verse/music | Music player |
/verse/fragrance-wheel | Fragrance wheel tool |
/verse/fragrance-oils | Fragrance oils catalog |
/verse/formulas | Formulas library |
/verse/glossary | Fragrance glossary |
/verse/blending-guide | Blending guide |
Technology Stack
- Framework: Next.js 14+ (App Router) with Hydrogen React (
@shopify/hydrogen-react) - E-commerce: Shopify Storefront API (catalog, cart, checkout); not Remix Hydrogen or Oxygen
- Backend: Supabase (blog, profiles, gamification, auth)
- UI: shadcn/ui, Tailwind CSS
- Deployment: Vercel
Integration with Shopify
The Shopify Liquid theme and MNKY VERSE app share the same Shopify catalog. The theme links to MNKY VERSE for Blending Lab, Dojo, Explore, Blog, Agents, and Community. Theme app blocks (Blending CTA, Fragrance Finder, Subscription CTA) and the MNKY CHAT embed point to the app base URL.Integration with The Dojo
Authenticated users access The Dojo at/dojo—their private portal for preferences, MNKY CHAT, Blending Lab, and saved blends. The Dojo provides quick access back to MNKY VERSE (Shop, Chat, Profile, Issues, UGC).
Customer Value
- Discovery: Explore products, scents, and content in one place
- Convenience: Cart and checkout via Storefront API; seamless app experience
- Engagement: Gamification (XP, quests) and community features
- Learning: Blog, glossary, formulas, blending guide
- Personalization: Profile, saved blends, agent preferences