Skip to content

thedevs-network/kutt-extension

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.