Getting Started
Project Overview
A high-level map of Urmate modules, technology stack, and workspace structure.
Project Overview
Urmate is a large Next.js platform, not a single-purpose app. It combines AI app building, LMS/study workflows, instructor marketplace tools, real-time chat, external channel automation, XRouter model routing, AI tutoring, game/code runtimes, and infrastructure management.
Main Workspaces
| Workspace | Route | What it does |
|---|---|---|
| Main dashboard | /dashboard | Projects, templates, imports, builder entry, settings, search, and help. |
| Builder | /dashboard/builder | AI-assisted app/project builder with files, terminal, runtime, preview, media, GitHub, env, and assistant support. |
| Study | /dashboard/study | Learning dashboard with library, courses, boards, instructors, podcasts, communities, progress, store, and copilot. |
| Instructor | /dashboard/study/instructor | Approved instructor workspace for profile, bookings, courses, quizzes, certificates, payouts, invoices, and disputes. |
| Study Admin | /dashboard/study/admin | Study-specific controls for resources, instructors, preferences, and Code Tutor courses. |
| Chat | /dashboard/chat | AI chat, external channels, channel agents, tasks, community marketplace, imports, and workspace modules. |
| XRouter | /dashboard/xrouter | Provider routing, OpenAI/Anthropic-compatible endpoints, quotas, media, search, proxy pools, and skills. |
| AI Tutor | /dashboard/aitutorbuddy | Lesson/page generation, critique, voice, resources, and PDF export. |
| Circles | /dashboard/circles | Social/direct chat bridge connected to Urmate auth and avatars. |
| Cloud Infrastructure | /dashboard/cloudinfrastructure | VPS relay, commands, files, ports, logs, VNC, API keys, and sandbox connections. |
| Game Builder | /dashboard/game-builder | Game projects, assets, runtime, builds, and metrics. |
| Code Tutor | /dashboard/code-tutor | Programming courses, lessons, workspaces, runtimes, progress, and AI tutor support. |
| Admin | /admin and /dashboard/admin | Platform users, projects, templates, providers, billing, reports, server, and CMS pages. |
Technology Stack
| Layer | Implementation |
|---|---|
| Web framework | Next.js 16 App Router |
| React | React 19 |
| Database | Prisma 6 with PostgreSQL |
| Auth | Better Auth |
| UI | Tailwind CSS v4, Radix UI, local components/ui/*, Lucide icons |
| AI routing | XRouter runtime with OpenAI-compatible and Anthropic-compatible APIs |
| Chat | Dashboard chat APIs, channel webhooks, Circles bridge, optional Socket.IO/Redis |
| Storage | CloudNest and provider-specific uploads |
| Payments | Razorpay, Stripe, PayPal, Google Pay configuration |
| Runtimes | Builder runtime, Game Engine runtime, Code Tutor runtime, VPS relay |
Important Folders
| Folder | Purpose |
|---|---|
app/(routes) | App Router pages for public routes, auth, dashboards, study, chat, and tools. |
app/api | Route handlers for all server APIs and webhooks. |
components | Dashboard shells, feature screens, and reusable UI primitives. |
lib | Business logic, auth helpers, Prisma access, provider integrations, runtimes, and service helpers. |
prisma/schema.prisma | Core data model. |
scripts | Dev helpers, sync jobs, migration utilities, and relay scripts. |
public | Static assets, avatars, icons, and public files. |
Current Product Status
Some modules are complete and Prisma-backed. Others depend on external setup:
- Telegram/Discord channels need a public HTTPS webhook origin.
- WhatsApp/Instagram need Meta app/business/webhook permissions.
- Google Calendar uses a separate OAuth client for instructor calendar access.
- Circles can be hosted separately, but auth/register should continue through Urmate.
- Instructor dashboard access is gated by approval, not just by login.
- XRouter Claude Code support depends on target/provider compatibility.