{"id":42872,"library":"instagres","title":"Instagres","description":"Instagres provided instant Postgres connection strings via Neon, no signup required, for local development. Version 1.1.8 is the last release. The package is deprecated and replaced by 'neondb'. Key differentiator was zero-setup ephemeral databases without authentication. Offers both CLI and library usage, with ESM and CJS support. No longer maintained; users should migrate to 'neondb'.","status":"deprecated","version":"1.1.8","language":"javascript","source_language":"en","source_url":"https://github.com/neondatabase-labs/instagres-js","tags":["javascript","typescript"],"install":[{"cmd":"npm install instagres","lang":"bash","label":"npm"},{"cmd":"yarn add instagres","lang":"bash","label":"yarn"},{"cmd":"pnpm add instagres","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"used for CLI argument parsing","package":"commander","optional":true},{"reason":"reads .env files","package":"dotenv","optional":true}],"imports":[{"note":"Default export is a function. CommonJS users must use require('instagres').default.","wrong":"const instagres = require('instagres')","symbol":"instagres (default)","correct":"import instagres from 'instagres'"},{"note":"Named export also available, but default is typical.","wrong":"import instagres from 'instagres' (if expecting default)","symbol":"instagres (named)","correct":"import { instagres } from 'instagres'"},{"note":"CommonJS must access .default since the package is ESM.","wrong":"require('instagres')","symbol":"instagres (CJS default)","correct":"const { default: instagres } = require('instagres')"}],"quickstart":{"code":"import instagres from 'instagres';\n\n// Get an instant Postgres connection string\nconst connectionString = await instagres({ source: 'my-app' });\nconsole.log('Connection string:', connectionString);","lang":"javascript","description":"Shows how to retrieve an instant Postgres connection string using the instagres function with a required source parameter."},"warnings":[{"fix":"Replace instagres with neondb.","message":"Package is deprecated; use neondb instead.","severity":"deprecated","affected_versions":">=1.1.8"},{"fix":"Use const { default: instagres } = require('instagres');","message":"CommonJS users must use require('instagres').default, not require('instagres')","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Always pass the source object: instagres({ source: 'my-project' })","message":"The source parameter is required. If omitted, the function will throw an error.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use 'npm install instagres' for library usage.","message":"The CLI commands (npx instagres etc.) are for the package itself, not for integrating into your project. For library usage, install the package.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use import instagres from 'npm:instagres@^1.1.4';","message":"When using Deno, import from 'npm:instagres@^1.1.4' to avoid version issues.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.1.8':17 'authent':39 'cjs':49 'cli':42 'connect':6 'databas':37 'deprec':25 'develop':15 'differenti':31 'ephemer':36 'esm':47 'instagr':1,2 'instant':4 'javascript':59 'key':30 'last':20 'librari':44 'local':14 'longer':52 'maintain':53 'migrat':56 'neon':9 'neondb':29,58 'offer':40 'packag':23 'postgr':5 'provid':3 'releas':21 'replac':27 'requir':12 'setup':35 'signup':11 'string':7 'support':50 'typescript':60 'usag':45 'user':54 'version':16 'via':8 'without':38 'zero':34 'zero-setup':33","created_at":"2026-06-05T16:57:04.439727+00:00","updated_at":"2026-06-05T16:57:04.439727+00:00","problems":[{"fix":"Use const { default: instagres } = require('instagres');","cause":"CommonJS require without .default","error":"TypeError: instagres is not a function"},{"fix":"Call instagres with an object containing source: instagres({ source: 'my-project' })","cause":"The source parameter is required but not provided.","error":"Error: Missing required parameter: source"}],"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/neondatabase-labs/instagres-js#readme","github":"https://github.com/neondatabase-labs/instagres-js","docs":null,"changelog":null,"pypi":null,"npm":"instagres","openapi_spec":null,"status_page":null,"smithery":null,"categories":["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}}