Quick Start

What is ForgeDB?

ForgeDB is a serverless Database-as-a-Service with built-in time travel and full audit trails. Every write is tracked and versioned, which means you can roll back to any previous state with zero configuration.

You interact with ForgeDB through a REST API using API keys. There are no drivers to install, no connection strings to manage, and no servers to run. You send an HTTP request, data is stored.

ForgeDB is free forever. No credit card required. The free plan gives you 3 projects, 10,000 rows per table, and 7 days of time travel history.

Create a project

After signing up, head to the dashboard and click New Project. Give it a name — this becomes your projectId in every API call.

Every project automatically gets two databases: prod and test. They are completely isolated — separate data, separate keys, separate history. The test database auto-wipes every 30 days.

Get your API key

In your project, go to API Keys and create a key. Choose between:

Type	Prefix	Permissions
Production read-only	fk_live_...	SELECT only
Production read-write	sk_live_...	SELECT + INSERT + UPDATE + DELETE
Test read-only	fk_test_...	SELECT only (test db)
Test read-write	sk_test_...	Full access (test db)

Never expose a sk_live_ key in client-side code. Use read-only fk_live_ keys for the browser and save write keys for your backend.

Your first query

Each project gets its own subdomain. Data requests go to PROJECT_ID.forgedb.name.ng.

bash

curl https://my-project.forgedb.name.ng/prod/users \
  -H "X-Forge-Key: fk_live_yourkey"

Insert your first row:

bash

curl -X POST https://my-project.forgedb.name.ng/prod/users \
  -H "X-Forge-Key: sk_live_yourkey" \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice", "email": "alice@example.com", "plan": "free"}'

The response includes the full row with an auto-assigned id:

json

{
  "success": true,
  "row": {
    "id": 1,
    "name": "Alice",
    "email": "alice@example.com",
    "plan": "free"
  }
}

Prefer JavaScript? Install the official SDK: npm install @firekid/forgedb