1.0.0-alpha.2 • Published 7 months ago

create-typescript-extension v1.0.0-alpha.2

Weekly downloads
-
License
MIT
Repository
-
Last release
7 months ago

Typescript Chrome Extension Starter

šŸš€ Overview

A robust, modern starter template for building Chrome extensions using TypeScript, Webpack, and best practices for browser extension development.

šŸ›  Installation

To create a new project, run the following command:

npx create-typescript-extension <project-name>

or to create a project in the current directory, run the following command:

npx create-typescript-extension .

šŸ“‹ Installation to the system

To install the CLI to the system, run the following command:

npm install -g create-typescript-extension

and then you can use the CLI to create a new project by running the following command:

create-typescript-extension <project-name>

✨ Features

  • šŸ”§ TypeScript support
  • šŸ“¦ Webpack bundling
  • 🌐 Content script and service worker integration
  • šŸ”’ Secure content security policy
  • šŸ”‘ Manifest v3
  • šŸ”„ Hot reloading in development mode

šŸ“‹ Prerequisites

  • Node.js (v18+ recommended)
  • npm or yarn
  • Chrome Browser (or any other Chromium based browser)

šŸ–„ Development

Running in Development Mode

yarn dev

Building for Production

yarn build

Loading in Chrome

  1. Open Chrome and navigate to chrome://extensions/
  2. Enable "Developer mode"
  3. Click "Load unpacked" and select the project directory
  4. You don't need to select the dist directory, it's already set in the manifest.json

šŸ“‚ Project Structure

ā”œā”€ā”€ src/
│   ā”œā”€ā”€ content/
│   │   └── index.ts        # Content script entry point
│   └── worker/
│       └── index.ts        # Service worker entry point
ā”œā”€ā”€ dist/                   # Compiled extension files
ā”œā”€ā”€ webpack.config.js       # Webpack configuration
ā”œā”€ā”€ tsconfig.json           # TypeScript configuration
└── manifest.json           # Chrome extension manifest

šŸ” Permissions

The extension requests the following Chrome permissions by default. You can modify the permissions in the manifest.json file.

  • scripting
  • activeTab
  • storage
  • declarativeNetRequest
  • tabs

šŸ¤ Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

šŸ“„ License

Distributed under the MIT License. See LICENSE for more information.

šŸ“ž Contact

Harshit Budhraja - @harshitbudhraja on X (previously, Twitter)


Note: This is a starter template. Remember to customize it to fit your specific extension's needs!