Triplit

A full-stack, syncing database that runs on both server and client. Pluggable storage (indexeddb, sqlite, durable objects), syncs over websockets, and works with your favorite framework (React, Solid, Vue, Svelte).
GitHub
2.31k
Created a year ago, last commit 2 days ago
18 contributors
2.32k commits
Stars added on GitHub, month by month
N/A
11
12
1
2
3
4
5
6
7
8
9
10
2023
2024
Stars added on GitHub, per day, on average
Yesterday
+1
Last week
+2.3
/day
Last month
+4.1
/day
npmPackage on NPM
Monthly downloads on NPM
11
12
1
2
3
4
5
6
7
8
9
10
2023
2024
README

Triplit banner

Overview

Triplit is an open-source database that syncs data between server and browser in real-time.

Triplit provides a real-time syncing datastore that you can drop into your app as a Typescript package. Triplit handles storing your data on the server and intelligently syncs your queries to your clients. We call this type of system a โ€œfull stack databaseโ€โ€”you can watch our presentation to the Local First community on this new paradigm here.

Triplit brings together:

๐Ÿ”„ย Real-time sync with incremental updates and conflict resolution at the property level

๐Ÿ  Local caching powered by a full-fledged client-side database

๐Ÿ’ฝ Durable server-side storage with an admin dashboard

๐Ÿ”Œ Pluggable storage providers like SQLite, IndexedDB, LevelDB, Memory, etc

๐Ÿ˜ƒ Optimistic updates to make every interaction feel fast

๐Ÿ”—ย Relational querying for complex data models

๐Ÿ›ซย Offline-mode with automatic reconnection and consistency guarantees

๐Ÿ”™ Rollback and retry management on failed updates

๐Ÿ—‚๏ธย Schemas for data safety and Typescript autocompletion

๐Ÿ”ย Authorization that's enforced on the server for both read and writes

๐Ÿคย Collaboration/Multiplayer powered by CRDTs

๐ŸŽ๏ธ Low latency with minimal network traffic using delta patches

๐Ÿ“ Simple API for querying and mutating data in both vanilla Javascript and React

โœ…ย Fully open-source!

Monorepo Overview

In triplit/packages you can find the various projects that power Triplit:

  • TriplitDB - 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.
  • Client - Browser library to interact with local and remote TriplitDBs.
  • CLI - CLI tool with commands to scaffold a project, run the full-stack development environment, migrate a server, and more.
  • React - React bindings for @triplit/client.
  • Svelte - Svelte bindings for @triplit/client.
  • Console - App for viewing and mutating data in Triplit projects and managing their schemas.
  • Server - Node server for syncing data between Triplit clients.
  • Server-core - Protocol agnostic library for building servers running Triplit.
  • Docs - Triplit docs, built with Nextra.
  • Types - Shared types for various Triplit projects.
  • UI - Shared UI components for Triplit frontend projects, built with shadcn.

Quick Start

Start a new project.

npm create triplit-app@latest my-app

Or add the dependencies to an existing project.

npm install --save-dev @triplit/cli
npm run triplit init

Define a schema in my-app/triplit/schema.ts.

import { Schema as S, ClientSchema } from '@triplit/client';

export const schema = {
  todos: {
    schema: S.Schema({
      id: S.Id(),
      text: S.String(),
      completed: S.Boolean({ default: false }),
    }),
  },
} satisfies ClientSchema;

Start the Triplit development sync server.

npm run triplit dev

This will output some important environmental variables that your app will need to sync with the server. Add them to your .env file (Vite example below).

VITE_TRIPLIT_SERVER_URL=http://localhost:6543
VITE_TRIPLIT_TOKEN=copied-in-from-triplit-dev

Define a query in your App (React example below).

import { TriplitClient } from '@triplit/client';
import { useQuery } from '@triplit/react';
import { schema } from '../triplit/schema';

const client = new TriplitClient({
  schema,
  serverUrl: import.meta.env.VITE_TRIPLIT_SERVER_URL,
  token: import.meta.env.VITE_TRIPLIT_TOKEN,
});

function App() {
  const { results: todos } = useQuery(client.query('todos'));

  return (
    <div>
      {Array.from(todos.values()).map((todo) => (
        <div key={todo.id}>
          <input
            type="checkbox"
            checked={todo.completed}
            onChange={() =>
              client.update('todos', todo.id, (todo) => ({
                todo.completed = !todo.completed,
              })
            }
          />
          {todo.text}
        </div>
      ))}
    </div>
  );
}

Start your app, open another browser tab, and watch the data sync in real-time.

Read the full getting started guide here. For an even more detailed and explanatory tutorial, check out this step-by-step guide to building a real-time todo app with Triplit, Vite, and React.

Contact us

If you're interested in getting early access to Triplit Cloud (currently in developer preview), sign up here to join the waitlist.

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.