Agentic business runtime.
Users. Content. Products. Payments. Intelligence. Five primitives for humans and agents, one deployment, one runtime.
RevealUI is an open-source runtime that ships the business logic layer every software product needs: auth, content, products, billing, and AI agents. Pre-wired and development-hardened. You start on day one with a running business. Your agents start on day one with a runtime they can operate on. Same permissions, same API, same data model.
npx create-revealui my-business
cd my-business
pnpm devOpen http://localhost:4000/admin.
You have:
- User accounts: sign up, sign in, password reset, sessions, RBAC, rate limiting, brute force protection
- Content management: define collections in TypeScript, get a full REST API, admin UI, and MCP tools instantly
- Billing: Stripe checkout, subscriptions, trials, webhooks, grace periods, and a billing portal
- Admin dashboard: manage users, content, billing, and settings out of the box
- 57 UI components: built with Tailwind CSS v4, zero external UI dependencies
- 13 MCP servers: agents discover and use your business data through the same API humans use
- Type-safe throughout: Zod schemas shared between client, server, database, and agent tools
No assembly required. Define your data once. Humans manage it through the dashboard, agents operate on it through MCP. Same permissions, same audit trail.
| Primitive | For you | For your agents |
|---|---|---|
| Users | Session auth, RBAC + ABAC, rate limiting, GDPR compliance | Same RBAC governs agent access. Every action auditable. |
| Content | Collections, rich text (Lexical), media, draft/live, REST API | Collections auto-exposed as MCP tools. No integration step. |
| Products | Product catalog, pricing tiers, usage tracking | Feature gates control which agent capabilities unlock. |
| Payments | Stripe checkout, subscriptions, webhooks, billing portal | x402 micropayments via RevealCoin. Agents transact natively. |
| Intelligence | AI agents, open-model inference, task history (Pro) | A2A protocol, CRDT memory, 13 MCP servers. |
Six principles that give you a tested starting point for every architectural decision. Not the only way, a way that works. Evolve it as you grow:
| Principle | What it means |
|---|---|
| Justifiable | Every default earns its place. No magic, no hidden complexity, no decisions you can't explain to your team. |
| Orthogonal | Clean separation of concerns across 25 packages. Use what you need, replace what you don't. Zero circular dependencies. |
| Sovereign | Your infrastructure, your data, your rules. Deploy anywhere. Fork anything. No vendor holds your business hostage. |
| Hermetic | Auth doesn't leak into billing. Content doesn't tangle with payments. Sealed boundaries, clean contracts between every layer. |
| Unified | One Zod schema defines the truth. Types, validation, and API flow from database to server to UI with zero drift. |
| Adaptive | AI agents, MCP servers, and workflows are built into the foundation. Open-model inference, sovereign by design, evolving with your business. |
RevealUI is the runtime at the center of a four-project ecosystem:
| Project | Purpose | License |
|---|---|---|
| RevealUI | Agentic business runtime (this repo) | MIT + Commercial |
| RevVault | Age-encrypted secret vault (Rust CLI + desktop) | MIT + Pro |
| RevKit | Portable dev environment toolkit (WSL, Docker) | MIT + Max |
| RevealCoin | Solana token for x402 agent micropayments | Forge |
Each project stands alone. Together, they cover the full lifecycle of building, securing, coordinating, and monetizing software, for you and for your agents.
Add a collection. Get an API, admin UI, MCP tool, and TypeScript types, automatically.
import { defineCollection, defineField } from "@revealui/core";
const Products = defineCollection({
slug: "products",
fields: [
defineField({ name: "name", type: "text", required: true }),
defineField({ name: "price", type: "number" }),
defineField({ name: "description", type: "richText" }),
defineField({
name: "status",
type: "select",
options: ["draft", "active"],
}),
defineField({ name: "owner", type: "relationship", relationTo: "users" }),
],
access: {
read: ({ req }) => !!req.user,
create: ({ req }) => req.user?.role === "admin",
},
});GET /api/products is live. The admin UI is live. The MCP tool is discoverable. The TypeScript types are generated. Humans manage products through the dashboard. Agents query and create through the same API.
The Pro tier adds AI agents and automation that work on your behalf:
- AI agent system (beta — works in staging, production usage is early): build and deploy purpose-built agents for your workflows
- MCP framework: hypervisor, adapter framework, and tool discovery for connecting agents to external services
- Open-model inference: Ubuntu Inference Snaps (recommended), Ollama, and open source models via the RevealUI harness.
sudo snap install nemotron-3-nanofor instant local AI. No proprietary APIs, no vendor lock-in, zero API bills - Task history: every agent action logged, auditable, and visible in the dashboard
- Editor config sync: generate and sync settings for Zed, VS Code, Cursor, and Antigravity
Pro packages are source-available under the Functional Source License (FSL-1.1-MIT). You can read, modify, and self-host. The license converts to MIT after 2 years. Install with pnpm add @revealui/ai.
| Tier | Price | What you get |
|---|---|---|
| Free | $0 | Full OSS core: users, content, products, payments, admin |
| Pro | $49/mo | Studio desktop app, AI agents, MCP framework, open-model inference, advanced sync, RevVault desktop + rotation engine |
| Max | $149/mo | Full AI memory, audit log, higher limits, RevKit environment provisioning |
| Forge | $299/mo | Multi-tenant, SSO (planned — #449), domain-locked, RevealCoin x402 agent payments |
| App | Framework | Purpose |
|---|---|---|
api |
Hono | REST API with OpenAPI + Swagger |
admin |
Next.js 16 | Admin dashboard + content management |
docs |
Vite + React | Documentation site |
marketing |
Next.js | Marketing site + waitlist |
studio |
Tauri 2 + React | Native AI experience: agent coordination hub, local inference management, visual agent dashboard |
terminal |
Go (Bubble Tea) | TUI client (API integration, QR checkout) |
revealcoin |
Next.js | RevealCoin token explorer (experimental) |
| Package | Purpose |
|---|---|
@revealui/core |
Runtime engine, REST API, auth, rich text, plugins |
@revealui/contracts |
Zod schemas + TypeScript types (single source) |
@revealui/db |
Drizzle ORM schema (81 tables), dual-DB client |
@revealui/auth |
Session auth, password reset, rate limiting |
@revealui/presentation |
57 UI components (Tailwind v4, zero ext deps) |
@revealui/openapi |
OpenAPI route helpers and Swagger generation |
@revealui/router |
Lightweight file-based router with SSR |
@revealui/config |
Type-safe environment configuration |
@revealui/utils |
Logger, DB helpers, validation |
@revealui/cli |
create-revealui scaffolding tool |
@revealui/setup |
Environment setup utilities |
@revealui/sync |
ElectricSQL real-time sync (experimental) |
@revealui/cache |
CDN config, edge cache, ISR presets |
@revealui/resilience |
Circuit breaker, retry, bulkhead patterns |
@revealui/security |
Headers, CORS, RBAC/ABAC, encryption, audit |
@revealui/dev |
Shared configs (Biome, TypeScript, Tailwind) |
@revealui/mcp |
MCP hypervisor, adapter framework, tool discovery |
@revealui/services |
Stripe + Supabase integrations |
@revealui/test |
E2E specs, integration tests, fixtures, mocks |
create-revealui |
npm create revealui initializer |
| Package | Purpose |
|---|---|
@revealui/ai |
AI agents, CRDT memory, LLM providers |
@revealui/harnesses |
AI harness adapters and workboard coordination |
| Layer | Technology |
|---|---|
| Frontend | React 19, Tailwind CSS v4 |
| Backend | Node.js 24, Hono, REST + OpenAPI |
| Database | NeonDB (Postgres) + Supabase, Drizzle ORM |
| Auth | Session-based, bcrypt, RBAC + ABAC |
| Rich Text | Lexical editor |
| Sync | ElectricSQL (experimental) |
| Billing | Stripe (checkout, subscriptions, webhooks) |
| Desktop | Tauri 2 |
| TUI | Go, Bubble Tea |
| Testing | Vitest, Playwright |
| Tooling | pnpm, Turborepo, Biome, TypeScript 6 |
| Dev env | Nix flakes + direnv |
- Node.js 24+
- pnpm 10+
- PostgreSQL database (NeonDB free tier works)
- Stripe account (for billing features)
git clone https://github.com/RevealUIStudio/revealui.git
cd revealui
pnpm install
# Set up environment
cp apps/admin/.env.example apps/admin/.env.local
# Edit .env.local: set POSTGRES_URL, REVEALUI_SECRET (min 32 chars),
# REVEALUI_PUBLIC_SERVER_URL=http://localhost:4000
# Initialize database
pnpm db:migrate
pnpm db:seed
# Start admin dashboard + API
pnpm dev:app # Admin (port 4000) + API (port 3004)Three dev modes:
pnpm dev:app: Admin + API (recommended for most work)pnpm dev:admin: Admin only (if API already running)pnpm dev: All apps in parallel (heavy)
cp .env.production.example .env
# Edit .env with your values
docker compose up -dServices: PostgreSQL (5432), API (3004), Admin (4000), Marketing (3000).
Open in VS Code or GitHub Codespaces. The .devcontainer/ config handles everything.
| Platform | Recommended setup |
|---|---|
| Linux / WSL | Nix flakes + direnv (flake.nix) |
| macOS | Nix flakes + direnv (flake.nix) |
| Windows | WSL 2 (recommended) or Dev Containers (.devcontainer/) |
revealui/
├── apps/
│ ├── api/ # Hono REST API (port 3004)
│ ├── admin/ # Admin dashboard + content management (port 4000)
│ ├── docs/ # Documentation site (port 3002)
│ ├── marketing/ # Marketing site (port 3000)
│ ├── revealcoin/ # RevealCoin token explorer (experimental)
│ ├── studio/ # Native AI experience (Tauri 2)
│ └── terminal/ # TUI client (Go)
├── packages/ # 18 OSS + 5 Pro packages
├── docs/ # 25 guides
└── scripts/ # CI gates, release tooling, dev tools
- Build Your Business: End-to-end tutorial: scaffold, collections, pricing, billing, deploy
- Quick Start: From zero to running app
- The JOSHUA Stack: Six engineering principles and the evidence behind them
- Architecture: How the pieces fit together
- The VAUGHN Protocol: Multi-agent coordination across heterogeneous AI tools
- Pro: AI features, MCP, marketplace, and trust controls
- Database Guide: Schema, migrations, queries
- Auth Guide: Authentication, sessions, RBAC
- Admin Guide: Collections, fields, access control
- Testing: Vitest, Playwright, coverage
- Deployment: Vercel, Railway, or self-host
- All docs: Full index (25 guides)
Read CONTRIBUTING.md first. Then:
pnpm test # run tests
pnpm lint # lint and format
pnpm typecheck # type check
pnpm gate # full CI gate (runs before push)RevealUI is MIT-licensed and free to use. Sponsorship funds development, documentation, and community support.
- Individuals: github.com/sponsors/RevealUIStudio
- Businesses: revealui.com/sponsor for Gold and Platinum tiers (logo placement, office hours, roadmap input)
MIT. See LICENSE.
Pro packages are commercially licensed. See LICENSE.commercial.
Built by RevealUI Studio
