One Product. 27 Repositories. Zero Chaos.
People ask how Arcanea can be a chat app, a framework, an academy, a music label, and an open-source ecosystem all at once. The answer is architecture.
Every repository in the Arcanea ecosystem serves one of six layers. Each layer is independent but connected. Nothing is monolithic. Everything is composable.
The Six Layers
Layer 1: Chat and Imagine **What it does:** The creation surface. Talk to 16 specialized AI intelligences, generate images, write stories, compose music.
Repositories: - `arcanea-ai-app` — The Next.js 16 web platform at arcanea.ai - `arcanea-companion` — Standalone Luminor chat application - `arcanea-infogenius` — Visual intelligence generation via MCP
Layer 2: Worlds **What it does:** The framework for building your own fantasy universe. Gates for progression, Archetypes for characters, Elements for systems.
Repositories: - `arcanea-soul` — Core world-building primitives (Gates, Elements, Guardians) - `arcanea-mcp` — Model Context Protocol server for world generation - `arcanea` — The open-source framework itself
Layer 3: Feed **What it does:** See what other creators build. Share your worlds. Discover new universes in the multiverse.
Built into: `arcanea-ai-app` (Gallery, Discover, Community pages)
Layer 4: OSS **What it does:** The open ecosystem. Fork it, extend it, build on it.
Repositories: - 35 npm packages across 13 package directories - 54 Claude Code skills for agent automation - 5 overlay packages (Claude, ChatGPT, Gemini, Copilot, OpenCode)
Layer 5: Community **What it does:** Not just users. Co-creators who contribute lore, agents, skills, code, and art.
Built into: arcanea-ai-app + GitHub repos + Discord
Layer 6: Academy **What it does:** Learn world-building, prompt craft, agent design. 190K+ words of reference material.
Repositories: - `book/` directory — 17 collections, 50+ wisdom texts - Academy routes in `arcanea-ai-app` — 5 courses, 20+ lessons, 10 interactive Gates
The Data Flow
``` User creates in Chat ↓ AI processes via Vercel AI SDK + Gemini/Claude ↓ Creation saved to Supabase (creations table) ↓ Appears in Gallery/Feed for community ↓ Reading progress tracked per user ↓ Gate progression unlocked based on activity ↓ New intelligences available at higher Gates ```
The Package Architecture
Every npm package follows the same pattern: small, typed, tested, composable.
| Package | Purpose | Tests |
| `@arcanea/os` | Intelligence engine, routing, voice | 44 |
| `@arcanea/cli` | 10 commands, terminal interface | 137 |
| `@arcanea/mcp-server` | 30 tools, 7 resources | 16 |
| `@arcanea/auth` | Supabase integration | 44 |
| `@arcanea/extension-core` | Browser/IDE shared lib | 112 |
| 5 Overlay packages | Agent harness overlays | 314 |
Total: 791 tests, 0 failures. All ready for npm publish.
Why This Architecture
Most AI products are closed boxes. You use them or you leave.
Arcanea is designed so every layer can be used independently. You can use the chat without caring about world-building. You can use the framework without ever visiting arcanea.ai. You can install one overlay without touching the rest.
But when you combine them, something emerges that no single layer provides alone: a creative superintelligence that knows your world, remembers your journey, and grows with you.
Getting Involved
- **Use it:** arcanea.ai
- **Build on it:** github.com/frankxai/arcanea
- **Install the CLI:** `npx @arcanea/cli`
- **Add to your agent:** `npx @arcanea/mcp-server`
The ecosystem is open. The architecture is modular. The invitation is permanent.