CONTRIBUTING.md

Contributing to SQLSync

This document attempts to explain how to work on SQLSync itself. Buckle up, it's pretty rough and is changing fast.

Dependencies

• Just
• Rust
• wasm-pack
• node.js
• pnpm

Build Wasm artifacts

just run-with-prefix 'wasm-'
just wasm-demo-reducer --release
just package-sqlsync-worker dev

Local Coordinator

[!WARNING] Currently this seems to require modifying the wrangler.toml config file to point at your own Cloudflare buckets (even though they aren't being used). Work is underway to replace the local coordinator with a wrangler agnostic alternative optimized for local development.

cd demo/cloudflare-backend
pnpm i
pnpm dev

# then in another shell
just upload-demo-reducer release local

Local Todo Demo

cd demo/frontend
pnpm i
pnpm dev

Then go to http://localhost:5173

Run some tests

These tests are useful for learning more about how SQLSync works.

just unit-test
just test-end-to-end-local
just test-end-to-end-local-net

Community & Contributing

If you are interested in contributing to SQLSync, please join the Discord community and let us know what you want to build. All contributions will be held to a high standard, and are more likely to be accepted if they are tied to an existing task and agreed upon specification.