{"id":46838441,"url":"https://github.com/tursodatabase/turso-vercel","last_synced_at":"2026-03-10T12:01:13.700Z","repository":{"id":336404205,"uuid":"1149138594","full_name":"tursodatabase/turso-vercel","owner":"tursodatabase","description":"Turso + Vercel Integration","archived":false,"fork":false,"pushed_at":"2026-02-19T15:23:50.000Z","size":329,"stargazers_count":4,"open_issues_count":4,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-19T18:56:45.153Z","etag":null,"topics":["serverless","sqlite","turso","vercel"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tursodatabase.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-03T19:06:53.000Z","updated_at":"2026-02-19T15:23:54.000Z","dependencies_parsed_at":"2026-03-10T12:01:06.658Z","dependency_job_id":null,"html_url":"https://github.com/tursodatabase/turso-vercel","commit_stats":null,"previous_names":["penberg/turso-vercel"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tursodatabase/turso-vercel","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tursodatabase%2Fturso-vercel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tursodatabase%2Fturso-vercel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tursodatabase%2Fturso-vercel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tursodatabase%2Fturso-vercel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tursodatabase","download_url":"https://codeload.github.com/tursodatabase/turso-vercel/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tursodatabase%2Fturso-vercel/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30332853,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T05:25:20.737Z","status":"ssl_error","status_checked_at":"2026-03-10T05:25:17.430Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["serverless","sqlite","turso","vercel"],"created_at":"2026-03-10T12:00:54.505Z","updated_at":"2026-03-10T12:01:13.557Z","avatar_url":"https://github.com/tursodatabase.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://turso.tech/\"\u003e\n    \u003cpicture\u003e\n      \u003cimg src=\"/.github/assets/cover.png\" alt=\"Turso database for Vercel\" /\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n  \u003ch1 align=\"center\"\u003eTurso + Vercel Integration\u003c/h1\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  Zero-config SQLite databases for Vercel Functions.\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://turso.tech\"\u003e\u003cstrong\u003eTurso\u003c/strong\u003e\u003c/a\u003e ·\n  \u003ca href=\"https://docs.turso.tech\"\u003e\u003cstrong\u003eDocs\u003c/strong\u003e\u003c/a\u003e ·\n  \u003ca href=\"https://turso.tech/blog\"\u003e\u003cstrong\u003eBlog \u0026amp; Tutorials\u003c/strong\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\n    \u003cpicture\u003e\n      \u003cimg src=\"https://img.shields.io/github/license/tursodatabase/turso-vercel?color=0F624B\" alt=\"MIT License\" /\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://tur.so/discord-ts\"\u003e\n    \u003cpicture\u003e\n      \u003cimg src=\"https://img.shields.io/discord/933071162680958986?color=0F624B\" alt=\"Discord\" /\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/@tursodatabase/vercel-experimental\"\u003e\n    \u003cpicture\u003e\n      \u003cimg src=\"https://img.shields.io/npm/v/@tursodatabase/vercel-experimental?color=0F624B\" alt=\"npm version\" /\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e **⚠️ Warning:** This software is in BETA. It may still contain bugs and unexpected behavior. Use caution with production data and ensure you have backups.\n\n## Features\n\n- **Zero-config databases** \u0026mdash; Databases are created automatically on first use\n- **Local SQLite** \u0026mdash; Fast reads from a local database copy in the serverless function\n- **Remote writes** \u0026mdash; Writes go directly to the remote Turso server, so they're durable immediately\n- **Partial replication** \u0026mdash; Replicate just the data you need locally to serverless function\n\nIf you've used Cloudflare D1 before for SQLite access on serverless, this package provides similar semantics on Vercel Functions.\n\n## Install\n\n```bash\nnpm install @tursodatabase/vercel-experimental\n```\n\n## Setup\n\n1. Get your Turso API token:\n   ```bash\n   turso auth api-tokens mint my-vercel-token\n   ```\n\n2. Get your organization slug:\n   ```bash\n   turso org list\n   ```\n\n3. Create a database group for your project (or use an existing one):\n   ```bash\n   turso group create my-project\n   ```\n\n4. Add environment variables to your Vercel project:\n   ```\n   TURSO_API_TOKEN=your-api-token\n   TURSO_ORG=your-org-slug\n   TURSO_GROUP=my-project\n   ```\n\nAll databases are scoped to the configured group. You can have multiple databases per project, but they can only be created in and accessed from the specified group.\n\n## Quickstart\n\n```ts\nimport { createDb } from \"@tursodatabase/vercel-experimental\";\n\n// Get or create a database in the configured group\nconst db = await createDb(process.env.TURSO_DATABASE!);\n\n// Create tables\nawait db.execute(`\n  CREATE TABLE IF NOT EXISTS users (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    name TEXT NOT NULL,\n    email TEXT UNIQUE\n  )\n`);\n\n// Insert data\nawait db.execute(\n  \"INSERT INTO users (name, email) VALUES (?, ?)\",\n  [\"Alice\", \"alice@example.com\"]\n);\n\n// Query data\nconst result = await db.query(\"SELECT * FROM users\");\nconsole.log(result.rows);\n```\n\n## API Reference\n\n### `createDb(name, options?)`\n\nCreates or retrieves a database instance. The database is scoped to the group configured via `TURSO_GROUP`.\n\n```ts\nconst db = await createDb(process.env.TURSO_DATABASE!);\n```\n\n\u003e **Important:** Store database names passed to `createDb()` as secret environment variables in Vercel. If an attacker can control the database name, they could access any database in the group.\n\n### `db.query(sql, params?)`\n\nExecute a SELECT query and return results.\n\n```ts\nconst result = await db.query(\n  \"SELECT * FROM users WHERE id = ?\",\n  [1]\n);\n\nconsole.log(result.columns); // [\"id\", \"name\", \"email\"]\nconsole.log(result.rows);    // [[1, \"Alice\", \"alice@example.com\"]]\n```\n\n### `db.execute(sql, params?)`\n\nExecute an INSERT, UPDATE, DELETE, or DDL statement.\n\n```ts\nawait db.execute(\n  \"UPDATE users SET name = ? WHERE id = ?\",\n  [\"Bob\", 1]\n);\n```\n\n### `db.push()`\n\nManually push local changes to the remote Turso database. Only needed when `remoteWrites` is disabled.\n\n```ts\nconst db = await createDb(process.env.TURSO_DATABASE!, { remoteWrites: false });\nawait db.execute(\"INSERT INTO users (name) VALUES (?)\", [\"Charlie\"]);\nawait db.push();\n```\n\n### `db.pull()`\n\nPull latest changes from the remote Turso database.\n\n```ts\nawait db.pull(); // Get latest data from Turso\n```\n\n## Examples\n\n### Next.js Server Component\n\n```tsx\nimport { createDb } from \"@tursodatabase/vercel-experimental\";\n\nasync function getUsers() {\n  const db = await createDb(process.env.TURSO_DATABASE!);\n  const result = await db.query(\"SELECT * FROM users\");\n  return result.rows;\n}\n\nexport default async function UsersPage() {\n  const users = await getUsers();\n\n  return (\n    \u003cul\u003e\n      {users.map((user) =\u003e (\n        \u003cli key={user[0]}\u003e{user[1]}\u003c/li\u003e\n      ))}\n    \u003c/ul\u003e\n  );\n}\n```\n\n### Next.js Server Action\n\n```tsx\nimport { createDb } from \"@tursodatabase/vercel-experimental\";\nimport { revalidatePath } from \"next/cache\";\n\nasync function addUser(formData: FormData) {\n  \"use server\";\n\n  const name = formData.get(\"name\") as string;\n  const db = await createDb(process.env.TURSO_DATABASE!);\n\n  await db.execute(\"INSERT INTO users (name) VALUES (?)\", [name]);\n\n  revalidatePath(\"/users\");\n}\n```\n\n### API Route\n\n```ts\nimport { createDb } from \"@tursodatabase/vercel-experimental\";\nimport { NextResponse } from \"next/server\";\n\nexport async function GET() {\n  const db = await createDb(process.env.TURSO_DATABASE!);\n  const result = await db.query(\"SELECT * FROM users\");\n\n  return NextResponse.json(result.rows);\n}\n\nexport async function POST(request: Request) {\n  const { name } = await request.json();\n  const db = await createDb(process.env.TURSO_DATABASE!);\n\n  await db.execute(\"INSERT INTO users (name) VALUES (?)\", [name]);\n\n  return NextResponse.json({ success: true });\n}\n```\n\n## Documentation\n\nVisit our [official documentation](https://docs.turso.tech) for more details.\n\n## Support\n\nJoin us [on Discord](https://tur.so/discord-ts) to get help using this SDK. Report security issues [via email](mailto:security@turso.tech).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftursodatabase%2Fturso-vercel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftursodatabase%2Fturso-vercel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftursodatabase%2Fturso-vercel/lists"}