Agent skill · supabase
dev-toolbar-review
Safety rules for the dev toolbar, PostHog client, and feature flags. Use
What it needs
About 3k tokens when loaded.
What this skill does
Dev Toolbar Review Guide Review checklist for PRs touching the dev toolbar (packages/dev-tools/) and its integration points in packages/common/. The toolbar surfaces telemetry events and allows feature flag overrides in local and staging environments only. When This Applies PRs modifying any of these paths need growth eng review: packages/dev-tools/ (owned by @supabase/growth-eng in CODEOWNERS) packages/common/posthog-client.ts (flag override reads, event subscription) packages/common/feature-flags.tsx (flag override merge logic) App-level mounting: DevToolbarProvider/DevToolbar/DevToolbarTrigger in apps/studio/, apps/www/, apps/docs/ Note: posthog-client.ts and feature-flags.tsx are NOT in CODEOWNERS for growth-eng, so PRs touching only those files won't auto-request review. Watch for these in the PR feed. Review Checklist 1. Environment Guards Files: packages/dev-tools/index.ts, DevToolbar.tsx, DevToolbarTrigger.tsx, DevToolbarContext.tsx The toolbar uses two layers of protection: Build-time tree-shaking in index.ts: the bundler inlines process.env.NEXTPUBLICENVIRONMENT, so isToolbarEnabled = env === 'local' env === 'staging' makes the export ternaries static. Outside those two environments every export is a stub (DevToolbar and DevToolbarTrigger render null, DevToolbarProvider passes children through, useDevToolbar returns a no-op context) and the implementation modules are eliminated from the bundle. The same literal process.env check is duplicated in DevToolbarContext.tsx, DevToolbar.tsx, DevToolbarTrigger.tsx, and feature-flags.tsx because the bundler must see it directly — keep them in sync. Runtime guards inside the implementation: ISLOCALDEV = env === 'local' gates the local-only pieces — the SSE event stream in DevToolbarContext.tsx and local-only UI in DevToolbar.tsx — so staging gets the toolbar without them. Check for: Guards being removed or broadened. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills supabase/dev-toolbar-review--b7858b