bino build

bino build is the main command for producing PDFs from your report bundle. It validates manifests, runs SQL in DuckDB, and renders PDFs via Playwright.

Usage

bino build [flags]

Common flags:

• --work-dir – report bundle directory (default: .).
• --out-dir – output directory relative to workdir (default: dist).
• --include – build only specified report names (can be repeated).
• --exclude – skip specified report names (can be repeated).
• --browser – browser engine for Playwright (for example chromium, firefox, webkit).
• --no-graph – skip writing dependency graph files.
• --log-sql – log executed SQL queries.

Examples

Build all reports in the current directory:

bino build

Build only selected artefacts:

bino build --include monthly_sales --include annual_sales

Change the output directory and log SQL:

bino build --out-dir dist/reports --log-sql

CI tips

• Use --work-dir to point at the repository checkout.
• Fail builds early by ensuring environment variables for secrets are set.
• Archive the dist/ directory as a build artefact.