binsby

CLI wrapper for Binsby tooling. Provides the binsby command, which delegates to framework sub-commands.

Installation

The CLI is included as a dependency of any Binsby app. It is available as binsby in node_modules/.bin.

binsby <command> [options]

Commands

| Command | Description | |---------|-------------| | build | Builds the app (SSR server + client bundles). Runs pnpm run build in the resolved app root. | | ssg | Builds the app then runs static site generation via binsby-ssg, outputting to dist/static. | | hybrid | Same as ssg, but also builds the @bgunnarsson/binsby-ssg package first when running in a monorepo. | | static | Builds the app and renders a fully static dist/static output (sets BINSBY_SSG_STATIC=1). In a monorepo, also builds @bgunnarsson/binsby-ssg first. |

Options

| Flag | Description | |------|-------------| | --insecure | Disables TLS certificate validation by setting NODE_TLS_REJECT_UNAUTHORIZED=0. Useful for local development with self-signed certs. Applies to ssg, hybrid, and static commands. |

Exports

| Export | Description | |--------|-------------| | BinsbyCommand | TypeScript type representing valid CLI commands: 'build' \| 'ssg' \| 'hybrid' \| 'static'. |

Notes

• The binsby-ssg package also exposes its own binsby-ssg binary. Both are equivalent for SSG.
• The CLI is intentionally thin — most functionality lives in the individual packages it delegates to.
• The CLI automatically resolves the app root by looking for binsby.config.ts, standard app entry points, or pnpm-workspace.yaml (monorepo detection).