What is ObjectStack?

ObjectStack is not just a framework; it is an AI-native business backend protocol for building enterprise software. It decouples the Business Intent (defined as typed metadata) from the Technical Execution (handled by the Kernel), so APIs, UI metadata, workflows, and agent tools can all derive from the same source of truth.

The Problem

In traditional development, application logic is scattered:

1. Database Schema (table.sql)
2. Backend Models (User.ts)
3. Frontend Validation (schema.zod.ts)
4. API Documentation (swagger.json)
5. Agent Tools (MCP definitions, function calls, prompts)

When requirements change, you update code in multiple places. When AI agents need to act, they usually see only brittle glue code or manually curated tools. This is Implementation Coupling.

The Solution

We centralize the "Intent" into a single TypeScript-authored, Zod-validated protocol definition. The implementation layers (React, Node.js, SQL, MCP tools) act as Runtime Engines that interpret this protocol.

The "Stack" Analogy

Think of ObjectStack as:

• Kubernetes for business applications - Declarative configuration over imperative code
• Terraform for data modeling - Infrastructure as code, but for data
• GraphQL + React Server Components - Schema-driven data + UI rendering combined
• MCP for business systems - Structured, permission-aware tools generated from metadata

Key Features

1. Protocol-Driven Architecture

The UI is a Projection. The API is a Consequence.

• ObjectUI does not "build" a form; it projects the ObjectQL schema into a visual representation
• You do not write endpoints or hand-author every agent tool; ObjectOS generates the secure graph based on the access control protocol

2. Agent-Ready Boundaries

Agents act through typed, permission-aware, auditable surfaces.

• Tool schemas derive from business object metadata
• RBAC, RLS, and FLS apply to agent actions
• Executions are traceable to versioned artifacts, user/org context, inputs, and results

3. Database Agnostic

ObjectQL treats the database as an Implementation Detail.

• Start with SQLite for prototyping
• Migrate to PostgreSQL for production
• Archive to Snowflake for analytics
• No code changes required

Real-World Benefits

Who Should Use ObjectStack?

Enterprise Developers

Building internal tools, CRMs, ERPs, or admin panels? ObjectStack eliminates boilerplate while making the business model explicit for AI agents.

Platform Builders

Creating a SaaS product or multi-tenant application? ObjectStack provides enterprise-grade security and isolation.

Integration Engineers

Connecting multiple systems? ObjectStack's protocol-driven approach makes it easy to map and transform data.

AI Agent Builders

Need agents to operate real business data? ObjectStack gives them typed schemas, generated tools, permission boundaries, and audit trails instead of brittle query glue.

Prerequisites

Before you start, make sure you have the following installed:

Common Setup Issues

pnpm not found

# Install pnpm globally
npm install -g pnpm
# Or use corepack (recommended)
corepack enable

TypeScript version mismatch

ObjectStack requires TypeScript 5.3+. Update with:

pnpm add -D typescript@latest

Port 3000 already in use

# Find the process using port 3000
lsof -i :3000
# Kill it or use a different port
PORT=3001 pnpm dev

For more troubleshooting, see the Troubleshooting & FAQ guide.

Next Steps

• Core Concepts — Metadata-driven development & design principles
• Architecture — The three-layer protocol stack
• Glossary — Key terminology
• Quick Start — Build your first app in 5 minutes