TriplitDB

TriplitDB is the embedded database that powers Triplit, a complete solution to data persistence, state management, and realtime synchronization for web applications that want to go fast.

⚠️ Triplit DB is pre-1.0.0, but does its best to follow semantic versioning practices. Minor version updates may include breaking changes, while patches should maintain backwards compatibility.

Goal

TriplitDB is designed to run in any JS environment (browser, node, deno, React Native, etc) and provide expressive, fast, and live updating queries while maintaining consistency with many writers over a network.

Features

TriplitDB has support for

• Reactive queries that are incrementally updated
• Built-in storage providers for in-memory, IndexedDB, and Sqlite
• Automatic indexing of object properties for fast querying
• Combine multiple storage layers in the same DB with granular scoping on reads and writes
• Persistent and/or ephemeral storage backends
• Transactions with rollback
• Schema for validation, type hinting and enhanced CRDT-based storage.
• First-party schema migration support

Quick Start

1. Install from using your preferred packet manager.

npm i @triplit/db
// or
pnpm add @triplit/db
// or
yarn add @triplit/db

2. Define a schema (optional)

A schema can comprise multiple ‘collections’ (similar to a table in SQL). Using a schema with TriplitDB will enable type checking and the full the benefit of our CRDT-based data structures, like sets. Schemas can also specify default values or indicate that an attribute is nullable.

import { Schema as S } from `@triplit/db`;

export const todoSchema = {
  todos: {
    schema: S.Schema({
      id: S.Id(),
      text: S.String(),
      completed: S.Boolean({ default: false }),
      created_at: S.String({ default: S.Default.now() }),
      tagIds: S.Set(S.String()),
    }),
  },
};

3. Construct a TriplitDB instance

import TriplitDB from `@triplit/db`;

const db = new TriplitDB({
  schema: todoSchema,
})

By default your data will be stored ephemerally in memory and not persist through page refreshes. To add persistent storage, initialize your TriplitDB instance with the IndexedDB storage engine. This will store your data in the browser’s IndexedDB database and persist through refreshes.

import TriplitDB, { IndexedDBStorage } from '@triplit/db';

const db = new TriplitDB({
  schema: todoSchema,
  source: new IndexedDBStorage('db-name'),
});

4. Define read and write queries

function createTodo(todoText, todoTags) {
  db.transact(async (tx) => {
    await tx.insert('todos', {
      text: todoText,
      tagIds: new Set(todoTags),
    });
  });
}

function fetchTodos() {
  db.fetch(db.query('todos').build());
}

TriplitDB queries support several filter operations. Read the docs for our client for more information.

How it works

Under the hood, TriplitDB utilizes a timestamped Triple Store to support efficiently merging changes from multiple sources whether that’s multiple writers or multiple storage layers. Each object that’s inserted is decomposed into a EAV triple of Entity (ID), Attribute (path in the object), and a Value. Each triple is stored with a Lamport Timestamp and treated as a Last Writer Wins Register (LWW). To support its tuple based storage system, TriplitDB uses Tuple Database as a generic querying interface and transaction manager.

Documentation

For more information and examples of TriplitDB in action, please refer to the official Triplit documentation. For the features listed below, the client exposes the same API as TriplitDB.

• Queries
• Mutations
• Schemas
• Storage

Contact us

We’re actively developing TriplitDB for use in the various parts of our fullstack product, Triplit, that provides a hosted syncing and storage service and a client library with wrappers for various front end frameworks.

If you're interested in helping us test Triplit or use it in a project, sign up here so we can get in touch with you.

The best way to get in touch is to join our Discord! We're here to answer questions, help developers get started with Triplit and preview new features.

You can follow us on Twitter/X to see our latest announcements, and check out our Roadmap to see everything we have planned.