{"id":13809839,"url":"https://github.com/SimGus/chrome-extension-v3-starter","last_synced_at":"2025-05-14T10:31:05.215Z","repository":{"id":38449431,"uuid":"351248470","full_name":"SimGus/chrome-extension-v3-starter","owner":"SimGus","description":"🚀 Minimal Chrome extension template using manifest v3 🚀","archived":false,"fork":false,"pushed_at":"2023-05-01T16:49:46.000Z","size":30,"stargazers_count":295,"open_issues_count":3,"forks_count":207,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-02-15T15:33:16.890Z","etag":null,"topics":["addon","chrome","chrome-extension","chromium","extension"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"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/SimGus.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":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-03-24T23:10:30.000Z","updated_at":"2024-02-14T18:31:29.000Z","dependencies_parsed_at":"2024-01-13T14:41:57.620Z","dependency_job_id":"b6b8ff6e-b0f8-4ea3-bf7e-5ec792c2ecff","html_url":"https://github.com/SimGus/chrome-extension-v3-starter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimGus%2Fchrome-extension-v3-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimGus%2Fchrome-extension-v3-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimGus%2Fchrome-extension-v3-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SimGus%2Fchrome-extension-v3-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SimGus","download_url":"https://codeload.github.com/SimGus/chrome-extension-v3-starter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254120624,"owners_count":22018024,"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":["addon","chrome","chrome-extension","chromium","extension"],"created_at":"2024-08-04T02:00:37.350Z","updated_at":"2025-05-14T10:31:04.933Z","avatar_url":"https://github.com/SimGus.png","language":"JavaScript","funding_links":[],"categories":["JavaScript","Chrome extension"],"sub_categories":["Phaser"],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"https://raw.githubusercontent.com/SimGus/chrome-addon-v3-starter/master/logo/logo-128.png\"/\u003e\n    \u003ch1\u003eChrome Extension v3 Starter\u003c/h1\u003e\n    \u003ch3\u003eA minimal template of a Chrome v3 addon\u003c/h3\u003e\n\u003c/div\u003e\n\nThis repository contains a minimal Chrome/Chromium extension that uses the newest version of the manifest (v3).\n\nYou can use it as a basis to develop an extension.\nIt can also give you more insights about how to turn a v2 extension to v3.\n\nIn other words, this is a **working, installable v3 extension** example meant for you to **jumpstart** the development of your own extension.\n\n\n## Installation\n- **Fork** this repo, then **clone your forked repo locally**. If you don't have a github account, you can simply download a zip of the repo and unzip it on your computer.\n- **Open [the extensions page](chrome://extensions)** in your browser: `chrome://extensions`. This link works on any chromium-based browser.\n- If you did not do it already, **toggle the \"developer mode\"**. This is usually a toggle button at the top right of the extensions page.\n- Click the button **_load unpacked extension_**.\n- In the window that pops up, **select the folder that contains this minimal extension**, then **click _ok_**.\n- **Done!** A new extension called _Chrome Addon v3 Starter_ should have appeared in the list.\n\n## Q\u0026A\n\u003e Does this work only on Chrome or on **other web browsers** as well?\n\nAt the moment, this works on every chromium-based web browser that supports v3 extensions.\nTherefore, you should be able to install this extension on any of the following browsers (as long as they are up-to-date):\n- _Free and open-source browsers_:\n    - Chromium\n    - Brave\n- _Proprietary browsers_:\n    - Chrome\n    - Edge\n    - Vivaldi\n    - Opera\n\n\u003e So it doesn't work on **Firefox** or **Safari**?\n\nNo, Firefox uses a different extension format. That being said, it is usually not too hard to port extensions from Chrome to Firefox.\nRead [their porting documentation](https://extensionworkshop.com/documentation/develop/porting-a-google-chrome-extension/) for more information.\n\nSafari uses yet another extension format and porting is usually harder.\nYou can find more information [here](https://bartsolutions.github.io/2020/11/20/safari-extension/).\n\n\u003e Does this work on **Chrome for Android/iOS**?\n\nChrome for mobile doesn't currently support extensions.\n\n\u003e I don't need a **popup tool** for my extension! Can I remove it?\n\nYes, simply delete the `popup` folder and remove the `default_popup` property from the manifest.\n\n\u003e I changed some code in the extension, but my **changes aren't taken into account**!\n\nFor most of the changes you make, you will need to reload your extension for the changes to be applied.\nTo do that, go to the chrome://extensions page and click the reload button of your extension.\nNote that most of the changes you will make to the settings page or the popup don't require reloading the extension.\n\n\u003e Can I follow a **tutorial about a v2 extension** with this?\n\nMost of what you will find in those tutorials still holds with v3.\n\nHowever, a few things (notably best practices) have changed.\nYou should read the [official migration page (v2 to v3)](https://developer.chrome.com/docs/extensions/mv3/intro/mv3-migration/) before following such a tutorial.\n\n\u003e When I make an erroneous change in my service worker, the extension doesn't load! How can I **debug a service worker**?\n\nUsing the debugger if your service worker is not loaded is not possible.\n\nHowever, if you want to test some piece of code before putting it in your service worker, you can:\n- load your extension with a working version of the service worker.\n- click on \"service worker\" on the page _chrome://extensions_. This will open the console attached to the service worker.\n- paste your code in the console and see if any error is logged.\n\nNote that in this console, you have access to anything your service worker has access to, including its variables, functions and chrome APIs.\n\n\u003e How do I **uninstall** this extension from my browser?\n\n- Go to the [extensions page](chrome://extensions): chrome://extensions.\n  There should be a card with the name of this extension as title.\n  If you don't see such a card, it means the extension is not installed.\n- Simply click the _Delete_ button at the bottom of the card. Click _ok_ if a popup asks you for confirmation. The extension is now uninstalled.\n\n\u003e I want to **push my changes to my own repo**, how do I do this?\n\n- If you forked this repo and cloned your own fork locally, git will push to your fork on your account automatically (i.e. use the command `git push` or `git push origin \u003cyour-branch\u003e`).\n\n- If you downloaded a zip or simply cloned this repo locally, do the following:\n    - Create a github account if you don't already have one and install git on your machine.\n    - Create a new (empty) repo on your github and copy its url.\n    - Open a terminal in the folder where the extension is cloned.\n    - Run the command `git init`, then `git commit -am \"Initial commit\"`\n    - Run the command `git remote add origin \u003curl-of-your-repo\u003e`\n    - Run `git push -u origin master`. The extension code is now on your repo, on brnach _master_.\n    - If you want, you can make the _master_ branch the default one and delete the _main_ branch in the settings of your repo.\n\n## External resources\n- [Official feature summary for manifest v3](https://developer.chrome.com/docs/extensions/mv3/intro/mv3-overview/)\n- [Migrating from v2 to v3](https://developer.chrome.com/docs/extensions/mv3/intro/mv3-migration/) + [very useful checklist once you think you are done](https://developer.chrome.com/docs/extensions/mv3/mv3-migration-checklist/)\n- [Excellent write-ups of a migration](https://github.com/kentbrew/learning-manifest-v3)\n- [Another example of a v3 extension (older code)](https://gist.github.com/dotproto/3a328d6b187621b445499ba503599dc0)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSimGus%2Fchrome-extension-v3-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FSimGus%2Fchrome-extension-v3-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FSimGus%2Fchrome-extension-v3-starter/lists"}