Provision instant temporary Postgres databases via Claimable Postgres by Neon (pg.new) with no login, signup, or credit card. Use when users ask for a quick Postgres environment, a throwaway DATABASE_URL for prototyping/tests, or "just give me a DB now". Triggers include: "quick postgres", "temporary postgres", "no signup database", "no credit card database", "instant DATABASE_URL".
Create an instant Postgres database with Claimable Postgres by Neon (pg.new) for fast local development, demos, prototyping, and test environments.
Databases are temporary by default (typically 72 hours) and can be claimed later to a Neon account for permanent use.
Run:
npx get-db
This provisions a database and writes DATABASE_URL to .env.
npx get-db)Use this by default for most users who want a fast setup in an existing project.
npx get-db
Common flags:
-y, --yes: skip prompts-e, --env <path>: choose env file path-k, --key <name>: customize env var key (default DATABASE_URL)-s, --seed <path>: run SQL seed file-L, --logical-replication: enable logical replication-r, --ref <id>: set source/referrer idget-db/sdk)Use this for scripts and programmatic provisioning flows.
import { instantPostgres } from "get-db/sdk";
const db = await instantPostgres();
console.log(db.connectionString);
Use this for non-Node environments or custom integrations.
curl -X POST https://pg.new/api/v1/database \
-H "Content-Type: application/json" \
-d '{"ref":"my-app"}'
npx get-db in the project root.DATABASE_URL was added to the intended env file.SELECT 1) in their stack.Always return:
.env)DATABASE_URL or custom key)PUBLIC_CLAIM_URL is presentDROP, TRUNCATE, mass DELETE).