{"id":42556,"library":"create-db","title":"Create DB CLI","description":"create-db is a CLI tool (v1.2.1) that instantly provisions a temporary Prisma Postgres database for development or testing. It integrates with the Prisma Data Platform, allowing users to claim and persist the temporary database into a permanent project. The tool is maintained by Prisma, releases are frequent (semver), and it differentiates by providing ephemeral databases without manual cloud setup, ideal for CI/CD and rapid prototyping. Requires Node 18+ and a Prisma Data Platform account for persistence.","status":"active","version":"1.2.1","language":"javascript","source_language":"en","source_url":"https://github.com/prisma/create-db","tags":["javascript","prisma","postgres","cli","database","temporary","typescript"],"install":[{"cmd":"npm install create-db","lang":"bash","label":"npm"},{"cmd":"yarn add create-db","lang":"bash","label":"yarn"},{"cmd":"pnpm add create-db","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Used for Prisma engine interactions","package":"@prisma/internals","optional":false}],"imports":[{"note":"Package is ESM-only. No CommonJS support.","wrong":"const createDb = require('create-db')","symbol":"createDb","correct":"import { createDb } from 'create-db'"},{"note":"Also available as default export for convenience.","wrong":"","symbol":"createDb","correct":"import createDb from 'create-db'"},{"note":"Named export works only with ESM imports.","wrong":"const { claimDb } = require('create-db')","symbol":"claimDb","correct":"import { claimDb } from 'create-db'"}],"quickstart":{"code":"import { createDb, claimDb } from 'create-db';\n\nasync function main() {\n  const db = await createDb({\n    projectId: process.env.PRISMA_PROJECT_ID ?? '',\n    apiKey: process.env.PRISMA_API_KEY ?? '',\n  });\n  console.log('Temporary DB:', db.url);\n\n  // Later, claim it\n  const claimed = await claimDb(db.id, {\n    name: 'my-permanent-db',\n  });\n  console.log('Claimed:', claimed.url);\n}\n\nmain().catch(console.error);","lang":"typescript","description":"Creates a temporary Prisma Postgres database and then claims it to a permanent project."},"warnings":[{"fix":"Ensure API key has required scopes in Prisma Data Platform settings.","message":"API keys must have the 'databases:create' and 'databases:claim' permissions. Without them, operations fail silently with 403.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Replace `region` with `provider: 'aws'` or similar.","message":"The `createDb` function's `region` parameter is deprecated; use `provider` instead.","severity":"deprecated","affected_versions":">=1.2.0"},{"fix":"Access `db.url` instead of using the result directly.","message":"Version 1.0.0 changed the return type of `createDb` from a string to an object with `id` and `url`.","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Call `claimDb` within 24 hours to persist the database.","message":"Temporary databases are automatically deleted after 24 hours if not claimed.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'18':73 'account':79 'allow':31 'ci/cd':67 'claim':34 'cli':3,9,85 'cloud':63 'creat':1,5 'create-db':4 'data':29,77 'databas':19,39,60,86 'db':2,6 'develop':21 'differenti':56 'ephemer':59 'frequent':52 'ideal':65 'instant':13 'integr':25 'javascript':82 'maintain':47 'manual':62 'node':72 'perman':42 'persist':36,81 'platform':30,78 'postgr':18,84 'prisma':17,28,49,76,83 'project':43 'prototyp':70 'provid':58 'provis':14 'rapid':69 'releas':50 'requir':71 'semver':53 'setup':64 'temporari':16,38,87 'test':23 'tool':10,45 'typescript':88 'user':32 'v1.2.1':11 'without':61","created_at":"2026-06-05T16:55:33.063810+00:00","updated_at":"2026-06-05T16:55:33.063810+00:00","problems":[{"fix":"Run `npm install create-db` and ensure you are using ESM imports.","cause":"Package not installed or wrong import path.","error":"Error: Cannot find module 'create-db'"},{"fix":"Use `import { createDb } from 'create-db'` or set `\"type\": \"module\"` in package.json.","cause":"Using CommonJS require instead of ESM import.","error":"TypeError: createDb is not a function"},{"fix":"Generate a new API key with 'databases:create' and 'databases:claim' scopes in Prisma Data Platform.","cause":"API key lacks required permissions.","error":"Error: 403 Forbidden"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/prisma/create-db#readme","github":"https://github.com/prisma/create-db","docs":null,"changelog":null,"pypi":null,"npm":"create-db","openapi_spec":null,"status_page":null,"smithery":null,"categories":["devops","database"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-05","next_check":"2026-09-03","install_tag":null}}