Skip to content

feat: add notebooks onboarding modal and in-notebook MCP promo#585

Open
emrberk wants to merge 4 commits into
mainfrom
feat/notebooks-onboarding
Open

feat: add notebooks onboarding modal and in-notebook MCP promo#585
emrberk wants to merge 4 commits into
mainfrom
feat/notebooks-onboarding

Conversation

@emrberk

@emrberk emrberk commented Jul 6, 2026

Copy link
Copy Markdown
Collaborator

What

Adds a first-run onboarding experience for Notebooks:

  • Two-step onboarding modal — Step 1 introduces Notebooks (organise queries/results/charts, build dashboards); Step 2 pitches the QuestDB MCP connection with a copy-ready setup command and an animated agent transcript.
  • In-notebook MCP promo — a collapsible/dismissable card surfaced inside notebooks (list, grid, and empty states).
  • Reusable piecesMcpSetupCommand (copy-command box) and a CopyButton icon prop so callers can supply their own glyph.

How it works

Visibility is driven by a new notebook.onboarding localStorage blob (mcpEverConnected, showNotebookPromo, showMcpPromo, collapseMcpPromo) exposed through LocalStorageProvider. Pure predicates in utils/notebookOnboarding.ts decide what shows; all onboarding surfaces are suppressed for good once an MCP bridge has ever connected (MCPBridgeProvider flips mcpEverConnected on first connect).

Tests

  • Unit tests for the visibility predicates (notebookOnboarding.test.ts, 8 tests).
  • yarn typecheck, yarn lint, and yarn build all pass.
Screenshot 2026-07-06 at 14 00 18-small Screenshot 2026-07-06 at 14 00 31-small Screenshot 2026-07-06 at 14 03 36-small

🤖 Generated with Claude Code

emrberk and others added 4 commits July 6, 2026 13:55
Introduce a two-step onboarding modal that presents Notebooks and the
QuestDB MCP connection on first use, alongside a collapsible in-notebook
MCP promo. Visibility is tracked in localStorage and suppressed once an
MCP bridge has ever connected.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant