Greysight

Greysight is an open source Snowflake cost observability tool. The MVP is a locally testable Next.js and FastAPI dashboard with deterministic demo data, optional Supabase auth, and optional Snowflake Account Usage queries.

Quick Start

Install dependencies from the repository root:

npm install --ignore-scripts

Start the local web and API servers:

npm run dev

The web app runs at http://localhost:3000, and the FastAPI backend runs at http://localhost:8000. With the default local settings, DATA_SOURCE=demo and AUTH_REQUIRED=false, the dashboard can render demo data without Supabase or Snowflake credentials.

Project Structure

• apps/web/: Next.js dashboard, auth/org UI, browser API clients, and web tests.
• apps/api/: FastAPI routes, auth/org guards, Snowflake access, metric services, and API tests.
• sql/snowflake/: approved Snowflake Account Usage source queries.
• sql/dashboard_sources.yml: dataset registry for source and derived dashboard datasets.
• supabase/migrations/: Supabase schema, RLS policies, org memberships, audit events, and aggregate dataset tables.
• docs/: setup, Snowflake, deployment, security, specs, and implementation plans.

Docs

• Local development: docs/local-development.md
• Snowflake setup: docs/snowflake-setup.md
• Security model: docs/security-model.md
• Deployment: docs/deployment.md
• Dependency compatibility: docs/dependency-compatibility.md

Savings estimate generation is post-MVP and is not included in the dashboard.