Colors

package-wavehouse-red

TypeScript / Bun

Provisions a public WaveHouse analytics demo — ClickHouse, the WaveHouse gateway, and the live GitHub stats dashboard — on one Vultr instance with Red.

Installation
npx skills add https://github.com/getcolors/wavehouse --skill package-wavehouse-red

SKILL.md

WaveHouse demo with Red

Operate one WaveHouse demo deployment from non-secret colors.yml. Read references/configuration.md before changing configuration or running a lifecycle operation.

The demo serves the WaveHouse stats dashboard (the upstream project's own dogfooding page) for the configured GitHub repository: history is backfilled from the GitHub API at create time and a 60-second poller keeps the live feed streaming over SSE.

Safety

  • Keep credentials in gitignored .envrc.private as COLORS_PAR_* variables.
  • Never set COLORS_PAR_PROFILE or edit/commit .colors/.
  • Keep compute-prevent-destroy: true; deletion requires separate explicit authorization and a one-run environment override.
  • Build and dry-run before a real create.
  • Only Caddy 80/443 and key-only SSH are public; the gateway's operator key is generated on the server and never leaves it.
./red build
./red create --dry-run
./red create

Bun runs the launcher; create and delete also need OpenTofu and Ansible. Exit code 2 is validation or usage failure and lists every problem at once. The launcher walks up from the working directory to find colors.yml.

Real create ends with public HTTPS health, dashboard, and backfilled-data acceptance checks.