@larscom/ng-chrome-extension
v3.2.4
Published
CLI to generate angular chrome extensions
Downloads
58
Maintainers
Readme
@larscom/ng-chrome-extension
Easily create
Angular
Chrome Extensions (manifest v3)
The following scenarios are supported:
- Popup ✓
- New Tab ✓
- Options ✓
- Side Panel ✓
- Service Worker ✓
- Content Page ✓
Disclaimer
This CLI tool should work on Linux/macOS, it is not tested on Windows.
How to install
npm install -g @larscom/ng-chrome-extension
Start creating a new project
ng-chrome new
How to use/develop
- change directory to your newly created project
- run
npm run start
- goto:
chrome://extensions
in the browser and enable'developer mode'
- press
Load unpacked
and target the folderangular/dist
The project is automatically being watched, any changes to the files will recompile the project.
NOTE: changes to the content page and service worker scripts requires you to reload the extension in chrome://extensions
Build/package for production
- update version number inside
./angular/src/manifest.json
- run
npm run build:production
- upload
extension-build.zip
to the chrome webstore.
This will run a production build and will automatically zip it as a extension package in the root folder named: extension-build.zip
Debugging
Run: npm start
Go to: Developer tools (inspect popup) => Sources => webpack
You can find your source files (TypeScript) over there.
Upgrade Angular
After you have created a new project with ng-chrome
and you want to update angular.
Just follow the regular upgrade guide of angular. See: https://update.angular.io/
Angular folder
This folder contains the angular source code. Each feature (popup,options,tab,side-panel) lives inside its own standalone component and gets lazily loaded.
see: ./angular/src/app/modules
Chrome folder
This folder contains the content page/service worker scripts and has its own package.json
to manage it's dependencies.