Turso DB

npm install @tursodatabase/sync-react-native

cd ios && pod install

import { Database, getDbPath } from '@tursodatabase/sync-react-native';

// Get platform-specific path
const dbPath = getDbPath('myapp.db');

// Create database with sync
const db = new Database({
    path: dbPath,
    url: 'libsql://your-db.turso.io',
    authToken: 'your-auth-token',
});

// Connect (bootstraps if first sync)
await db.connect();

// Query (fast local reads)
const users = await db.all('SELECT * FROM users');

// Write locally
await db.run('INSERT INTO users (name) VALUES (?)', ['Alice']);

// Sync with remote
await db.push();  // Push local changes
await db.pull();  // Pull remote changes

await db.close();

const db = new Database({
    path: string,           // Local database path (use getDbPath())
    url?: string,           // Turso Cloud URL (libsql://...)
    authToken?: string,     // Authentication token
    remoteEncryption?: {    // Optional encryption config
        cipher: string,
        key: string,
    },
});

import { getDbPath, paths } from '@tursodatabase/sync-react-native';

// Recommended: auto-selects correct platform directory
const dbPath = getDbPath('myapp.db');

// Available path directories
paths.documents  // iOS: Documents, Android: database dir
paths.database   // iOS: Documents, Android: database dir
paths.files      // iOS: Documents, Android: files dir
paths.library    // iOS: Library, Android: files dir

const db = new Database({
    path: getDbPath('replica.db'),
    url: 'libsql://your-db.turso.io',
    authToken: 'your-token',
});

await db.connect();

// Pull remote changes to local replica
await db.pull();

// Make local changes
await db.run('INSERT INTO users (name) VALUES (?)', ['Alice']);

// Push local changes to remote
await db.push();

// Or sync both directions at once
await db.sync();

// Check sync stats
const stats = await db.stats();
console.log(stats);

const db = new Database({
    path: getDbPath('encrypted.db'),
    url: 'libsql://your-db.turso.io',
    authToken: 'your-token',
    remoteEncryption: {
        cipher: 'aes256gcm',  // or 'aes128gcm', 'chacha20poly1305', 'aegis256', etc.
        key: 'base64-encoded-key',
    },
});

const db = new Database({
    path: getDbPath('replica.db'),
    url: 'libsql://your-db.turso.io',
    authToken: 'your-token',
    partialSyncExperimental: {
        bootstrapStrategy: {
            kind: 'prefix',
            length: 100,
        },
        segmentSize: 4096,
        prefetch: true,
    },
});

import React, { useEffect, useState } from 'react';
import { View, Text, FlatList } from 'react-native';
import { Database, getDbPath } from '@tursodatabase/sync-react-native';

export default function App() {
    const [users, setUsers] = useState([]);

    useEffect(() => {
        async function init() {
            const db = new Database({
                path: getDbPath('app.db'),
                url: 'libsql://your-db.turso.io',
                authToken: 'your-token',
            });

            await db.connect();
            await db.pull();

            await db.exec(`
                CREATE TABLE IF NOT EXISTS users (
                    id INTEGER PRIMARY KEY,
                    name TEXT NOT NULL
                )
            `);

            await db.run('INSERT INTO users (name) VALUES (?)', ['Alice']);
            await db.push();

            const rows = await db.all('SELECT * FROM users');
            setUsers(rows);
        }
        init();
    }, []);

    return (
        <FlatList
            data={users}
            keyExtractor={(item) => String(item.id)}
            renderItem={({ item }) => <Text>{item.name}</Text>}
        />
    );
}