@prisma/adapter-libsql

Prisma driver adapter for libSQL

Prisma driver adapter for Turso and libSQL. Refer to the announcement blog post and our docs for more details.

Note: Support for Turso is available in Early Access from Prisma versions 5.4.2 and later.

Getting started

To get started, enable the driverAdapters Preview feature flag in your Prisma schema:

// schema.prisma
generator client {
  provider        = "prisma-client-js"
  previewFeatures = ["driverAdapters"]
}

datasource db {
  provider = "sqlite"
  url      = "file:./dev.db"
}

Generate Prisma Client:

npx prisma generate

Install the libSQL database client and Prisma driver adapter for libSQL packages:

npm install @prisma/adapter-libsql
npm install @libsql/client

Update your Prisma Client instance to use the libSQL database Client:

// Import needed packages
import { PrismaClient } from '@prisma/client'
import { PrismaLibSQL } from '@prisma/adapter-libsql'
// You can alternatively use the web version of the client if you're running in
// a constrained environment where the standard libsql client doesn't work:
// import { PrismaLibSQL } from '@prisma/adapter-libsql/web'

// Setup
const connectionString = `${process.env.TURSO_DATABASE_URL}`
const authToken = `${process.env.TURSO_AUTH_TOKEN}`

// Init prisma client
const adapter = new PrismaLibSQL({
  url: connectionString,
  authToken,
})
const prisma = new PrismaClient({ adapter })

The above setup uses a single remote Turso database. You can take this a step further by setting up remote replicas and embedded replicas with Turso.

Refer to our docs to learn how to manage schema changes when using Prisma and Turso.

Feedback

We encourage you to create an issue if you find something missing or run into a bug.

If you have any feedback, leave a comment in this GitHub discussion.