Skip to content

ChimpbaseBuild complex backends with fewer moving parts.

PostgreSQL-backed backend primitives for software that needs more than request-response, without adding a distributed systems stack before it is necessary.

Quick Start

Install the Bun host:

bash
bun add @chimpbase/bun

Start with PostgreSQL:

ts
import { createChimpbase } from "@chimpbase/bun";

const chimpbase = await createChimpbase({
  storage: { engine: "postgres", url: process.env.DATABASE_URL! },
});

Register actions, workers, subscriptions and cron jobs:

ts
chimpbase.register({ createCustomer });

chimpbase.register(
  worker("customer.sync", syncCustomer),
  cron("billing.rollup", "0 * * * *", runBillingRollup),
);

Then start the runtime:

ts
await chimpbase.start();

PostgreSQL First

Chimpbase uses PostgreSQL as both your application database and your coordination layer:

  • application data in PostgreSQL
  • queue state in PostgreSQL
  • cron schedule state in PostgreSQL
  • workflow state in PostgreSQL

SQLite and in-memory storage are available for local development and tests.