PowerSync keeps a client-side SQLite database in sync with your backend database. Changes appear across users and devices in real-time, user interactions feel instant and your app continues to work even when offline. Supports Postgres, MongoDB, MySQL, and SQL Server. Client SDKs are available for a wide range of environments including web, mobile, desktop, headless and embedded.

powersync-js is the monorepo for PowerSync JavaScript SDKs.

• packages/react-native

  • React Native SDK implementation (extension of packages/common)

• packages/web

  • JS Web SDK implementation (extension of packages/common)

• packages/node

  • Node.js client implementation (extension of packages/common)

• packages/react

  • React integration for PowerSync.

• packages/vue

  • Vue composables for PowerSync.

• packages/tanstack-query

  • TanStack Query integration for React.

• packages/attachments

  • Attachments helper package for React Native and JavaScript/TypeScript projects (deprecated).

• packages/attachments-storage-react-native

  • React Native file system storage adapters for PowerSync attachments (alpha).

• packages/kysely-driver

  • Kysely integration (ORM) for React Native and JavaScript/TypeScript projects.

• packages/drizzle-driver

  • Drizzle integration (ORM) for React Native and JavaScript/TypeScript projects.

• packages/common

  • Shared package: TypeScript implementation of a PowerSync database connector, streaming sync bucket implementation and attachment utilities.

Demo applications are located in the demos/ directory. Also see our Demo Apps / Example Projects gallery which lists all projects by the backend and client-side framework they use.

• demos/react-native-supabase-todolist: A React Native to-do list example app using a Supabase backend.
• demos/react-native-supabase-group-chat: A React Native group chat example app using a Supabase backend.
• demos/react-native-supabase-background-sync: A React Native example app demonstrating background sync using PowerSync, Expo and Supabase.
• demos/react-native-web-supabase-todolist A React Native to-do list example app using a Supabase backend that's compatible with React Native for Web.

• demos/react-supabase-todolist: A React to-do list example app using the PowerSync Web SDK and a Supabase backend.

• demos/react-supabase-todolist-tanstackdb: A React to-do list example app using the PowerSync Web SDK and a Supabase backend + TanStackDB collections.

• demos/react-supabase-time-based-sync: A React demo using Sync Streams to subscribe to date-filtered data dynamically, with a Supabase backend.

• demos/react-multi-client: A React widget that illustrates how data flows from one PowerSync client to another.

• demos/yjs-react-supabase-text-collab: A React real-time text editing collaboration example app powered by Yjs CRDTs and Tiptap, using the PowerSync Web SDK and a Supabase backend.

• demos/vue-supabase-todolist: A Vue to-do list example app using the PowerSync Web SDK and a Supabase backend.

• demos/angular-supabase-todolist An Angular to-do list example app using the PowerSync Web SDK and a Supabase backend.

• demos/example-webpack: A minimal example demonstrating bundling with Webpack.

• demos/example-vite: A minimal example demonstrating bundling with Vite.

• demos/example-vite-encryption: A minimal example demonstrating web encryption.

• demos/example-nextjs: An example demonstrating setup with Next.js.

• demos/example-electron An Electron example web rendered app using the PowerSync Web SDK in the renderer process.
• demos/example-electron-node An Electron example that runs PowerSync in the main process using the PowerSync Node.js SDK.

• demos/example-capacitor A Capacitor example app using the PowerSync Web SDK.

• demos/example-node A small CLI example built using the PowerSync SDK for Node.js.

• tools/diagnostics-app: A standalone web app that presents stats about a user's local database (incl. tables and sync buckets).

This monorepo uses pnpm.

Install workspace dependencies

pnpm install

Build packages

pnpm build:packages

Some packages use Playwright for testing. Install Playwright dependencies with:

pnpm exec playwright install-deps
pnpm exec playwright install

Development packages can be published by manually triggering the release workflow. Development packages are versioned as 0.0.0-{tag}-DATETIMESTAMP.

For technical npm reasons, publishing dev and release packages needs to happen from within a single workflow. release.yml contains checks to only release dev packages when triggered by workflow_dispatch.

Pull requests should contain Changesets for changed packages.

Add changesets with

pnpm changeset add

Merging a PR with Changesets will automatically create a PR with version bumps. That PR will be merged when releasing.

By default, the PowerSync React Native SDK uses a fork of react-native-quick-sqlite

Testing live development changes to @journeyapps/react-native-quick-sqlite will not work with standard yarn link commands. Metro does not work well with symlinks react/metro#286.

The process of releasing development packages for @journeyapps/react-native-quick-sqlite for each change can be tedious and slow. A faster (and hackier) method is to use mtsl which will watch and copy the package into this workspace's node_modules.

npm install -g mtsl

mtsl add -s "[source path to your react-native-quick-sqlite repo folder]" -d "[this workspaces root node_modules folder]"/@journeyapps/react-native-quick-sqlite

mtsl start "[the id returned from step above]"