SalsaFX Pro

SalsaFX Pro (@salsafx/ui-pro) is the commercial edition of SalsaFX. It provides a drop-in replacement for the open-source package with full commercial licensing and exclusive enterprise HMI components.

Commercial projects

This edition is licensed for closed-source applications, proprietary SaaS, and customer deliverables without AGPL copyleft obligations. See the Commercial Licence.

Pro release@salsafx/ui-prov16.62.0

Looking for the free open-source edition?

If you are building an open-source project and do not need commercial licensing or Pro components, see the Installation guide for @salsafx/ui.

---

Why SalsaFX Pro

• Commercial & Closed-Source Ready — Build proprietary industrial dashboards, embedded web HMIs, and commercial SaaS products without AGPL-3.0 source disclosure requirements.
• Pro-Exclusive Components — Access specialized controls such as status pills, header badges, and precision digital/analog clocks designed for real-time monitoring.
• Drop-in Compatibility — @salsafx/ui-pro includes all core components from @salsafx/ui. You only need a single dependency in your project.
• Dedicated Private Registry — Stable, token-authenticated access hosted on https://npm.salsafx.com with proxied open-source dependencies.

If your team does not have a license yet, explore our Plans or contact us for custom OEM licensing.

---

Installation

SalsaFX Pro is distributed via our private registry at https://npm.salsafx.com. After purchasing a license, you receive a secure access token.

1. Configure the @salsafx registry

   Create an .npmrc file in your project root:

   @salsafx:registry=https://npm.salsafx.com
   //npm.salsafx.com/:_authToken=${SALSAFX_PRO_TOKEN}

   Set SALSAFX_PRO_TOKEN as an environment variable in your development environment and CI/CD secrets. Public @salsafx/ui packages are also proxied through this registry, so no additional configuration is needed.

2. Install the package

   npm

   npm install @salsafx/ui-pro

   pnpm

   pnpm add @salsafx/ui-pro

   yarn

   yarn add @salsafx/ui-pro

   bun

   bun add @salsafx/ui-pro

3. Install Lit (peer dependency)

   npm

   npm install lit

   pnpm

   pnpm add lit

   yarn

   yarn add lit

   bun

   bun add lit

Caution

Never commit authentication tokens to your Git repository. Always supply SALSAFX_PRO_TOKEN through environment variables or secret managers.

---

Usage

Replace your @salsafx/ui import with @salsafx/ui-pro:

import '@salsafx/ui-pro';

Because @salsafx/ui-pro includes all open-source controls, every guide in the Reference documentation works out of the box.

Pro-Exclusive Components

The Pro package introduces additional components specifically crafted for production HMI/SCADA environments:

• Badge (<fx-badge>) — Compact uppercase status and unit indicator for cards, toolbars, and section headers with icon slot and color variants.
• Pill (<fx-pill>) — Rounded live status chip with pulsing blink animations, icons, and translucent backgrounds for header strips.
• Live & Digital Clocks (<digital-clock>, <live-clock>) — Real-time high-precision analog and digital clock widgets powered by dedicated workers.

For full license comparisons and legal terms, see Licensing and the Commercial Licence.