Skip to content

Show a welcome dialog on first launch - #7

Merged
robertsolves merged 4 commits into
mainfrom
claude/project-thread-yfehvi
Nov 3, 2026
Merged

robertsolves merged 4 commits into
mainfrom
claude/project-thread-yfehvi

Conversation

@robertsolves

@robertsolves robertsolves commented Nov 3, 2026 •

Copy link
Copy Markdown
Collaborator

Requested by Robert · project thread

What & why

New users, especially on web, landed on an empty window with no hint of what to do. This adds a centered welcome dialog (lib/shell/welcome_dialog.dart) with the dbscope logo. It explains what dbscope does and walks through three steps: connect, explore tables, and ask questions. The web copy explains that the browser connects through dbscope_pg_proxy and links to its README and the Mac app.

  • Add a connection… closes the dialog and starts the normal new-connection flow. Not now just closes it.
  • It opens by itself only in the host window, and only when all of these hold: it was never closed before (ui.welcomeSeen in UiPrefs), no connections are saved, and no DBSCOPE_AUTO_* launch is connecting. That rule is shouldShowWelcome, which has unit tests.
  • A new Help ▸ Welcome… menu item reopens it.
  • The logo is the existing assets/icon/dbscope_icon.png (the one the README shows), now bundled as an app asset.

How it was tested

  • New test/welcome_dialog_test.dart covers the show/skip rule and which choice each button reports. I checked that it fails when the saved-profiles rule is removed.
  • Built the web app and drove it in headless Chromium at desktop and phone widths. The dialog shows on first load, Add a connection… opens the connection picker, and after the dialog is closed a reload no longer shows it. Not run on macOS (no Mac in this environment).

Checklist

  • fvm flutter analyze is clean
  • fvm flutter test passes
  • SQL safety invariants in CLAUDE.md still hold (no SQL touched)
  • No credentials, API keys or .dbscopeconn files in the diff

🤖 Generated with Claude Code

https://claude.ai/code/session_01EqzDdWzfPSsP9QJdLV4Hus

New users on web landed on an empty window with no hint of what to do.
A centered dialog now explains what dbscope does, how to connect (the
web copy explains the pg proxy), and what to try next, with an
"Add a connection…" button that starts the connection flow. It opens
once, only when no connections are saved and no command-line
auto-connect is running, and Help ▸ Welcome… reopens it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EqzDdWzfPSsP9QJdLV4Hus
Bundles the existing assets/icon/dbscope_icon.png (the same file the
README shows) as an app asset.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EqzDdWzfPSsP9QJdLV4Hus
@robertsolves
robertsolves changed the base branch from claude/project-thread-sroiel to main November 3, 2026 09:25
@robertsolves
robertsolves merged commit dae1dbd into main Nov 3, 2026
4 checks passed
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.

2 participants