Thanks to visit codestin.com
Credit goes to github.com

Skip to content

feat: Updated onboarding flow with contextual screens #5457

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Draft
markijbema wants to merge 24 commits into
base: main
Choose a base branch
from
Draft

feat: Updated onboarding flow with contextual screens #5457

markijbema wants to merge 24 commits into from

Conversation

@markijbema
Copy link
Contributor

@markijbema markijbema commented Jan 28, 2026

Overview

This PR implements the updated onboarding flow based on product owner specifications.

Changes

New Components

  • OnboardingStateDetector - Detects workspace and editor state
  • RateLimitMonitor - Tracks API usage and rate limiting
  • NoFolderNoHistoryScreen - Welcome screen for new users
  • FolderNoHistoryScreen - Contextual prompts for existing projects
  • PaidModelScreen - Handles paid model selection
  • RateLimitNotification - In-chat rate limit notification
  • FunProjectSuggestions - Quick start project ideas
  • ContextualPrompts - Context-aware prompt suggestions

Updated Components

  • WelcomeViewProvider - Integrated new screens with conditional rendering
  • webviewMessageHandler - Added handlers for new message types
  • ExtensionMessage types - Added new message type definitions

Translation Updates

  • Added English translations for all new screens and components

Features

  1. Adaptive Initial Screen

    • Shows different content based on workspace state
    • No folder: Open Folder, Clone Repository, Fun Projects
    • Has folder: Contextual prompts based on editor state

  2. Contextual Prompts

    • Adapts to editor state (open file, selected code)
    • Generic prompts suitable for any project type

  3. Rate Limiting

    • Tracks free model usage (50 requests/hour)
    • Shows in-chat notification when limit reached
    • Countdown timer for reset time

  4. Simplified Operations

    • Uses VSCode native commands for folder opening
    • Uses VSCode native git.clone for repository cloning

Testing

  • Manual testing of all onboarding paths
  • Test with no folder open
  • Test with folder open but no history
  • Test with existing session history
  • Test rate limit notification
  • Test fun project suggestions
  • Test contextual prompts

Notes

This is a v1 implementation focusing on core functionality. Future enhancements could include:

  • AI-powered repository search by description
  • Automatic workspace reopening after clone
  • Project type detection for more specific prompts
  • Different rate limits for authenticated vs anonymous users

@markijbema
feat(onboarding): add OnboardingStateDetector service
1020adf
@markijbema
feat(rate-limiting): add RateLimitMonitor service
69ba7f6
@markijbema
feat(onboarding): add message handlers for workspace state, editor st…
e0b531e 
…ate, rate limiting, and folder operations
@markijbema
feat(onboarding): add FunProjectSuggestions component
bb667f8
@markijbema
feat(onboarding): add ContextualPrompts component
c2eba25
@markijbema
feat(onboarding): add NoFolderNoHistoryScreen component
d31df99
@markijbema
feat(onboarding): add FolderNoHistoryScreen component
4e44e80
@markijbema
feat(onboarding): add PaidModelScreen component
13c9014
@markijbema
feat(onboarding): add RateLimitNotification component
11ed01b
@markijbema
feat(i18n): add English translations for new onboarding screens
4db53b9
@markijbema
feat(onboarding): integrate new screens into WelcomeViewProvider
599650a
@markijbema
feat(types): add message types for onboarding flow
5f70f30
@markijbema
chore: add changeset for onboarding flow update
5b0bcf4
@markijbema
fix: Type errors in onboarding components
679f478
@changeset-bot
Copy link

changeset-bot bot commented Jan 28, 2026 •
edited
Loading

🦋 Changeset detected

Latest commit: 64da6a0

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
kilo-code Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@chrarnoldus chrarnoldus force-pushed the mark/onboarding-flow-update branch from bef476f to fc4847c Compare January 28, 2026 15:11
@chrarnoldus chrarnoldus force-pushed the mark/onboarding-flow-update branch from 1a099e0 to e9b5f3b Compare January 28, 2026 16:41
markijbema
markijbema commented Jan 28, 2026
View reviewed changes
ONBOARDING_IMPLEMENTATION_PLAN.md
@@ -0,0 +1,873 @@
# Updated Onboarding Flow - Implementation Plan
Copy link
Contributor Author

@markijbema markijbema Jan 28, 2026

Choose a reason for hiding this comment

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

remove

markijbema
markijbema commented Jan 28, 2026
View reviewed changes
ONBOARDING_IMPLEMENTATION_PLAN_FINAL.md
@@ -0,0 +1,1095 @@
# Updated Onboarding Flow - Final Implementation Plan
Copy link
Contributor Author

@markijbema markijbema Jan 28, 2026

Choose a reason for hiding this comment

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

remove

markijbema
markijbema commented Jan 28, 2026
View reviewed changes
updated_onboarding.md
@@ -0,0 +1,63 @@
## Updated onboarding flow for VSCode extension
Copy link
Contributor Author

@markijbema markijbema Jan 28, 2026

Choose a reason for hiding this comment

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

remove

markijbema
markijbema commented Jan 28, 2026
View reviewed changes
.changeset/onboarding-flow-update.md
"kilo-code": minor
---

Add updated onboarding flow with contextual screens based on workspace state. New onboarding screens adapt to different user states (no folder open, folder open but no history), provide fun project suggestions for new users, show contextual prompts based on editor state, display rate limiting notifications, and simplify folder opening and repository cloning.
Copy link
Contributor Author

@markijbema markijbema Jan 28, 2026

Choose a reason for hiding this comment

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

maybe limit this to one sentence

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@markijbema @chrarnoldus