Skip to content

"welcome" in cursor (PLG-138)#4773

Merged
sergeibbb merged 4 commits intomainfrom
PLG-138-welcome-cursor
Jan 8, 2026
Merged

"welcome" in cursor (PLG-138)#4773
sergeibbb merged 4 commits intomainfrom
PLG-138-welcome-cursor

Conversation

@sergeibbb
Copy link
Member

@sergeibbb sergeibbb commented Dec 4, 2025 •
edited
Loading

Description

Solves #4769 (PLG-138)

Checklist

  • I have followed the guidelines in the Contributing document
  • My changes follow the coding style of this project
  • My changes build without any errors or warnings
  • My changes have been formatted and linted
  • My changes include any required corresponding changes to the documentation (including CHANGELOG.md and README.md)
  • My changes have been rebased and squashed to the minimal number (typically 1) of relevant commits
  • My changes have a descriptive commit message with a short title, including a Fixes $XXX - or Closes #XXX - prefix to auto-close the issue that your PR addresses

sergeibbb added a commit that referenced this pull request Dec 4, 2025
@sergeibbb
Adds welcome page webview for first-time installs
ce109d9 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 4, 2025
@sergeibbb
Layout of the header of the welcome page
ac8c9ee 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 4, 2025
@sergeibbb
Add interactive features carousel to Welcome view
26f2b36 
(#4769, #4773, PLG-138)
@sergeibbb sergeibbb force-pushed the PLG-138-welcome-cursor branch from 3cbff15 to d42e64d Compare December 4, 2025 19:37
sergeibbb added a commit that referenced this pull request Dec 4, 2025
@sergeibbb
Makes header of the welcome page responsive to the panel width
be7d1a8 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 4, 2025
@sergeibbb
Refines features carousel styling.
d42e64d 
Updates carousel styles for better visual consistency, including layout improvements, typography, and theming with VSCode variables. Enhances maintainability and prepares for future feature image integration.

(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Adds welcome page webview for first-time installs
f8d2533 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Layout of the header of the welcome page
fadb356 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Add interactive features carousel to Welcome view
f31629d 
(#4769, #4773, PLG-138)
@sergeibbb sergeibbb force-pushed the PLG-138-welcome-cursor branch from d42e64d to c88be87 Compare December 5, 2025 11:19
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Makes header of the welcome page responsive to the panel width
227872c 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Refines features carousel styling.
c88be87 
Updates carousel styles for better visual consistency, including layout improvements, typography, and theming with VSCode variables. Enhances maintainability and prepares for future feature image integration.

(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Enhances welcome UI for better scaling and narrow view support
2a2e99d 
Refines font sizing and spacing units from rem to em to improve
consistency and responsiveness across devices. Updates carousel
and feature card layouts for better display on small screens,
including improved media queries and more flexible padding.
Adjusts section and header styling to ensure readability and
visual alignment, especially on mobile.

(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Adds Pro trial action button for welcome webview
15ba438 
Introduces a new "Start GitLens Pro Trial" button to the welcome webview and tracks user interactions with a dedicated telemetry event. Updates telemetry documentation and types to include "welcome" as a source and to describe the new "welcome/action" event, enabling better insight into user engagement with onboarding and trial features.
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Add interactive features carousel to Welcome view
9b24fa6 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Makes header of the welcome page responsive to the panel width
4d14b71 
(#4769, #4773, PLG-138)
@sergeibbb sergeibbb force-pushed the PLG-138-welcome-cursor branch from 15ba438 to e0391fa Compare December 5, 2025 18:54
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Refines features carousel styling.
3321aea 
Updates carousel styles for better visual consistency, including layout improvements, typography, and theming with VSCode variables. Enhances maintainability and prepares for future feature image integration.

(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Enhances welcome UI for better scaling and narrow view support
247b428 
Refines font sizing and spacing units from rem to em to improve
consistency and responsiveness across devices. Updates carousel
and feature card layouts for better display on small screens,
including improved media queries and more flexible padding.
Adjusts section and header styling to ensure readability and
visual alignment, especially on mobile.

(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Separates feature card to a new file
d95e900 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Adds Pro trial action button for welcome webview
de01d4c 
Introduces a new "Start GitLens Pro Trial" button to the welcome webview and tracks user interactions with a dedicated telemetry event. Updates telemetry documentation and types to include "welcome" as a source and to describe the new "welcome/action" event, enabling better insight into user engagement with onboarding and trial features.
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Removes dummy text from welcome screen
fce517a 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Improves typography styling
3b892e0 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Refines cards layout
e4f7376 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Adds initial layout of scrollable cards
a1c3cbf 
(#4769, #4773, PLG-138)
@sergeibbb sergeibbb force-pushed the PLG-138-welcome-cursor branch from e0391fa to a1c3cbf Compare December 5, 2025 19:11
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Adds welcome page webview for first-time installs
7a472fb 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Layout of the header of the welcome page
0be97a2 
(#4769, #4773, PLG-138)
@sergeibbb sergeibbb force-pushed the PLG-138-welcome-cursor branch from a1c3cbf to ef69157 Compare December 5, 2025 19:15
sergeibbb added a commit that referenced this pull request Dec 5, 2025
@sergeibbb
Add interactive features carousel to Welcome view
7ca013a 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Removes dummy text from welcome screen
43ddcd3 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Improves typography styling
a96d455 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Refines cards layout
1c7cfea 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Adds initial layout of scrollable cards
a4e8eba 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Adds shadows to the sides of the scrollable narrow feature cards
5e5252a 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Revamps welcome UI with new feature cards and visuals
f8cab23 
Enhances the welcome experience by updating feature card titles and descriptions for clarity and engagement, introducing Launchpad as a highlighted feature, and adding new SVG and icon assets for a more polished and informative look.

Improves visual consistency and modernizes the feature showcase, making key tools like Commit Graph, Visual File History, Git Blame, and Launchpad more discoverable and appealing to users.
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Adds light and dark theme support for feature images
8413c16 
Introduces separate light and dark variants for feature SVG/WebP images and updates the UI to dynamically switch image sources based on the current theme. Improves accessibility and visual consistency for both light and dark VS Code themes. Also enhances CSS theming for high contrast modes and streamlines feature card background handling.

(#4769, #4773, PLG-138)
@sergeibbb sergeibbb force-pushed the PLG-138-welcome-cursor branch from 760a673 to 8413c16 Compare December 9, 2025 21:15
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Adds welcome page webview for first-time installs
2a55368 
(#4769, #4773, PLG-138)
@sergeibbb sergeibbb force-pushed the PLG-138-welcome-cursor branch from 8413c16 to 31f6c4b Compare December 9, 2025 21:30
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Layout of the header of the welcome page
0f225f6 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Add interactive features carousel to Welcome view
5329333 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Makes header of the welcome page responsive to the panel width
56741fb 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Refines features carousel styling.
684e5be 
Updates carousel styles for better visual consistency, including layout improvements, typography, and theming with VSCode variables. Enhances maintainability and prepares for future feature image integration.

(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Enhances welcome UI for better scaling and narrow view support
eeb68f7 
Refines font sizing and spacing units from rem to em to improve
consistency and responsiveness across devices. Updates carousel
and feature card layouts for better display on small screens,
including improved media queries and more flexible padding.
Adjusts section and header styling to ensure readability and
visual alignment, especially on mobile.

(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Separates feature card to a new file
cc1bc09 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Adds Pro trial action button for welcome webview
008fc34 
Introduces a new "Start GitLens Pro Trial" button to the welcome webview and tracks user interactions with a dedicated telemetry event. Updates telemetry documentation and types to include "welcome" as a source and to describe the new "welcome/action" event, enabling better insight into user engagement with onboarding and trial features.
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Removes dummy text from welcome screen
b8eab5b 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Improves typography styling
b1e0bc8 
(#4769, #4773, PLG-138)
sergeibbb added a commit that referenced this pull request Dec 9, 2025
@sergeibbb
Refines cards layout
d888907 
(#4769, #4773, PLG-138)
@sergeibbb
Copy link
Member Author

sergeibbb commented Dec 22, 2025

Hi @d13 Would you mind to review this PR?

Some places I'd like you to pay attention:

  1. Telemetry events
image
  1. Criteria to show overlay to unpaid users only (and other conditions as well):
image

cc @eamodio

@augmentcode
Copy link

augmentcode bot commented Dec 22, 2025

🤖 Augment PR Summary

Summary: Adds a new “Welcome” onboarding overlay to the Home webview for eligible new installs (Solves #4769 / PLG-138).

Changes:

  • Introduces new Lit components: gl-welcome-overlay, gl-welcome-page, and supporting carousel/card components.
  • Wires the Home webview to pass webroot and theme information down to the welcome experience.
  • Adds a persisted “collapsed” state for the welcome overlay via Home section storage and exposes it in the Home state.
  • Extends Home state with hostAppName to render the host editor name in the welcome UI.
  • Adds a new telemetry event (welcome/action) and registers welcome as a valid telemetry source.
  • Adds new media assets for the welcome carousel (light/dark variants).
  • Updates telemetry documentation to include the new welcome event and source.

Technical Notes: Overlay display is gated on new install + unpaid/trial state and can be dismissed/persisted via CollapseSectionCommand.

🤖 Was this summary useful? React with 👍 or 👎

augmentcode[bot]
augmentcode bot reviewed Dec 22, 2025
View reviewed changes
Copy link

@augmentcode augmentcode bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Review completed. 2 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

@d13
Copy link
Member

d13 commented Jan 7, 2026 •
edited
Loading

Hi @d13 Would you mind to review this PR?

Some places I'd like you to pay attention:

  1. Telemetry events
image 2. Criteria to show overlay to unpaid users only (and other conditions as well): image cc @eamodio

I think the telemetry is ok. I am a little concerned is not showing the welcome when "in trial or paid". The user's plan or trial could've initiated on another surface and then they lose out on the feature overviews.

@d13
Copy link
Member

d13 commented Jan 7, 2026

Beside my concern mentioned above, the code looks fine.

@sergeibbb
Adds welcome page webview for first-time installs
51491bd 
(#4769, #4773, PLG-138)
@sergeibbb
Hides welcome overlay for paid users
5fe4370 
(#4769, #4773, PLG-138)
@sergeibbb
Tracks welcome page carousel views and other events
ff322ba 
Adds telemetry to track the number of carousel pages
viewed on the welcome page. This data will help us understand
user engagement with the welcome page features.

(#4769, #4773, PLG-138)
@sergeibbb
Mentions new Welcome view in the CHANGELOG
c8680d0 
(#4769, #4773, PLG-138)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@d13 d13 d13 approved these changes

@eamodio eamodio Awaiting requested review from eamodio

+1 more reviewer

@augmentcode augmentcode[bot] augmentcode[bot] left review comments

Reviewers whose approvals may not affect merge requirements

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

17.9

Development

Successfully merging this pull request may close these issues.

Open a custom view that messages Pro benefits after installing GL in Cursor (and other IDEs that do not support the VSC walkthrough)

3 participants

@sergeibbb @d13 @justinrobots