Developer Guide

OrbitKit Architecture & Documentation

Everything you need to know about developing with OrbitKit, AI coding agents, and our MCP server.

Agent Rules & Skills

OrbitKit bundles AI instructions tailored for Cursor, Claude Code, Windsurf, and Codex:

  • AGENTS.md: Root and package-level architecture guidelines.
  • .claude/skills/: Modular skills including supabase-expert, server-actions-expert, and billing-expert.
  • CLAUDE.md & GEMINI.md: Direct agent entrypoints.

Model Context Protocol (MCP)

Our native MCP 2.0 server connects your agent directly to local tools:

  • get_schema_files & get_database_summary: Live DB context.
  • env_schema & env_read: Safe env check without secret leakage.
  • kit_doctor: Stack and dependency diagnostics.

Multi-Tenancy & RLS

Complete tenant isolation enforced at the PostgreSQL database layer:

  • Accounts (Personal and Team Workspaces).
  • Role-Based Access Control: Owner, Admin, Member.
  • Security definer helpers: is_account_member & has_role_on_account.

Billing & Subscriptions

Multi-provider billing supporting Stripe, Lemon Squeezy, and Paddle:

  • Centralized tier definitions in plans.config.ts.
  • Customer Portal session minting.
  • Cryptographically verified webhook endpoints with idempotency.