|
| 1 | +<div align="center"> |
| 2 | +<img src="public/icon-128.png" alt="logo"/> |
| 3 | +<h1> Chrome Extension Boilerplate with<br/>React + Vite + TypeScript</h1> |
| 4 | + |
| 5 | + |
| 6 | + |
| 7 | + |
| 8 | + |
| 9 | +<img src="https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https://github.com/Jonghakseo/chrome-extension-boilerplate-react-viteFactions&count_bg=%23#222222&title_bg=%23#454545&title=😀&edge_flat=true" alt="hits"/> |
| 10 | + |
| 11 | + |
| 12 | +> This project is listed in the [Awesome Vite](https://github.com/vitejs/awesome-vite) |
| 13 | +
|
| 14 | +</div> |
| 15 | + |
| 16 | +## Table of Contents |
| 17 | + |
| 18 | +- [Intro](#intro) |
| 19 | +- [Features](#features) |
| 20 | +- [Installation](#installation) |
| 21 | + - [Procedures](#procedures) |
| 22 | +- [Screenshots](#screenshots) |
| 23 | + - [NewTab](#newtab) |
| 24 | + - [Popup](#popup) |
| 25 | +- [Documents](#documents) |
| 26 | + |
| 27 | + |
| 28 | +## Intro <a name="intro"></a> |
| 29 | +This boilerplate is made for creating chrome extensions using React and Typescript. |
| 30 | +> The focus was on improving the build speed and development experience with Vite. |
| 31 | +
|
| 32 | +## Features <a name="features"></a> |
| 33 | +- [React 18](https://reactjs.org/) |
| 34 | +- [TypeScript](https://www.typescriptlang.org/) |
| 35 | +- [Jest](https://jestjs.io/) |
| 36 | +- [React Testing Library](https://testing-library.com/docs/react-testing-library/intro/) |
| 37 | +- [Vite](https://vitejs.dev/) |
| 38 | +- [SASS](https://sass-lang.com/) |
| 39 | +- [ESLint](https://eslint.org/) |
| 40 | +- [Prettier](https://prettier.io/) |
| 41 | +- [Chrome Extension Manifest Version 3](https://developer.chrome.com/docs/extensions/mv3/intro/) |
| 42 | +- HMR(incomplete) |
| 43 | + - [Refresh PR](https://github.com/Jonghakseo/chrome-extension-boilerplate-react-vite/pull/25) |
| 44 | + |
| 45 | +## Installation <a name="installation"></a> |
| 46 | + |
| 47 | +### Procedures <a name="procedures"></a> |
| 48 | +1. Clone this repository. |
| 49 | +2. Change `name` and `description` in package.json => **Auto synchronize with manifest** |
| 50 | +3. Run `yarn install` or `npm i` (check your node version >= 16.6, recommended >= 18) |
| 51 | +4. Run `yarn dev` or `npm run dev` |
| 52 | +5. Load Extension on Chrome |
| 53 | + 1. Open - Chrome browser |
| 54 | + 2. Access - chrome://extensions |
| 55 | + 3. Check - Developer mode |
| 56 | + 4. Find - Load unpacked extension |
| 57 | + 5. Select - `dist` folder in this project (after dev or build) |
| 58 | +6. If you want to build in production, Just run `yarn build` or `npm run build`. |
| 59 | + |
| 60 | +## Screenshots <a name="screenshots"></a> |
| 61 | + |
| 62 | +### New Tab <a name="newtab"></a> |
| 63 | + |
| 64 | +<img width="971" src="https://user-images.githubusercontent.com/53500778/162631646-cd40976b-b737-43d0-8e6a-6ac090a2e2d4.png"> |
| 65 | + |
| 66 | +### Popup <a name="popup"></a> |
| 67 | + |
| 68 | +<img width="314" alt="popup" src="https://user-images.githubusercontent.com/53500778/203561728-23517d46-12e3-4139-8a4f-e0b2f22a6ab3.png"> |
| 69 | + |
| 70 | + |
| 71 | +## Documents <a name="documents"></a> |
| 72 | +- [Vite Plugin](https://vitejs.dev/guide/api-plugin.html) |
| 73 | +- [ChromeExtension](https://developer.chrome.com/docs/extensions/mv3/) |
| 74 | +- [Rollup](https://rollupjs.org/guide/en/) |
| 75 | +- [Rollup-plugin-chrome-extension](https://www.extend-chrome.dev/rollup-plugin) |
| 76 | + |
| 77 | + |
| 78 | + |
| 79 | +--- |
| 80 | +## Thanks To |
| 81 | + |
| 82 | +| [Jetbrains](https://jb.gg/OpenSourceSupport) | [Jackson Hong](https://www.linkedin.com/in/j-acks0n/) | |
| 83 | +|--------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------| |
| 84 | +| <img width="100" src="https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png" alt="JetBrains Logo (Main) logo."> | <img width="100" src='https://avatars.githubusercontent.com/u/23139754?v=4' alt='Jackson Hong'/> | |
| 85 | + |
| 86 | + |
| 87 | +--- |
| 88 | + |
| 89 | +[Jonghakseo](https://nookpi.tistory.com/) |
0 commit comments