Tooling packages

Internal-only packages that exist to support the build, codegen, and CLI workflows of the workspace. Most are not imported by app code at runtime.

packages/build-icons

Generates the React icon components in packages/icons. Reads source SVGs, optimizes them, and emits typed components.

packages/dev-tools

Studio-side dev-only utilities. Installed as a workspace dependency in apps/studio and used to expose extra diagnostics during development. Not pulled into production builds.

packages/generator

Code-generation helpers — used by apps/docs/generator/ and the various spec-driven reference pipelines. Owns shared logic for turning a YAML/JSON spec into MDX/TSX.

packages/pg-meta-cli (when present)

Optional CLI wrapper around packages/pg-meta — useful for one-off SQL generation outside Studio.

How they relate

graph LR
    BuildIcons[build-icons] -->|emits| Icons[packages/icons]
    Generator[generator] -->|drives| DocsGen[apps/docs/generator]
    DevTools[dev-tools] -->|imported by| Studio[apps/studio]

These packages are deliberately small and orthogonal. They are not published to npm.

Entry points for modification

• Update the icon build pipeline → packages/build-icons.
• Extend Studio dev-only tooling → packages/dev-tools.
• Touch how a doc spec turns into pages → packages/generator and the consumer in apps/docs/generator/.