may-db workspace

This repository is a pnpm workspace with four packages:

• sdk: framework-agnostic publishable may-db SDK (@may-db/core)
• react: React bindings for the SDK (@may-db/react)
• example: living spreadsheet app that consumes the SDK
• example-tiny: minimal runnable app for the SDK README snippet

Install

pnpm install

Common commands

pnpm dev      # run example app
pnpm build    # build sdk, react, then example
pnpm lint     # lint sdk, react, and example
pnpm preview  # preview example build

Package-specific commands

pnpm --filter ./sdk build
pnpm --filter ./sdk lint
pnpm --filter ./react build
pnpm --filter ./react lint
pnpm --filter ./example dev
pnpm --filter ./example build
pnpm --filter ./example-tiny dev
pnpm --filter ./example-tiny build

Notes

• example resolves @may-db/core to ../sdk/src/index.ts and @may-db/react to ../react/src/index.ts in Vite/TypeScript so both packages can evolve together without manual prebuilds.
• The SDK publish artifact is produced from sdk/dist via pnpm --filter ./sdk build.
• The React publish artifact is produced from react/dist via pnpm --filter ./react build.
• Current tested Matrix dependency pair for @may-db/core: matrix-crdt@0.2.1-alpha.1 with matrix-js-sdk@40.2.0.