Butterbase
CHANGELOG

Built in the open.
Shipped in weeks.

Every feature we've released, in order. Built for AI-assisted development.

  1. SEP 9
    Deploy

    Preview deployments

    Give any app a preview deployment: a full copy — your tables, your functions, and your real live data, including signed-up accounts and uploaded files — that you can break without touching the app your users are on. A preview never inherits your secret values (the key names are created empty so anything that needs one fails loudly instead of quietly spending your money), connected accounts are disconnected, and scheduled jobs and integrations are switched off, so a preview copy of a nightly job cannot fire. Set test values per key with preview secrets. When the change is ready, push it live: your tables, access rules, functions, Durable Objects, settings and code are applied to your live app and the frontend is deployed. Data is never pushed, and anything that would throw away live data is refused outright — the refusal names the exact change that is stuck so you can make it yourself if you mean it. Reset copies the preview fresh from your live app whenever it wanders. One per app, on Launch and above, in the same region as your live app, from `manage_preview` / `promote_preview`, the REST API, or the new Preview page in the dashboard.

    Learn more →
  2. JUL 5
    Functions

    App-level environment variables

    Set an env var once at the app level and every function inherits it via `ctx.env.<KEY>` — no need to duplicate `STRIPE_SECRET` across every function that talks to Stripe. Per-function values still override on collision, and platform `BUTTERBASE_*` values still win overall. Change a shared key once and every function in the app picks it up on next invoke. Manage from the App Settings → Environment variables card, `manage_app` MCP actions `get_env`/`update_env`, or `PATCH /v1/:appId/env`. Values are encrypted at rest and never returned by any read; `BUTTERBASE_*` keys are rejected as reserved.

    Learn more →
  3. JUN 14
    Tooling

    Cloned apps now mint one shared API key

    Previously the clone job auto-minted a distinct `bb_sk_*` per function on the cloned app — any sibling-fn call that compared its bearer to its own `ctx.env.BUTTERBASE_API_KEY` 401d because every fn carried a different key. Clones now mint one key per app, fanned out to every function that needs `BUTTERBASE_API_KEY` / `BB_SUBSTRATE_KEY`. Existing already-cloned apps can be consolidated with `scripts/backfill-consolidate-clone-keys.ts`.

    Learn more →
  4. JUN 14
    Functions

    Service-key impersonation gate

    App-scoped service keys can now assert "act on behalf of user X" via the `X-Butterbase-As-User` header — the runtime populates `ctx.user.id` before invoking. Per-function `allow_service_key_impersonation` (default `true`) lets admin-only and billing-webhook handlers opt out; the platform 403s any X-Butterbase-As-User on those endpoints at the edge. End-user JWTs and out-of-app service keys cannot impersonate. Surfaced through `deploy_function`, `manage_function action: "update_settings"`, the CLI (`bb functions deploy --no-allow-impersonation`), the SDK (`apiClient.updateFunctionSettings`), and a toggle on the dashboard function detail page.

    Learn more →
  5. JUN 14
    Functions

    ctx.caller — validated caller identity

    Every function invocation now surfaces `ctx.caller = { type, keyId, scope, userId }`. Type is one of `service_key`, `end_user_jwt`, `loopback`, or `anonymous`. The `keyId` is a non-secret api-key row id safe to log in audit trails; `userId` is the user the request is acting on behalf of (propagated through ctx.invoke chains and X-Butterbase-As-User impersonation). Stop parsing `req.headers.authorization` by hand.

    Learn more →
  6. JUN 14
    Functions

    ctx.invoke for same-app function-to-function calls

    Call sibling functions on the same app with `ctx.invoke('fn-name', body)` — no bearer ceremony, no env vars. Authenticated with the per-app internal function key (never exposed to user code), `ctx.user.id` propagates automatically to the callee, and a depth-4 cycle guard throws synchronously on the 5th hop. Replaces the brittle pattern of having one fn call another over HTTP with `Bearer ctx.env.BUTTERBASE_API_KEY`. Same release: `ctx.app.substrateUserId` surfaces the linked substrate user id (or `null` when the app is not substrate-linked) so you can stop using `if (ctx.substrate)` as a proxy for "is this app linked?".

    Learn more →
  7. JUN 8
    Functions

    Multi-trigger functions

    A single function can now declare multiple triggers — an HTTP endpoint plus a daily cron, an S3 upload plus a webhook. New trigger types `s3_upload` and `webhook` join `http`, `cron`, and `websocket`. Dashboard editor supports add/remove per type.

    Learn more →
  8. JUN 8
    Functions

    Functions as agent tools

    Mark any serverless function as `agent_tool: true` with a description, mode (`read_only` or `read_write`), and exposure (`developer_only` or `end_user`). Agents call it directly; read-write tools pause the run for human approval before mutating.

    Learn more →
  9. JUN 8
    AI

    Agents

    Define multi-step LLM agents as a graph spec — LLM nodes, tool nodes, edges, limits — and run them with checkpointed state, SSE/WebSocket streaming, idempotency, human-in-the-loop approvals for write tools, and per-IP / per-user / per-app rate limits. Authored from the dashboard, CLI (`butterbase agents`), MCP, or REST.

    Learn more →
  10. JUN 1
    Tooling

    App Templates

    Mark any app public and let others clone it. Clones get your schema, RLS policies, function code, non-secret config, repo files, and seed-marked rows. Browse, clone, and configure clone webhooks from the dashboard, CLI (`butterbase clone`), or MCP.

    Learn more →
  11. MAY 31
    Storage

    App repo

    Per-app version-controlled file storage. Push your source with `butterbase repo push`, pull a fresh copy with `butterbase repo pull`, browse snapshot history. Powers app templates and gives every app a durable source-of-truth.

    Learn more →
  12. MAY 27
    Tooling

    Substrate

    Institutional-memory layer for your AI agents. Record entities, decisions, commitments, learnings, and principles to a per-account ledger with approve/reject gating, attention rules, real-time updates, and a dashboard browser. Surfaced via SDK, MCP, REST, and `bb substrate` CLI.

    Learn more →
  13. MAY 25
    Compute

    Key-Value Store

    Regional KV substrate with SDK, REST, CLI, and MCP surfaces. Sessions, locks, rate limiters, idempotency keys, and feature flags ship with copy-pasteable recipes.

    Learn more →
  14. MAY 4
    Deploy

    Server-Side Build

    Push your source — Butterbase runs `npm install` and the framework build in a container. Skip the local `@cloudflare/next-on-pages` toolchain (especially useful on Windows).

    Learn more →
  15. MAY 4
    Compute

    Durable Object env vars

    Inject encrypted config into Durable Objects with `butterbase do env set/list/unset`. Available as `env.KEY` inside any DO class for the app.

    Learn more →
  16. MAY 3
    Deploy

    Edge SSR for Next.js & Remix

    Deploy server-rendered Next.js (App Router, Server Actions, RSC) and Remix apps directly to Cloudflare Workers. One CLI command, no Node.js host to run.

    Learn more →
  17. MAY 3
    Compute

    Durable Objects

    Stateful per-key actors with built-in storage and WebSocket support. Build chat rooms, multiplayer games, rate limiters, and long-running AI agents — no infra to run.

    Learn more →
  18. MAY 1
    Tooling

    Partners SDK, CLI & MCP Support

    Discover and call partner APIs from the TypeScript SDK (`PartnersClient`), CLI (`butterbase partners list`, `partners curl`), and MCP (`list_partner_apis`).

  19. MAY 1
    Integrations

    Partner API Proxy

    Call third-party APIs from your app without exposing API keys. Butterbase manages key pools, rotation, and failover — your frontend just hits a single proxy route.

  20. APR 30
    Ops

    Hackathon Submissions & Scoring

    Public submission API for hackathons with async judging. Scores evaluate demo URLs and platform feature usage. Leaderboard and rescore endpoints included.

    Learn more →
  21. APR 29
    Ops

    Performance Improvements

    Faster response times across authentication, quota enforcement, and API key validation — all with no changes required to your app.

  22. APR 29
    AI

    Multimodal Chat Completions

    Pass images alongside text in chat completion requests. The AI config API now accepts multimodal message content.

    Learn more →
  23. APR 26
    Deploy

    Custom Domains

    Bring your own domain with automatic HTTPS, configured per app.

    Learn more →
  24. APR 26
    Auth

    Magic Link Authentication

    Passwordless sign-in for your app's users. Drop into any auth flow.

    Learn more →
  25. APR 25
    Functions

    Function Environment Variables

    Per-function secrets and config, encrypted at rest, hot-reloaded on deploy.

    Learn more →
  26. APR 25
    Functions

    Function Logs with Console Capture

    Stdout, stderr, and timing surfaced per invocation, viewable in the dashboard.

    Learn more →
  27. APR 25
    Auth

    Post-Auth Hooks

    Run custom logic after a user signs in — provision data, sync to external systems, send a welcome email.

    Learn more →
  28. APR 23
    Database

    Foreign-Key Referential Actions

    Declare ON DELETE and ON UPDATE behaviors directly in your schema.

    Learn more →
  29. APR 23
    Integrations

    Third-Party Integrations

    First-class connectors so your functions can call external services with managed auth.

    Learn more →
  30. APR 23
    AI

    Native RAG

    Ingest PDFs, DOCX, TXT, and more. Query with natural language in two API calls. Vector search built in.

    Learn more →
  31. APR 22
    Ops

    Plan Quotas + Limit Notifications

    Tiered plans with usage metering. Email alerts at 80% and at the hard limit.

    Learn more →
  32. APR 22
    Ops

    Per-App Audit Log

    Unified, queryable activity log for every app event.

  33. APR 20
    Ops

    App Overview Dashboard

    Health status, quota usage bars, weekly growth deltas, and recent activity in one place.

    Learn more →
  34. APR 17
    Deploy

    Edge Frontend Hosting

    Deploy a React, Next.js, or static frontend to a global URL with one tool call. SPA routing and HTTPS handled.

    Learn more →
  35. APR 15
    Realtime

    Cross-Region Realtime

    WebSocket data-change notifications with RLS-aware filtering, presence tracking, and custom event triggers.

    Learn more →
  36. APR 13
    AI

    Butterbase Skills

    Six AI-coding skills for Claude Code, installed via `claude plugin add @butterbase/skills`: build-app, schema-design, function-dev, debug-rls, deploy-frontend, contributing.

    Learn more →
  37. APR 4
    AI

    MCP Server

    Connect any AI assistant — Claude, Cursor, Windsurf — to Butterbase via MCP. Tools tuned for agents: predictable responses, structured errors, next-action hints.

    Learn more →
  38. APR 4
    Tooling

    Command-Line Interface

    @butterbase/cli with init, integrations, and project-management commands.

    Learn more →
  39. APR 4
    Tooling

    TypeScript SDK

    @butterbase/sdk with full API coverage and typed responses.

    Learn more →
  40. APR 3
    Functions

    Serverless Functions

    Deploy TypeScript / JavaScript functions to a managed Deno runtime. HTTP triggers and cron schedules.

    Learn more →
  41. APR 2
    Database

    Row-Level Security

    One tool call to restrict rows so each signed-in user only accesses their own data.

    Learn more →
  42. APR 1
    Storage

    File Storage

    S3-compatible storage with presigned URLs. Per-app and per-user organization, configurable size and content-type limits, RLS-aware.

    Learn more →
  43. APR 1
    Auth

    Managed Authentication

    Email/password, OAuth (any provider), password reset, email verification, and rate limiting — configurable per app.

    Learn more →
  44. APR 1
    Database

    Isolated Postgres per App

    Every app gets its own Postgres database, identifier, and API base URL.

    Learn more →
  45. MAR 31
    Database

    Declarative Schema + Auto-API

    Describe tables in JSON; the platform diffs and applies. Full CRUD over HTTP appears automatically — no code generation, no manual route setup.

    Learn more →
  46. MAR 30
    Ops

    Foundations

    Control API, app provisioning, API key management, and the platform skeleton.

Want to see something here? Suggest a feature