@sky.ui/cli

Command-line tools for Sky UI Pro licensing — device login, guided install, license status, and optional npm setup.

This package powers sky.ui.pro (npx sky.ui.pro). Most users should run commands through npx; install @sky.ui/cli directly only when bundling or scripting against it.

Install

npm install -g sky.ui.pro
# or
npm install @sky.ui/cli

Quick start

npx sky.ui.pro login
npx sky.ui.pro install

Or run the interactive menu:

npx sky.ui.pro

Commands

| Command | Description | |---------|-------------| | sky.ui.pro login | Browser device login; saves personal token for Pro installs | | sky.ui.pro install | Install Pro packages for your stack, then hydrate licensed artifacts | | sky.ui.pro install --yes | Non-interactive install | | sky.ui.pro install --verbose | Show full package manager output and hydration logs | | sky.ui.pro install --framework=vue | Force stack (vue, react, or core) | | sky.ui.pro status | Account and license status | | sky.ui.pro setup-npm | Print optional legacy .npmrc snippet | | sky.ui.pro logout | Clear local session |

After npm install of @sky.ui.pro/* stubs, sky.ui.pro install hydrates the full licensed package into node_modules (replacing the stub manifest while keeping the public package name).

Credentials are stored in ~/.sky.ui/credentials.json.

Environment

Copy packages/pro/npm/env.example to your app root as .env.

| Variable | Description | |----------|-------------| | SKY_UI_API_URL | API host (default production; local: http://127.0.0.1:3001) | | SKY_UI_AUTH_TOKEN | CI/CD token (sk_ci_…) | | SKY_UI_PERSONAL_TOKEN | Personal token (sk_pt_…) | | SKY_UI_PROJECT_ROOT | Optional explicit project root when cwd is ambiguous | | SKY_UI_PRO_FRAMEWORK | CI/non-TTY: core, vue, or react when auto-detect is ambiguous | | SKY_UI_PRO_LENIENT | CLI hydration: warn-only when token missing (default is strict) | | SKY_UI_PRO_LICENSE_LENIENT | Build plugins: warn-only on production build | | SKY_UI_PRO_SKIP_HYDRATE | Skip Pro package hydration entirely | | SKY_UI_PRO_SKIP_POSTINSTALL | Alias for SKY_UI_PRO_SKIP_HYDRATE | | SKY_UI_PRO_STRICT | Legacy alias; install is strict by default unless SKY_UI_PRO_LENIENT=1 |

The CLI reads SKY_UI_* from .env / .env.local using the same resolver as bundler plugins (INIT_CWD, npm prefix, SKY_UI_PROJECT_ROOT, cwd walk). Shell variables are never overwritten.

PowerShell

Quote scoped package names if you run npm yourself — npm install "@sky.ui.pro/core". Unquoted @ is PowerShell splatting.

npx sky.ui.pro login works on Windows (the npm package is sky.ui.pro; the executable shim is sky-ui-pro so Windows does not treat .pro as a file extension). After a global install, use sky-ui-pro login or keep using npx sky.ui.pro login.

See powershell-scoped-packages.md.

Stack detection

| package.json | Behavior | |----------------|----------| | vue or @sky.ui/vue only | Installs Vue stack | | react or @sky.ui/react only | Installs React stack | | Neither | Prompts (Core / Vue / React) in interactive terminal | | Both Vue and React | Prompts to pick one stack |

Non-interactive (--yes, CI): use --framework=… or SKY_UI_PRO_FRAMEWORK when ambiguous; otherwise defaults to Core with a notice.

Related packages

| Package | Role | |---------|------| | sky.ui.pro | npx entry point (recommended) | | @sky.ui.pro/core | Pro Lit components (stub until hydrated) | | @sky.ui.pro/vue | Pro Vue wrappers (stub until hydrated) | | @sky.ui.pro/react | Pro React wrappers (stub until hydrated) |

License

Sky UI Pro Commercial License — proprietary. The CLI is free to run for login and install; Pro components it hydrates require an active subscription.