gitpod-io / gitpod-io/gitpod

Prompt when desktop IDE not installed (or open), e.g. "scheme does not have a registered handler"

Open
#9,975 3 comments 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

aspect: desktop IDE editor: code (desktop) editor: jetbrains meta: never-stale needs visual design team: IDE
Dominant language
TypeScript
Stars
13.8k
Forks
1.4k
Avg merge
17h 58m
Merged PRs (30d)
5

Description

Currently, when a new user comes to Gitpod, and selects a JetBrains IDE and starts a workspace, they are greeted with a browser prompt. However, if the user does not have Gateway installed, this leads to an error, which is only logged in the browser, and no obvious user action is given. This issue is to catch that exception, and provide the user with instructions on how to install Gateway.

Considerations:

  1. We should also consider the same UX for the redirect to VS Code Desktop, however the urgency is slightly lower for VS Code Desktop, as VS Code does not require an additional application, since it redirects to the main IDE, rather than an intermediary application (Gateway).
  2. We should consider the case when the user's operating system is not compatible or there is a bug with Gateway, as that can also be a cause of the error and we should provide instructions to raise issues on YouTrack.
  3. Could be implemented at the same time as: https://github.com/gitpod-io/gitpod/issues/8572
  4. We should also track how often this error occurs: https://github.com/gitpod-io/gitpod/issues/9934

Relates to:

Workspace start page Error in console
image image
NowTV example
image

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start at the workspace start page's JetBrains IDE redirect handling and reproduce the launch when Gateway is not installed or cannot open the scheme. Done means the browser shows clear Gateway installation or troubleshooting instructions instead of only logging the error; consider the related VS Code Desktop and YouTrack cases noted in the issue.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
frontend
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.