Tauri License Starter

Clone-and-run Tauri v2 app with Keymint license activation pre-configured in Rust. Machine binding, activation UI, and license state persistence included.

Quick Start

git clone https://github.com/keymint-dev/keymint-tauri-starter.git
cd keymint-tauri-starter
npm install
# Edit src-tauri/.cargo/config.toml with your KEYMINT_CLIENT_API_KEY and KEYMINT_PRODUCT_ID
npm run tauri dev

Opens a Tauri window with an activation form. Enter a valid Keymint license key and the form shows the activation result. The starter has no main view behind the license; gate your own UI on the is_activated command.

What's Included

• Rust license backend — reqwest HTTP calls to Keymint API from Tauri commands
• Hardware fingerprint — machine-uid crate for stable host ID across platforms
• Activation UI — a plain HTML page (src/index.html, no framework) with a key field that calls the Rust activate_license command through invoke()
• Persistent state — License key and activation state stored in license.json under the OS local data directory
• Deactivation — the deactivate_license command frees the activation seat. The starter's page has no button for it; call it from your own UI
• Tauri commands — activate_license, deactivate_license, is_activated, get_license_status

Configuration

Set environment variables before building:

export KEYMINT_CLIENT_API_KEY=km_live_your_client_key
export KEYMINT_PRODUCT_ID=YOUR_PRODUCT_ID

Or add to src-tauri/.cargo/config.toml:

[env]
KEYMINT_CLIENT_API_KEY = "km_live_your_client_key"
KEYMINT_PRODUCT_ID = "YOUR_PRODUCT_ID"

Project Structure

src-tauri/
├── src/
│   ├── main.rs        # Tauri app setup, command registration
│   ├── lib.rs         # Library target (mobile builds and cargo test)
│   └── license.rs     # Keymint REST API calls (reqwest), state persistence
├── Cargo.toml         # Rust dependencies
├── tauri.conf.json    # Tauri config
└── .cargo/
    └── config.toml    # Build-time env vars (API key, product ID)

src/
└── index.html         # Webview frontend: activation form (plain HTML/JS)

API Endpoints Called from Rust

Tauri Commands

Security

• KEYMINT_CLIENT_API_KEY is compiled into the Rust binary via option_env!() — not exposed to the webview, but extractable from the binary, so use a client key only
• The client scope only allows activation, deactivation, and floating session management
• License state is stored as plain JSON in the OS local data directory (dirs::data_local_dir()/tauri-license-starter/license.json)

Build & Package

npm run tauri build

Produces platform-specific installers in src-tauri/target/release/bundle/.

Next Steps

• Add floating license support for concurrent seat licensing
• Add periodic license health checks to detect revocations
• Wire up Stripe subscription licensing for paid plans