Turso Quickstart (Flutter / Dart)

This SDK is community maintained and may not be officially supported by Turso, or up to date with the latest features. Join the #libsql-dart channel on Discord for help and feedback.

In this Flutter/Dart quickstart we will learn how to:

Retrieve database credentials
Install the Flutter/Dart libSQL client
Connect to a local or remote Turso database
Execute a query using SQL
Sync changes to local database (optional)

Retrieve database credentials

You will need an existing database to continue. If you don’t have one, create one.

Get the database URL:

turso db show --url <database-name>

Get the database authentication token:

turso db tokens create <database-name>

Assign credentials to the environment variables inside .env.

TURSO_DATABASE_URL=
TURSO_AUTH_TOKEN=

You will want to store these as environment variables.

Install libsql_dart

flutter pub add libsql_dart

Initialize

Now connect to your local or remote database using the LibsqlClient constructor:

final dir = await getApplicationCacheDirectory();
final path = '${dir.path}/local.db';

final client = LibsqlClient(path)
  ..authToken = '<TOKEN>'
  ..syncUrl = '<TURSO_OR_LIBSQL_URL>'
  ..syncIntervalSeconds = 5
  ..readYourWrites = true;

Connect

await client.connect();

Execute

If you need to use placeholders for values, you can do that:

Sync (Embedded Replicas only)

When using embedded replicas you should call sync() on the connector to sync your local database with the primary database.

await client.sync();

Client SDKs

Official SDKs

Community SDKs

Turso Quickstart (Flutter / Dart)