Skip to content

Convex replicator module#574

Draft
kobiebotha wants to merge 46 commits intomainfrom
module-convex
Draft

Convex replicator module#574
kobiebotha wants to merge 46 commits intomainfrom
module-convex

Conversation

@kobiebotha
Copy link
Contributor

@kobiebotha kobiebotha commented Mar 19, 2026

This adds support for Convex as a replication source. Since Convex itself is open source (technically also FSL), it was quite feasible for me to implement this.

As with any datastore, there are many quirks. I've attempted to document pertinent ones in a README.md in the module root. Required reading is the section titled "Mutation Transaction Atomicity".

To get a feel for the system, run the convex self-host-demo: https://github.com/powersync-ja/self-host-demo/tree/convex-demo. Then simply open two instances of the Convex React demo app (new) (http://localhost:3030) side by side.

When running the demo, to log into the Convex dashboard, you need to jump through some hoops:

  1. Check the container logs for the convex-keygen Docker container
  2. Get the "Admin key" printed to console

TODO

  • Test against Convex Cloud (it has been a while since I did that)
  • Fix replication metrics (currently reporting per transaction "page", should report per mutation?)
  • Update Test Connection logic to ensure that the powersync_checkpoints table and write mutation function exist
  • Measure replication performance
  • Docs

@changeset-bot
Copy link

changeset-bot bot commented Mar 19, 2026

⚠️ No Changeset found

Latest commit: 4b39e8a

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant