Yugma Platform
Yugma is an AI-native 3D studio — a professional web-based scene editor where natural language is the primary interface. Users describe what they want ("build a sci-fi hangar with neon lighting"), and an AI Director composes the scene using structured tool calls against a live Three.js scene graph.
The product is NOT a 3D editor with AI bolted on. It is an AI-native scene graph that happens to render in 3D.
Platform Overview
| Service | URL | Purpose |
|---|---|---|
| Studio App | yugmastudio-app.web.app | 3D scene editor with AI composer + real-time collaboration |
| Admin Panel | admin.yugma.studio | User management, provider config, usage stats |
| Documentation | docs.yugma.studio | This site |
| Landing Page | yugma.studio | Marketing site |
Tech Stack
| Layer | Technology |
|---|---|
| Frontend | React 18, TypeScript, Vite |
| 3D Engine | Three.js via React Three Fiber + Drei |
| State | Zustand (14 stores) |
| AI | Anthropic Claude API (agentic tool-use loop) |
| 3D Generation | Meshy.ai API (text-to-GLB) |
| Auth | Firebase Auth (email/password + Google OAuth) |
| Database | Firestore + Realtime Database |
| Storage | Firebase Cloud Storage |
| Functions | Firebase Cloud Functions v2 (Node 20), 14 deployed |
| Hosting | Firebase multi-site hosting |
What Makes Yugma Different
-
Agentic AI loop — The AI calls tools, sees results (including generated IDs), and chains up to 8 dependent operations per turn. It builds coherent scenes, not random objects.
-
45 tokens/object — The custom YSL serialization format fits a 50-object scene in ~2,400 tokens, letting the AI maintain full scene awareness.
-
Client-side spatial intelligence — Circle, grid, stack, spiral, and scatter patterns are computed with real trig, not hallucinated by the LLM.
-
16-phase roadmap — From scene editing (live) through digital twins, physics simulation, video reconstruction, and cinematic rendering (scaffolded).
Quick Links
- System Architecture — How everything fits together
- AI Pipeline — The 6-stage AI composition flow
- Phase Roadmap — All 16 phases with status
- AI Composer Guide — Using the AI chat interface
- Cloud Functions API — Backend reference
- Deployment — Build, deploy, and configure