thedevs-network/kutt-extension
1
0
Fork 0
mirror of https://github.com/thedevs-network/kutt-extension.git synced 2026-02-03 05:43:24 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

refactor: remove opera from build

Browse Source
This commit is contained in:
abhijithvijayan
2026-01-04 04:32:56 +05:30
parent 8404361c6a
commit 153bdca706
7 changed files with 133 additions and 168 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
.github/workflows/build.yml vendored
View File

@@ -51,12 +51,6 @@ jobs:
name: firefox-extension name: firefox-extension
path: extension/firefox.xpi path: extension/firefox.xpi
- name: Upload Opera extension artifact
uses: actions/upload-artifact@v4
with:
name: opera-extension
path: extension/opera.crx
deploy: deploy:
needs: build needs: build
runs-on: ubuntu-latest runs-on: ubuntu-latest

18
CONTRIBUTING.md
View File

@@ -13,8 +13,6 @@
- `npm run dev:chrome` - `npm run dev:chrome`
- Firefox - Firefox
- `npm run dev:firefox` - `npm run dev:firefox`
- Opera
- `npm run dev:opera`
(Reload Extension Manually in the browser) (Reload Extension Manually in the browser)
@@ -36,13 +34,6 @@
<img width="400" src="https://i.imgur.com/aAL5dQg.png" /> <img width="400" src="https://i.imgur.com/aAL5dQg.png" />
- ### Opera
- Load the extension via `opera:extensions`
- Check the `Developer Mode` and load as unpacked from extension’s extracted directory.
<img width="400" src="https://i.imgur.com/qUwfSNJ.png" />
- Generate an API Key from <a href="https://kutt.it">`https://kutt.it/`</a> (Settings page) - Generate an API Key from <a href="https://kutt.it">`https://kutt.it/`</a> (Settings page)
- Paste and Save the `Key` in extension's `options page`. - Paste and Save the `Key` in extension's `options page`.
@@ -63,12 +54,3 @@ height="50">](https://github.com/thedevs-network/kutt-extension/releases)
- **Enable Developer Options** to use with self-hosted kutt - **Enable Developer Options** to use with self-hosted kutt
- Save the self hosted domain in the input (eg: https://mykutt.it) - Save the self hosted domain in the input (eg: https://mykutt.it)
- **Note**: the api endpoint is automatically appended during the api call. - **Note**: the api endpoint is automatically appended during the api call.
### For Opera Users
In order to install this extension from Chrome Web Store, another opera extension called **Install Chrome Extension** should be installed first.
- [Opera addon :: Install Chrome Extension](https://addons.opera.com/en/extensions/details/install-chrome-extensions/)
- [Opera addon :: Kutt](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd)
![](https://i.imgur.com/TJTisdC.png)

257
README.md
View File

@@ -1,129 +1,128 @@
<div align="center"><img width="150" src="source/public/assets/logo.png" /></div> <div align="center"><img width="150" src="source/public/assets/logo.png" /></div>
<h1 align="center">kutt-extension</h1> <h1 align="center">kutt-extension</h1>
<p align="center">Browser extension for <a href="https://kutt.it">Kutt.it</a> URL shortener</p> <p align="center">Browser extension for <a href="https://kutt.it">Kutt.it</a> URL shortener</p>
<div align="center"> <div align="center">
<a href="https://github.com/thedevs-network/kutt-extension/actions/workflows/build.yml"> <a href="https://github.com/thedevs-network/kutt-extension/actions/workflows/build.yml">
<img src="https://github.com/thedevs-network/kutt-extension/actions/workflows/build.yml/badge.svg?branch=master" alt="Build" /> <img src="https://github.com/thedevs-network/kutt-extension/actions/workflows/build.yml/badge.svg?branch=master" alt="Build" />
</a> </a>
<a href="https://github.com/thedevs-network/kutt-extension/releases/latest"> <a href="https://github.com/thedevs-network/kutt-extension/releases/latest">
<img src="https://img.shields.io/github/release/thedevs-network/kutt-extension.svg?colorB=blue" alt="Releases" /> <img src="https://img.shields.io/github/release/thedevs-network/kutt-extension.svg?colorB=blue" alt="Releases" />
</a> </a>
<a href="https://github.com/thedevs-network/kutt-extension/issues?q=is%3Aopen+is%3Aissue"> <a href="https://github.com/thedevs-network/kutt-extension/issues?q=is%3Aopen+is%3Aissue">
<img src="https://img.shields.io/github/issues-raw/thedevs-network/kutt-extension.svg?colorB=lightgrey" alt="Open Issues" /> <img src="https://img.shields.io/github/issues-raw/thedevs-network/kutt-extension.svg?colorB=lightgrey" alt="Open Issues" />
</a> </a>
<a href="https://github.com/thedevs-network/kutt-extension/issues?q=is%3Aissue+is%3Aclosed"> <a href="https://github.com/thedevs-network/kutt-extension/issues?q=is%3Aissue+is%3Aclosed">
<img src="https://img.shields.io/github/issues-closed-raw/thedevs-network/kutt-extension.svg?colorB=red" alt="Closed Issues" /> <img src="https://img.shields.io/github/issues-closed-raw/thedevs-network/kutt-extension.svg?colorB=red" alt="Closed Issues" />
</a> </a>
<a href="https://github.com/thedevs-network/kutt-extension/blob/master/license"> <a href="https://github.com/thedevs-network/kutt-extension/blob/master/license">
<img src="https://img.shields.io/github/license/thedevs-network/kutt-extension.svg" alt="LICENSE" /> <img src="https://img.shields.io/github/license/thedevs-network/kutt-extension.svg" alt="LICENSE" />
</a> </a>
</div> </div>
<hr /> <hr />
❤️ it? ⭐️ it on [GitHub](https://github.com/thedevs-network/kutt-extension/stargazers) ❤️ it? ⭐️ it on [GitHub](https://github.com/thedevs-network/kutt-extension/stargazers)
## Features ## Features
- Minimal UI - Minimal UI
- Instant QR Code - Instant QR Code
- Cross Browser Support - Cross Browser Support
- Supports Secure Passwords for URLs - Supports Secure Passwords for URLs
- History & Incognito Feature - History & Incognito Feature
- Auto Copy Feature - Auto Copy Feature
- Free and Open Source - Free and Open Source
- Uses WebExtensions API - Uses WebExtensions API
## Tech Stack ## Tech Stack
- **Bundler**: [Vite](https://vitejs.dev/) 6 - **Bundler**: [Vite](https://vitejs.dev/) 6
- **UI**: [React](https://react.dev/) 19 - **UI**: [React](https://react.dev/) 19
- **Language**: [TypeScript](https://www.typescriptlang.org/) 5.7 - **Language**: [TypeScript](https://www.typescriptlang.org/) 5.7
- **Styling**: SCSS with CSS Modules - **Styling**: SCSS with CSS Modules
- **Linting**: ESLint 9 (flat config) + Prettier - **Linting**: ESLint 9 (flat config) + Prettier
## Browser Support ## Browser Support
This extension uses **Manifest V3**. This extension uses **Manifest V3**.
| [![Chrome](https://raw.github.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png)](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd) | [![Firefox](https://raw.github.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png)](https://addons.mozilla.org/firefox/addon/kutt/) | [![Opera](https://raw.github.com/alrra/browser-logos/master/src/opera/opera_48x48.png)](CONTRIBUTING.md#for-opera-users) | [![Edge](https://raw.github.com/alrra/browser-logos/master/src/edge/edge_48x48.png)](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd) | [![Brave](https://raw.github.com/alrra/browser-logos/master/src/brave/brave_48x48.png)](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd) | | [![Chrome](https://raw.github.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png)](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd) | [![Firefox](https://raw.github.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png)](https://addons.mozilla.org/firefox/addon/kutt/) | [![Opera](https://raw.github.com/alrra/browser-logos/master/src/opera/opera_48x48.png)](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd) | [![Edge](https://raw.github.com/alrra/browser-logos/master/src/edge/edge_48x48.png)](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd) | [![Brave](https://raw.github.com/alrra/browser-logos/master/src/brave/brave_48x48.png)](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd) |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 88+ | 109+ | 74+ | 88+ (Chromium) | Latest (Chromium) | | 88+ | 109+ | 74+ | 88+ | 1.21+ |
## Installation ## Installation
- **Chrome**: [Kutt :: Chrome Web Store](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd) - **Chrome**: [Kutt :: Chrome Web Store](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd)
- **Firefox**: [Kutt :: Add-ons for Firefox](https://addons.mozilla.org/firefox/addon/kutt/) - **Firefox**: [Kutt :: Add-ons for Firefox](https://addons.mozilla.org/firefox/addon/kutt/)
- **Opera**: [Kutt :: Opera addons](CONTRIBUTING.md#for-opera-users) - **Edge**: [Kutt :: Chrome Web Store](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd)
- **Edge**: [Kutt :: Chrome Web Store](https://chrome.google.com/webstore/detail/kutt/pklakpjfiegjacoppcodencchehlfnpd)
## How to Use
## How to Use
1. Generate an API Key from <a href="https://kutt.it">`https://kutt.it/`</a> after signing up (Settings page)
1. Generate an API Key from <a href="https://kutt.it">`https://kutt.it/`</a> after signing up (Settings page)
<img width="400" src="https://i.imgur.com/qQwqeH5.png" />
<img width="400" src="https://i.imgur.com/qQwqeH5.png" />
2. Paste and Save this `Key` in extension's `options page` when asked
2. Paste and Save this `Key` in extension's `options page` when asked
## Screenshots
## Screenshots
<div>
<div> <img width="250" src="./.github/assets/popup-v4-1.png" alt="popup" />
<img width="250" src="./.github/assets/popup-v4-1.png" alt="popup" /> <div>_</div>
<div>_</div> <img width="330" src="./.github/assets/options-v4-1.png" alt="options" />
<img width="330" src="./.github/assets/options-v4-1.png" alt="options" /> </div>
</div>
## Development
## Development
Ensure you have [Node.js](https://nodejs.org) 20 or later installed.
Ensure you have [Node.js](https://nodejs.org) 20 or later installed.
```bash
```bash # Install dependencies
# Install dependencies npm install
npm install
# Start development server
# Start development server npm run dev:chrome # For Chrome
npm run dev:chrome # For Chrome npm run dev:firefox # For Firefox
npm run dev:firefox # For Firefox
# Build for production
# Build for production npm run build:chrome # Build Chrome extension
npm run build:chrome # Build Chrome extension npm run build:firefox # Build Firefox addon
npm run build:firefox # Build Firefox addon npm run build # Build for all browsers
npm run build # Build for all browsers
# Linting
# Linting npm run lint # Run ESLint
npm run lint # Run ESLint npm run lint:fix # Run ESLint with auto-fix
npm run lint:fix # Run ESLint with auto-fix ```
```
### Loading the Extension
### Loading the Extension
#### Chrome
#### Chrome
1. Navigate to `chrome://extensions`
1. Navigate to `chrome://extensions` 2. Enable "Developer mode"
2. Enable "Developer mode" 3. Click "Load unpacked"
3. Click "Load unpacked" 4. Select `extension/chrome` directory
4. Select `extension/chrome` directory
#### Firefox
#### Firefox
1. Navigate to `about:debugging`
1. Navigate to `about:debugging` 2. Click "This Firefox"
2. Click "This Firefox" 3. Click "Load Temporary Add-on"
3. Click "Load Temporary Add-on" 4. Select `extension/firefox/manifest.json`
4. Select `extension/firefox/manifest.json`
## Note
## Note
- <a href="https://kutt.it">Kutt.it</a> API permits **50** URLs shortening per day using the API Key
- <a href="https://kutt.it">Kutt.it</a> API permits **50** URLs shortening per day using the API Key - **Enable Custom Host** option to use with self-hosted kutt
- **Enable Custom Host** option to use with self-hosted kutt - Save the self hosted domain in the input (eg: `https://mykutt.it`)
- Save the self hosted domain in the input (eg: `https://mykutt.it`) - **Note**: the api endpoint is automatically appended during the api call
- **Note**: the api endpoint is automatically appended during the api call - _Delay at times while shortening might be the issue with Kutt.it API and not with the extension's_
- _Delay at times while shortening might be the issue with Kutt.it API and not with the extension's_
## Contributing and Support
## Contributing and Support
View the Contributing guidelines [here](CONTRIBUTING.md).
View the Contributing guidelines [here](CONTRIBUTING.md).
Original Repo: [thedevs-network/kutt](https://github.com/thedevs-network/kutt)
Original Repo: [thedevs-network/kutt](https://github.com/thedevs-network/kutt)
## License
## License
Code released under the [MIT License](license).
Code released under the [MIT License](license).

4
package.json
View File

@@ -16,11 +16,9 @@
"scripts": { "scripts": {
"dev:chrome": "cross-env TARGET_BROWSER=chrome vite build --config vite.config.ts --mode development --watch", "dev:chrome": "cross-env TARGET_BROWSER=chrome vite build --config vite.config.ts --mode development --watch",
"dev:firefox": "cross-env TARGET_BROWSER=firefox vite build --config vite.config.ts --mode development --watch", "dev:firefox": "cross-env TARGET_BROWSER=firefox vite build --config vite.config.ts --mode development --watch",
"dev:opera": "cross-env TARGET_BROWSER=opera vite build --config vite.config.ts --mode development --watch",
"build:chrome": "cross-env TARGET_BROWSER=chrome vite build --config vite.config.ts", "build:chrome": "cross-env TARGET_BROWSER=chrome vite build --config vite.config.ts",
"build:firefox": "cross-env TARGET_BROWSER=firefox vite build --config vite.config.ts", "build:firefox": "cross-env TARGET_BROWSER=firefox vite build --config vite.config.ts",
"build:opera": "cross-env TARGET_BROWSER=opera vite build --config vite.config.ts", "build": "npm run build:chrome && npm run build:firefox",
"build": "npm run build:chrome && npm run build:firefox && npm run build:opera",
"lint": "eslint .", "lint": "eslint .",
"lint:fix": "eslint . --fix" "lint:fix": "eslint . --fix"
}, },

2
source/globals.d.ts vendored
View File

@@ -1,5 +1,5 @@
declare const __DEV__: boolean; declare const __DEV__: boolean;
declare const __TARGET_BROWSER__: 'chrome' | 'firefox' | 'opera'; declare const __TARGET_BROWSER__: 'chrome' | 'firefox';
declare module '*.module.scss' { declare module '*.module.scss' {
const classes: {readonly [key: string]: string}; const classes: {readonly [key: string]: string};

10
source/manifest.json
View File

@@ -18,9 +18,6 @@
} }
}, },
"__chrome|firefox__author": "abhijithvijayan", "__chrome|firefox__author": "abhijithvijayan",
"__opera__developer": {
"name": "abhijithvijayan"
},
"action": { "action": {
"default_popup": "Popup/popup.html", "default_popup": "Popup/popup.html",
"default_icon": { "default_icon": {
@@ -32,13 +29,12 @@
"default_title": "Shorten this URL" "default_title": "Shorten this URL"
}, },
"background": { "background": {
"__chrome|opera__service_worker": "assets/js/background.bundle.js", "__chrome__service_worker": "assets/js/background.bundle.js",
"__chrome|opera__type": "module", "__chrome__type": "module",
"__firefox__scripts": ["assets/js/background.bundle.js"], "__firefox__scripts": ["assets/js/background.bundle.js"],
"__firefox__type": "module" "__firefox__type": "module"
}, },
"__chrome__minimum_chrome_version": "88", "__chrome__minimum_chrome_version": "88",
"__opera__minimum_opera_version": "74",
"permissions": [ "permissions": [
"activeTab", "activeTab",
"storage" "storage"
@@ -50,7 +46,7 @@
"content_security_policy": { "content_security_policy": {
"extension_pages": "script-src 'self'; object-src 'self';" "extension_pages": "script-src 'self'; object-src 'self';"
}, },
"__chrome|opera__options_page": "Options/options.html", "__chrome__options_page": "Options/options.html",
"options_ui": { "options_ui": {
"page": "Options/options.html", "page": "Options/options.html",
"open_in_tab": true "open_in_tab": true

4
vite.config.ts
View File

@@ -16,10 +16,6 @@ export default defineConfig(({mode}) => {
const getExtensionZipFileName = () => { const getExtensionZipFileName = () => {
switch (targetBrowser) { switch (targetBrowser) {
case 'opera': {
return `${targetBrowser}.crx`;
}
case 'firefox': { case 'firefox': {
return `${targetBrowser}.xpi`; return `${targetBrowser}.xpi`;
} }