Documentation

Install Persist and create your first local-first store in under five minutes.

How Persist keeps your data on the device first and syncs when connectivity is available.

Persist provides four store classes: records, events, blobs, and key-value.

Pluggable storage backends that let you swap between SQLite, Postgres, S3, and P2P without changing application code.

How Persist replicates data across devices using a queue-based sync engine with pluggable conflict resolution.

Envelope encryption with Ed25519 signing for end-to-end data protection across devices.

Declarative replication, encryption, and retention policies for governing data lifecycle.

Embedded SQLite storage with WAL mode, zero configuration, and full offline support.

Use PostgreSQL as a remote storage backend with connection pooling, schema migrations, and full sync support.

Store blobs in S3-compatible object storage with multipart uploads, presigned URLs, and R2 support.

Direct device-to-device replication using libp2p with peer discovery, trust management, and NAT traversal.

Install and use @cuitty/persist — the primary TypeScript SDK for records, events, blobs, and kv.

Use cuitty-persist from Python with sync and async APIs for records, events, and kv.

Manage Persist stores, inspect data, and run operations from the command line.

Complete API reference for records, events, blobs, and kv store methods.

Complete persist.config.ts format with all options for stores, adapters, sync, encryption, and retention.

Hook into store lifecycle events for logging, monitoring, and custom side effects.

Deploy a Persist sync server with Docker, configure TLS, and connect devices.

Migrate data between adapters using the export/import pipeline without downtime.

Set up P2P replication, pair devices, establish trust, and keep data in sync across laptops, phones, and servers.