Contributing

​

Layout

firstflow-oss/
├── packages/
│   ├── config-schema/      Types + Zod + Supabase migrations + SCHEMA.md
│   ├── sdk-frontend/        @firstflow/runtime React widget, blocks, persistence
│   └── sdk-backend/         @firstflow/runtime-server wrap, classifyIntent, aiclient
└── skills/                  AI authoring skill

​

Set up

git clone https://github.com/firstflowdev/firstflow-oss
cd firstflow-oss
pnpm install

pnpm build       # build config-schema → runtime/runtime-server
pnpm typecheck
pnpm test        # Vitest across all packages

pnpm --filter @firstflow/runtime test
pnpm --filter @firstflow/runtime-server test:watch
pnpm --filter @firstflow/config-schema build

​

Before you open a PR

• pnpm build, pnpm typecheck, pnpm test, and pnpm lint all pass.
• New behavior has tests (the packages use Vitest).
• Schema changes ship a new migration in packages/config-schema/supabase/migrations/ and a regenerated JSON schema (pnpm --filter @firstflow/config-schema build).
• Public API changes update the relevant README.md / SCHEMA.md.

​

Next