|
1 | | -# Chrome Extension Starter with Vite, React, TypeScript, and Tailwind CSS |
2 | | -This project is a starter template for building modern Chrome extensions using Vite, React, TypeScript, and Tailwind CSS. It simplifies the setup so you can focus on building your extension's features. |
| 1 | +# pracc-optimiter Extension |
3 | 2 |
|
4 | | -<div style="display: flex; justify-content: space-around"> |
5 | | - <img src="https://github.com/user-attachments/assets/b2267b19-1618-4797-8e0e-a241697b92cf" alt="image 1" width="200"/> |
6 | | - <img src="https://github.com/user-attachments/assets/eb6304c9-afd7-4bfc-b9ce-8099531a66d9" alt="image 2" width="200"/> |
7 | | - <img src="https://github.com/user-attachments/assets/7808d29d-d1ca-4287-b82b-183ad7b6510a" alt="image 3" width="200"/> |
8 | | - <img src="https://github.com/user-attachments/assets/c2f328e2-f7d6-4e6d-a3ec-8e750625e0f8" alt="image 4" width="200"/> |
9 | | -</div> |
| 3 | +This extension allows you to enhance your experience on the pracc.com site. Use the built-in UI to toggle certain settings that will enable to do improve your experience. |
10 | 4 |
|
11 | | -## View tutorial on YouTube |
12 | | - <a href="https://www.youtube.com/watch?v=jwDErziR1nE"> |
13 | | - <img src="http://i.ytimg.com/vi/jwDErziR1nE/hqdefault.jpg" alt="YouTube video" width="200"/> |
14 | | - </a> |
| 5 | +Current version: v0.1.0 |
15 | 6 |
|
16 | | -## Features |
17 | | -- **Fast reloading** develop UI faster, view the popup and options page |
18 | | -- **Vite** for fast bundling and development |
19 | | -- **React** for building interactive UI components |
20 | | -- **TypeScript** for type-safe JavaScript development |
21 | | -- **Tailwind CSS** for easy and responsive styling |
22 | | -- **chrome-types** Chrome's API TS files for auto-completion |
| 7 | +The whole project is not associated with pracc.com or any other brand cooperating with them. It is just a side-project. If you got any copyright issues, please write an email to |
| 8 | +[lanneken09@gmail.com](mailto:lanneken09@gmail.com) (only business inquires) |
| 9 | + |
| 10 | +## License |
| 11 | + |
| 12 | +[MIT](https://github.com/leontm-dev/pracc-optimizer/blob/main/LICENSE) |
23 | 13 |
|
24 | 14 | ## Installation |
25 | 15 |
|
26 | | -### Clone this repository: |
27 | | -``` |
28 | | -git clone https://github.com/omribarmats/chrome-extension-starter.git new-project |
29 | | -``` |
30 | | -* Replace `new-project` with your project name |
| 16 | +I hope that I will be able to upload this extension to the chrome webstore for easier downloads but at the moment, follow this tutorial: |
31 | 17 |
|
32 | | -### Open the new directory: |
33 | | -``` |
34 | | -cd new-project |
35 | | -``` |
36 | | -### Install dependencies: |
37 | | -``` |
38 | | -npm install |
39 | | -``` |
40 | | -### Start the development server: |
41 | | -``` |
42 | | -npm run dev |
43 | | -``` |
44 | | -## Load the Extension |
| 18 | +1. Clone this repo by running: `git clone https://github.com/leontm-dev/pracc-optimizer.git my-extension-folder` |
| 19 | +2. Get into the newly created folder with `cd my-extension-folder` |
| 20 | +3. Run `npm run build`, for this you need to have [Node.js](https://nodejs.org/en) installed |
| 21 | +4. Go to the extensions manager of your browser, for Chrome you will find it under [chrome://extensions](chrome://extensions) |
| 22 | +5. Click on the button that says "Load unpacked" |
| 23 | +6. Now your file manager should have opened, navigate to the folder "my-extension-folder" and click on "dist". Select this folder and the window should lead you back to chrome. |
| 24 | +7. You are done |
45 | 25 |
|
46 | | -1. Run the build command: `npm run build.` |
47 | | -2. Go to `chrome://extensions/` in your Chrome browser. |
48 | | -3. Enable `Developer mode`. |
49 | | -4. Click `Load unpacked` and select the `dist` folder from the project. |
| 26 | +## Contributing |
50 | 27 |
|
51 | | -## Development |
52 | | -- Hot-reload enabled for easier development. |
53 | | -- Modify your code in the src folder. |
54 | | -- Tailwind CSS is already configured and ready to use. |
55 | | -- Run `nmp run build` to implement changes to `dist` folder |
56 | | -- Go on `chrome://extensions/` and click refresh `⟳` |
| 28 | +Contributions are always welcome! |
57 | 29 |
|
58 | | -### How to change the popup? |
59 | | -- Go on `src/chrome-extension/popup/index.tsx` |
60 | | -- Once changes are made open the terminal and run `nmp run build` then visit `chrome://extensions/` and click the refresh `⟳` button on your extension |
| 30 | +See `contributing.md` for ways to get started. |
61 | 31 |
|
62 | | -### How to change the options page? |
63 | | -- Go on `src/chrome-extension/options/index.tsx` |
64 | | -- Once changes are made open the terminal and run `nmp run build` then visit `chrome://extensions/` and click the refresh `⟳` button on your extension |
| 32 | +Please adhere to this project's `code of conduct`. |
65 | 33 |
|
66 | | -- ### How to add a background script? |
67 | | -- Create a `background.ts` file inside the `src` folder |
68 | | -- Go on `vite.config.ts` and add this line `background: resolve(__dirname, "src/background.ts"),` under `build.rollupOptions.input` |
69 | | -- For example |
70 | | -``` |
71 | | - build: { |
72 | | - rollupOptions: { |
73 | | - input: { |
74 | | - popup: resolve(__dirname, "popup.html"), |
75 | | - options: resolve(__dirname, "options.html"), |
76 | | - background: resolve(__dirname, "src/background.ts"), |
77 | | - }, |
78 | | - output: { |
79 | | - entryFileNames: "[name].js", |
80 | | - }, |
81 | | - }, |
82 | | - }, |
83 | | -``` |
84 | | -- Go on `manifest.json` and add this code: |
85 | | -``` |
86 | | - "background": { |
87 | | - "service_worker": "background.js", |
88 | | - "type": "module" |
89 | | - } |
90 | | -``` |
91 | | -- Open the terminal and run `nmp run build` then visit `chrome://extensions/` and click the refresh `⟳` button on your extension |
| 34 | +## Authors |
92 | 35 |
|
93 | | -## Contributing |
94 | | -Feel free to fork the project and make improvements or submit bug reports or issues. |
| 36 | +- [@leontm-dev](https://www.github.com/leontm-dev) |
0 commit comments