{"id":13703903,"url":"https://github.com/gitpod-io/browser-extension","last_synced_at":"2025-05-16T18:04:44.783Z","repository":{"id":39620503,"uuid":"219017940","full_name":"gitpod-io/browser-extension","owner":"gitpod-io","description":"The browser extension for gitpod.io. Works with Chrome and Firefox.","archived":false,"fork":false,"pushed_at":"2025-04-08T09:57:04.000Z","size":1837,"stargazers_count":162,"open_issues_count":0,"forks_count":87,"subscribers_count":16,"default_branch":"main","last_synced_at":"2025-04-12T16:58:46.141Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/gitpod-io/gitpod","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitpod-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-11-01T16:01:22.000Z","updated_at":"2025-04-08T09:57:07.000Z","dependencies_parsed_at":"2023-02-09T10:31:41.874Z","dependency_job_id":"46d28b61-bfb5-480f-8fd2-d0bf7cc80c59","html_url":"https://github.com/gitpod-io/browser-extension","commit_stats":null,"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitpod-io%2Fbrowser-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitpod-io%2Fbrowser-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitpod-io%2Fbrowser-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitpod-io%2Fbrowser-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitpod-io","download_url":"https://codeload.github.com/gitpod-io/browser-extension/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254582902,"owners_count":22095518,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-02T21:01:01.538Z","updated_at":"2025-05-16T18:04:44.725Z","avatar_url":"https://github.com/gitpod-io.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Gitpod Browser extension\n\n[![Setup Automated](https://img.shields.io/badge/setup-automated-blue?logo=gitpod)](https://gitpod.io/#https://github.com/gitpod-io/browser-extension)\n\nThis is the browser extension for Gitpod. It supports Chrome (see [Chrome Web Store](https://chrome.google.com/webstore/detail/dodmmooeoklaejobgleioelladacbeki/)), Firefox (see [Firefox Add-ons](https://addons.mozilla.org/firefox/addon/gitpod/)) and Edge (see [how to install Chrome extensions](https://support.microsoft.com/help/4538971/microsoft-edge-add-or-remove-extensions)), and adds a **Gitpod** button to the configured GitLab, GitHub and Bitbucket installations (defaults to `gitlab.com`, `github.com` and `bitbucket.org`) which immediately creates a Gitpod workspace for the current git context:\n\n![Gitpodify](./docs/github-injected.png \"Gitpodify\")\n\n### Issues\n\nWe are currently tracking all issues related to the browser extension in the [`gitpod-io/gitpod`](https://github.com/gitpod-io/gitpod) repository.\nYou can use the [`component: browser-extension`](https://github.com/gitpod-io/gitpod/issues?q=is%3Aissue+is%3Aopen+extension+label%3A%22component%3A+browser-extension%22) label to search for relevant issues including feature proposals and bug reports.\n\n### Development\n\nTo make changes and test them using Gitpod itself:\n\n-   add test cases to the [unit test](https://github.com/gitpod-io/browser-extension/blob/se/plasmo/test/src/button-contributions.spec.ts#L39)\n-   try out changes like this:\n    1. run `pnpm build`\n    1. run `pnpm watch-prod` and download the built binary for your system (local machine)\n    1. run the binary anywhere on your local machine to sync the extension folder locally.\n    1. open Chrome and go to `chrome://extensions/`\n    1. enable `Developer mode` (top right)\n    1. click `Load unpacked` (top left) and select the folder you just downloaded\n    1. now you can test your changes\n    1. repeat step 1 and 2 and [reload the extension](chrome://extensions/) whenever you want to test new changes\n\nOr, when developing locally, you can execute the following to enable hot reloading with the extension in Chrome:\n\n```\npnpm dev\n```\n\nThen, `Load unpacked` the `build/chrome-mv3-dev` folder in Chrome and after making changes, pages will reload automatically and the changes will be reflected immediately.\n\n#### Build\n\nThe build happens automatically when you start a workspace but if you want to build explicitly, use these commands:\n\n```\npnpm install\npnpm build --target=chrome-mv3 # or --target=firefox-mv3\npnpm package --target=chrome-mv3 # or --target=firefox-mv3\n```\n\n### Testing\n\nYou can test the extension without publishing to the store. Before uploading the bundle to the browser, make sure to [build](#build) the code, then follow these steps:\n\n#### For Chrome\n\n1. Open Chrome\n2. Click Settings -\u003e Extensions -\u003e Load unpacked\n3. Select the `chrome-mv3-prod` folder inside of `build/`\n\n#### For Firefox\n\n1. Open Firefox\n1. Go to `about:debugging#/runtime/this-firefox`\n1. Click Load Temporary Add-on -\u003e Select the `firefox-mv3-prod.zip` file. Please note, that some features (like extension settings) will not work.\n\n## Release\n\nWe currently publish the extension for **Chrome** and **Firefox**.\n\nTo release a new version, follow these steps:\n\n1. Bump up the version value inside `package.json` (`yarn version --patch` or `yarn version --minor`)\n1. Push your changes to `main`\n1. Compose a list of changes using the list of commits that were pushed since last version\n1. [Create a new release](https://github.com/gitpod-io/browser-extension/releases/new), listing changes:\n\n    ```yaml\n    ### Changes\n\n    - Change/Fix A\n    - Change/Fix B\n    - Change/Fix C\n\n    ### Credits\n\n    Thanks to @{EXTERNAL_CONTRIBUTOR_USERNAME} for helping! 🍊\n    ```\n\nFor Firefox:\n\n1. Sign in to https://addons.mozilla.org/en-US/developers/addon/gitpod/edit with the credentials from 1Password\n2. Click \u003ckbd\u003eUpload new version\u003c/kbd\u003e\n3. Upload the zip file (`firefox-mv3-prod.zip`)\n4. Go through the steps and submit\n\nFor Chrome:\n\n1. Using your Google account, open the [`gitpod-browser-extension Google Group`](https://groups.google.com/g/gitpod-browser-extension)\n2. If you don't have access, reach out for [help in Slack](https://gitpod.slack.com/archives/C04QC1ZMPV4)\n3. Once you are in the Google Group, make sure to \"Switch to Gitpod\" in the top navbar\n4. Click \"Upload new package\"\n5. Upload the zip file (`chrome-mv3-prod.zip`) and submit\n6. Wait a few hours for the review to happen!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitpod-io%2Fbrowser-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitpod-io%2Fbrowser-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitpod-io%2Fbrowser-extension/lists"}