Home
Softono
kutt-extension

kutt-extension

Open source MIT TypeScript
149
Stars
43
Forks
9
Issues
3
Watchers
1 month
Last Commit

About kutt-extension

<div align="center"><img width="150" src="source/public/assets/logo.png" /></div> <h1 align="center">kutt-extension</h1> <p align="center">Browser extension for <a href="https://kutt.it">Kutt.it</a> URL shortener</p> <div align="center"> <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" /> </a> <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" /> </a> <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" /> </a> <a href="https://github.com/thedevs-network/kutt-extension/issues?q=is%3Aissue+is%3Aclosed"> <img src="https://img.sh ...

Platforms

Web Self-hosted

Languages

TypeScript

Links

kutt-extension

Browser extension for Kutt.it URL shortener


❤️ it? ⭐️ it on GitHub

Features

  • Minimal UI
  • Instant QR Code
  • Cross Browser Support
  • Supports Secure Passwords for URLs
  • History & Incognito Feature
  • Auto Copy Feature
  • Free and Open Source
  • Uses WebExtensions API

Tech Stack

  • Bundler: Vite 6
  • UI: React 19
  • Language: TypeScript 5.7
  • Styling: SCSS with CSS Modules
  • Linting: ESLint 9 (flat config) + Prettier

Browser Support

This extension uses Manifest V3.

Chrome Firefox Opera Edge Brave
88+ 109+ 74+ 88+ 1.21+

Installation

How to Use

  1. Generate an API Key from https://kutt.it/ after signing up (Settings page)

  2. Paste and Save this Key in extension's options page when asked

Screenshots

popup
_
options

Development

Ensure you have Node.js 20 or later installed.

# Install dependencies
npm install

# Start development server
npm run dev:chrome    # For Chrome
npm run dev:firefox   # For Firefox

# Build for production
npm run build:chrome  # Build Chrome extension
npm run build:firefox # Build Firefox addon
npm run build         # Build for all browsers

# Linting
npm run lint          # Run ESLint
npm run lint:fix      # Run ESLint with auto-fix

Loading the Extension

Chrome

  1. Navigate to chrome://extensions
  2. Enable "Developer mode"
  3. Click "Load unpacked"
  4. Select extension/chrome directory

Firefox

  1. Navigate to about:debugging
  2. Click "This Firefox"
  3. Click "Load Temporary Add-on"
  4. Select extension/firefox/manifest.json

Note

  • Kutt.it API permits 50 URLs shortening per day using the API Key
  • Enable Custom Host option to use with self-hosted kutt
    • Save the self hosted domain in the input (eg: https://mykutt.it)
    • 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

Contributing and Support

View the Contributing guidelines here.

Original Repo: thedevs-network/kutt

License

Code released under the MIT License.