Skip to content

Onboarding hotfix 2#1225

Merged
duckduckhero merged 5 commits intomainfrom
onboarding-hotfix-2
Jul 27, 2025
Merged

Onboarding hotfix 2#1225
duckduckhero merged 5 commits intomainfrom
onboarding-hotfix-2

Conversation

@duckduckhero
Copy link
Contributor

No description provided.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jul 27, 2025

📝 Walkthrough

Walkthrough

This change updates the onboarding flow in the desktop application, particularly reordering onboarding steps, modifying audio permission handling to include user notification and automatic app restart, and adjusting when onboarding completion is flagged. Localization files are updated to reflect new or obsolete messages and line number shifts. Minor UI and logic cleanups are included.

Changes

Cohort / Files Change Summary
apps/desktop/src/components/welcome-modal/audio-permissions-view.tsx Adds user notification and triggers app restart after granting system audio permission; updates UI texts and cleans up formatting.
apps/desktop/src/components/welcome-modal/index.tsx Reorders onboarding steps; defers onboarding completion flag to after calendar permissions; no changes to exported signatures.
apps/desktop/src/routes/app.tsx Removes call to mark onboarding as complete on modal close; only updates local session state.
apps/desktop/src/locales/en/messages.po
apps/desktop/src/locales/ko/messages.po
Updates translation files: adds new message for app restart notice, marks one message obsolete, and updates source line references.

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant WelcomeModal
  participant AudioPermissionsView
  participant App

  User->>WelcomeModal: Starts onboarding
  WelcomeModal->>AudioPermissionsView: Proceeds to audio permissions step
  User->>AudioPermissionsView: Grants system audio access
  AudioPermissionsView->>User: Shows "app will restart" dialog
  AudioPermissionsView->>App: Waits 4 seconds, triggers app relaunch
Loading
sequenceDiagram
  participant User
  participant WelcomeModal
  participant App

  User->>WelcomeModal: Completes onboarding steps
  WelcomeModal->>App: On final step, sets onboarding as complete
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~15 minutes

Possibly related PRs

  • frontend changes #1224: Modifies the same audio permissions component to increase polling frequency and add a UI message for permission changes, closely related to the changes in user feedback and permission handling in this PR.
✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch onboarding-hotfix-2

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

‼️ IMPORTANT
Auto-reply has been disabled for this repository in the CodeRabbit settings. The CodeRabbit bot will not respond to your replies unless it is explicitly tagged.

  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai generate unit tests to generate unit tests for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (1)
apps/desktop/src/locales/ko/messages.po (1)

343-345: Translation needed for new message.

The new message "After you grant system audio access, app will restart to apply the changes" has been added but lacks Korean translation (msgstr is empty). This should be translated to provide proper localization for Korean users.

Would you like me to help identify other untranslated messages in the Korean locale file or generate a script to check translation completeness?

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between f545beb and b5b94c5.

📒 Files selected for processing (5)
  • apps/desktop/src/components/welcome-modal/audio-permissions-view.tsx (4 hunks)
  • apps/desktop/src/components/welcome-modal/index.tsx (3 hunks)
  • apps/desktop/src/locales/en/messages.po (10 hunks)
  • apps/desktop/src/locales/ko/messages.po (10 hunks)
  • apps/desktop/src/routes/app.tsx (0 hunks)
💤 Files with no reviewable changes (1)
  • apps/desktop/src/routes/app.tsx
🧰 Additional context used
📓 Path-based instructions (1)
**/*.{js,ts,tsx,rs}

⚙️ CodeRabbit Configuration File

**/*.{js,ts,tsx,rs}: 1. No error handling.
2. No unused imports, variables, or functions.
3. For comments, keep it minimal. It should be about "Why", not "What".

Files:

  • apps/desktop/src/components/welcome-modal/audio-permissions-view.tsx
  • apps/desktop/src/components/welcome-modal/index.tsx
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: ci (windows, windows-latest)
  • GitHub Check: ci (macos, macos-latest)
🔇 Additional comments (10)
apps/desktop/src/components/welcome-modal/audio-permissions-view.tsx (4)

10-11: LGTM! Proper imports for new functionality.

The imports for message and relaunch are correctly added to support the new app restart behavior.


103-103: Explicit refetch interval is appropriate.

Setting an explicit 1000ms refetch interval ensures consistent permission status polling behavior.


125-128: Well-implemented user notification and restart sequence.

The implementation correctly:

  • Notifies users about the upcoming restart with a clear message
  • Uses a reasonable 4-second delay before relaunch to allow users to read the notification
  • Provides proper context with the dialog title "System Audio Status Changed"

142-142: UI text appropriately updated to reflect new behavior.

The message clearly informs users that the app will restart after granting system audio access, setting proper expectations.

apps/desktop/src/components/welcome-modal/index.tsx (4)

92-92: Logical reordering: Audio permissions moved to first step.

Moving audio permissions to the initial onboarding step makes UX sense - it's better to request necessary permissions early in the flow before users invest time in model selection.


104-104: Proper step progression after model downloads.

After download progress, proceeding to language selection maintains a logical flow where technical setup (models) is completed before user preferences (language).


108-108: Audio permissions now correctly lead to model selection.

The flow audio-permissions → model-selection is logical, allowing users to configure models after granting necessary permissions.


130-130: Proper deferral of onboarding completion flag.

Moving commands.setOnboardingNeeded(false) to the final calendar permissions step ensures onboarding is only marked complete after all steps are finished. This prevents users from bypassing later steps if the modal were to close prematurely.

apps/desktop/src/locales/en/messages.po (2)

343-345: Proper localization for new restart message.

The new message about app restart after granting system audio access is correctly added with appropriate English translation. The message clearly communicates the expected behavior to users.


782-783: Appropriate obsolete message handling.

The previous audio permission message is correctly marked as obsolete, maintaining localization file integrity while removing unused strings.

@duckduckhero duckduckhero merged commit 93d3ffc into main Jul 27, 2025
7 checks passed
This was referenced Jul 28, 2025
@coderabbitai coderabbitai bot mentioned this pull request Aug 11, 2025
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