License
Activate License

Activate License

When using Hugeicons Pro icons, activate your license key to unlock all the Pro icons and developer features for your awesome projects.

To get started with a Hugeicons Pro package, you need to install it from npm, pnpm, yarn or bun.

Note: You can now use our private npm registry to install the Hugeicons Pro packages, and they are available for all users with an active subscription.

🔥 Our custom registry now supports all pro styles 🔥

# Stroke Styles
✨ @hugeicons-pro/core-stroke-rounded
✨ @hugeicons-pro/core-stroke-sharp
✨ @hugeicons-pro/core-stroke-standard
 
# Solid Styles
✨ @hugeicons-pro/core-solid-rounded
✨ @hugeicons-pro/core-solid-sharp
✨ @hugeicons-pro/core-solid-standard
 
# Special Styles
✨ @hugeicons-pro/core-bulk-rounded
✨ @hugeicons-pro/core-duotone-rounded
✨ @hugeicons-pro/core-twotone-rounded

Configuration

Follow the steps below to install our Hugeicons packages and start using the icons in your project.

1. Create an Account

Visit our website hugeicons.com (opens in a new tab) and create an account or log in if you already have one.

2. Get Your Universal License Key

Navigate to the Tokens tab and copy your Universal License Key to use as your npm token.

3. Authentication

For NPM and old Yarn versions:

  • Create a new .npmrc file in your project root directory.

  • Add the following line to your .npmrc file

//registry.npmjs.org/:_authToken=UNIVERSAL_LICENSE_KEY
  • For the new npm registry, use the following registry:
@hugeicons-pro:registry=https://npm.hugeicons.com/
//npm.hugeicons.com/:_authToken=UNIVERSAL_LICENSE_KEY

For new Yarn versions:

  • Add the following line to your .yarnrc.yml file
npmScopes:
  hugeicons-pro:
    npmAlwaysAuth: true
    npmAuthToken: UNIVERSAL_LICENSE_KEY
    npmRegistryServer: "https://npm.hugeicons.com/"

For Bun:

First, ensure you have Bun installed (latest version: v1.2.20):

Installation:

  • macOS & Linux:
curl -fsSL https://bun.sh/install | bash
  • Windows (PowerShell):
powershell -c "irm bun.sh/install.ps1 | iex"
  • Using npm:
npm install -g bun
  • Using Homebrew (macOS):
brew tap oven-sh/bun
brew install bun

Configuration:

You can configure Bun authentication using either .npmrc (recommended, same as npm) or bunfig.toml:

Option 1: Using .npmrc (Recommended)

  • Create or edit a .npmrc file in your project root directory:
@hugeicons-pro:registry=https://npm.hugeicons.com/
//npm.hugeicons.com/:_authToken=UNIVERSAL_LICENSE_KEY

Replace UNIVERSAL_LICENSE_KEY with the key you copied from the Tokens tab.

Option 2: Using bunfig.toml (with environment variable)

  1. Create a .env file in your project root directory:
# .env
UNIVERSAL_LICENSE_KEY="YOUR KEY" # Get your Universal License Key from https://hugeicons.com/account/tokens
  1. Create or edit a bunfig.toml file in your project root directory:
[install.scopes]
@hugeicons-pro = { token = "$UNIVERSAL_LICENSE_KEY", url = "https://npm.hugeicons.com/" }

This approach uses environment variables for better security and prevents accidentally committing your license key to version control.

IntroductionTroubleshooting