Skip to content

Commit 2c2d4e7

Browse files
committed
Updated the readme
1 parent 471d8fe commit 2c2d4e7

1 file changed

Lines changed: 23 additions & 81 deletions

File tree

README.md

Lines changed: 23 additions & 81 deletions
Original file line numberDiff line numberDiff line change
@@ -1,94 +1,36 @@
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
32

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.
104

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
156

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)
2313

2414
## Installation
2515

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:
3117

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
4525

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
5027

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!
5729

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.
6131

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`.
6533

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
9235

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

Comments
 (0)