cloud-saas-mode

What problem does it solve?

This skill solves the challenge of maintaining consistent, drift-free functionality across chmonitor's Cloud SaaS offering and self-hosted open-source edition, which share a single codebase but have distinct runtime behaviors for hosts, user access, and onboarding flows.

Core Features & Use Cases

• Cloud Mode Flag Management: Configure and validate the runtime flag that toggles between SaaS and self-hosted behavior, ensuring fail-closed defaults that never break core self-hosted monitoring features.
• User Flow Configuration: Manage welcome/setup onboarding pages, demo host visibility for anonymous vs signed-in users, and per-user ClickHouse connection storage for SaaS deployments.
• Connection Error Handling: Implement and update the connection error classifier that provides user-friendly error messages and linked documentation for common connection issues like invalid credentials, DNS failures, or TLS errors.
• Use Case Example: When adding a new connection error type for expired ClickHouse API keys, use this skill to follow the existing classification pattern, update the error docs link, and ensure the change does not affect self-hosted deployments.

Quick Start

Use the cloud-saas-mode skill to update the welcome page to show a new onboarding step for SaaS users connecting their first ClickHouse host, following the existing variant logic for signed-in and anonymous users.