Introduction

What is Rebase?

Rebase is an open-source Backend-as-a-Service (BaaS) and admin panel built with React and TypeScript. It gives you everything you need to build production-ready back-office applications on top of PostgreSQL:

• Schema as Code — Define your data models as TypeScript collections. Rebase generates PostgreSQL tables, a full CRUD UI, REST API endpoints, and type-safe client SDKs from a single source of truth.
• Instant Admin Panel — A beautiful, fast React-based admin UI with spreadsheet tables, forms, Kanban boards, inline editing, and real-time sync.
• Integrated Backend — Authentication (JWT + Google OAuth), file storage (local or S3), Row Level Security, entity history, and WebSocket real-time — all built in.
• Radically Extensible — If you can build it in React, you can add it to Rebase. Custom fields, custom views, plugins, and full access to internal hooks.

Tip

Rebase is not a hosted SaaS. You self-host it, you own your data, and you own your code. Think of it as an open-source alternative to Supabase or Retool that you control end-to-end.

How It Works

┌──────────────────────────────────────────────────────┐
│                 Client Applications                  │
│  ┌──────────────┐  ┌───────────────────────────────┐ │
│  │   Your App   │  │   Rebase Admin UI             │ │
│  │  (Any Tech)  │  │   Tables / Forms / Kanban     │ │
│  └──────┬───────┘  └──────────────┬────────────────┘ │
└─────────┼──────────────────────────┼─────────────────┘
          │  HTTP + WebSocket        │
          ▼                          ▼
┌──────────────────────────────────────────────────────┐
│              Rebase Backend (Node.js + Hono)          │
│  ┌─────────┐ ┌──────┐ ┌─────────┐ ┌───────────────┐ │
│  │ REST API│ │ Auth │ │ Storage │ │ WebSocket RT  │ │
│  └────┬────┘ └──┬───┘ └────┬────┘ └──────┬────────┘ │
└───────┼─────────┼──────────┼─────────────┼───────────┘
        │         │          │             │
        ▼         ▼          ▼             ▼
┌──────────────────────────────────────────────────────┐
│              PostgreSQL (via Drizzle ORM)             │
└──────────────────────────────────────────────────────┘

Quick Start

npx create-rebase-app my-app
cd my-app

Configure your database in .env:

DATABASE_URL=postgresql://user:password@localhost:5432/mydb
JWT_SECRET=your-secret-key

Start everything:

pnpm dev

That’s it. Your admin panel is running at http://localhost:5173 and the API at http://localhost:3001.

→ Follow the full Quickstart guide for a complete walkthrough.

Core Features

Feature	Description
Spreadsheet Views	Fast, virtualized table with inline editing, filtering, sorting, and text search
Kanban Board	Drag-and-drop board view grouped by any enum property
Relations	One-to-one, one-to-many, many-to-many with junction tables and multi-hop joins
Row Level Security	Supabase-style RLS policies defined in your collection config
Authentication	JWT + refresh tokens, Google OAuth, role-based access control
File Storage	Local filesystem or S3-compatible with upload fields and browser
Real-time Sync	WebSocket-powered live updates across all connected clients
Entity History	Full audit trail for every create, update, and delete
REST API	Auto-generated CRUD endpoints for every collection
Data Import/Export	CSV, JSON, and Excel import with field mapping; CSV/JSON export
Collection Editor	Visual schema editor that generates TypeScript via AST manipulation
Client SDK	Type-safe JavaScript SDK for your frontend apps
Plugin System	Extend every part of the UI — toolbar, forms, fields, home page
AI Data Enhancement	LLM-powered autocompletion for text fields

Next Steps

• Quickstart — Get running in 2 minutes
• Project Structure — Understand the generated code
• Collections — Define your data schema
• Backend — Configure auth, storage, and the API
• Architecture — Understand how it all fits together