[READ-ONLY] Mirror of https://github.com/flo-bit/contrail. atproto backend in a bottle flo-bit.dev/contrail
contrail development.md
1.0 kB

Contrail development #

Pre-alpha. Expect breaking changes.

Layout #

Contrail now has one package and one implementation:

packages/contrail/
  src/core/       ingestion, storage, queries, hydration
  src/adapters/   SQLite and PostgreSQL adapters
  src/worker/     Cloudflare Worker helper
  src/cli/        operational commands

Reference deployments live under apps/:

  • cloudflare-workers — minimal Worker + D1;
  • benchmark — disposable local-D1 backfill benchmarks;
  • postgres — minimal Node.js + PostgreSQL; and
  • sveltekit-cloudflare-workers — SvelteKit + D1.

Setup #

pnpm install
pnpm build
pnpm typecheck
pnpm test

Focused commands:

pnpm --filter @atmo-dev/contrail build
pnpm --filter @atmo-dev/contrail test
pnpm --filter contrail-cloudflare-workers-example dev
pnpm bench --config calendar.config.json --concurrency 100

Releasing #

Changesets version and publish @atmo-dev/contrail:

pnpm changeset
pnpm changeset version
pnpm release