Add first-run welcome overlay for new users#28
Open
lucaslosantos wants to merge 1 commit intopablodelucca:mainfrom
Open
Add first-run welcome overlay for new users#28lucaslosantos wants to merge 1 commit intopablodelucca:mainfrom
lucaslosantos wants to merge 1 commit intopablodelucca:mainfrom
Conversation
Shows a centered card over the empty office when no agents exist yet, guiding new users through the three steps needed to get started: install Claude Code, sign in, then click + Agent. The overlay disappears naturally as soon as the first agent is created, so it does not interfere with normal use. Changes: - `WelcomeOverlay.tsx` — new component (components/ pattern) - `constants.ts` — CLAUDE_CODE_INSTALL_CMD extracted per project rules - `App.tsx` — render overlay when agents.length === 0 and not in edit mode Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Author
|
@pablodelucca let me know if you would like me to modify it in any way. excited to contribute to such a cool project |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Adds a
WelcomeOverlaycomponent that appears over the empty office when no agents exist yet. It walks new users through the three steps required to get started — install Claude Code, sign in, then click + Agent — without leaving the panel.The overlay disappears automatically as soon as the first agent is created, so it has no impact on regular use.
Why
Without this, opening the panel for the first time shows an empty office with no indication of what to do next. The only affordance is the + Agent button, but clicking it does nothing useful if Claude Code isn't installed. This makes the first experience confusing, especially for people who aren't already familiar with Claude Code - which is one of the main gains of this extension.
Changes
webview-ui/src/components/WelcomeOverlay.tsxwebview-ui/src/constants.tsCLAUDE_CODE_INSTALL_CMDadded per project constant conventionswebview-ui/src/App.tsx<WelcomeOverlay />whenagents.length === 0 && !isEditModeDesign decisions
pointerEvents: noneso the office canvas, zoom controls, and bottom toolbar remain fully interactive behind the card.2px solidborder, hard offset shadow,--pixel-*CSS variables — matches all other overlays in the project.constants.ts: the install URL is centralised so it's easy to update if the URL ever changes, consistent with project rules.How to test
npm run buildand press F5 to open the Extension Development HostScreenshots
The overlay as seen on first open (no agents):
