Monorepo

Use a root config to run every app of a monorepo with one command and to write merged OpenAPI documents. A seampact.config.yaml at the root lists the apps. Each app keeps its own config.

# seampact.config.yaml at the repository root
sources:
  notes:
    path: ./contract
apps: [web, admin]
openapi:
  all:
    path: openapi/all.yaml
checks:
  openapi: error

Run seampact generate and seampact check from the root: they run every app, then write the merged document all.

Each app picks its own stack. Two frontends of one root can use different query libraries, in their own configs. Each app config holds the client entry once:

web/seampact.config.yaml

sources:
  notes:
    path: ../contract
targets:
  - { id: types, use: "@seampact/codegen-ts", apis: [notes] }
  - { id: client, use: "@seampact/codegen-fetch", apis: [notes], link: { types: types } }
  - { id: queries, use: "@seampact/codegen-react", apis: [notes], options: { query: tanstack }, link: { client: client } }

# admin/seampact.config.yaml (same sources and `client` entry as web)
targets:
  - { id: queries, use: "@seampact/codegen-react", apis: [notes], options: { query: swr }, link: { client: client } }

Root keys: Config reference.

Next

• Check it in CI.