CLI — pureadmin.io

Scaffold apps from templates, manage themes, configure company profiles, and publish to pureadmin.io.

Install

# Use directly with npx (no install needed)\nnpx @keenmate/pureadmin --help\n\n# Or install globally\nnpm install -g @keenmate/pureadmin\npureadmin --help\n\n# LLM/AI assistants: get full CLI reference\npureadmin --llm

Quick Start

Interactive wizard

pureadmin create

Launches an interactive wizard that guides you through template selection, features, icon provider, themes, and color variant/mode. Remembers your last selections and supports saved presets.

Direct create

# SvelteKit app with Font Awesome and profile panel\npureadmin create my-app --template svelte-sveltekit --font-awesome --profile-panel\n\n# Svelte SPA with Lucide icons\npureadmin create my-app --template svelte-spa --lucide\n\n# With company profile and preset\npureadmin create my-app --company keenmate --preset full

Add themes to an existing project

pureadmin themes add audi dark corporate\npureadmin themes update

Commands

Command	Description
App
create [name]	Create a Pure Admin app (interactive wizard if no name)
Themes
themes list	List all themes from API (`--local` for project themes)
themes show <id>	Show theme details, versions, variants, modes
themes add [id...]	Add themes to project (`--offline`, `--dir`)
themes search <query>	Search themes by name, description, or tags
themes download <id>	Download a theme ZIP (`--version`, `--output`)
themes update	Re-download changed themes
themes init <id> [name]	Scaffold a new theme project
themes build / pack / publish	Build SCSS, package ZIP, upload to pureadmin.io
themes validate [id...]	Check CSS quality (WCAG contrast, variables, consistency)
Templates
templates list	List available templates from API
templates pack / publish	Package and upload templates to pureadmin.io
Config
profiles list / show / delete	Manage company profiles and workspace mappings
presets list / show / delete	Manage saved create wizard configurations
help [command] [sub]	Show detailed help for a command or subcommand

Create Options

Flag	Description
--template <id>	Template to fetch from API (e.g. `svelte-sveltekit`, `svelte-spa`)
--template-path <dir>	Use a local template directory instead of fetching from API
--name <name>	Display name for navbar and README
--themes <list>	Comma-separated theme slugs to download
--theme <slug>	Default theme (determines initial CSS and FOUC prevention mode)
--font-awesome	Font Awesome 6 icons via CDN (default)
--lucide	Lucide icons (tree-shakeable Svelte components)
--profile-panel	User profile slide-in panel
--settings-panel	Theme/mode switcher panel
--company <id>	Company profile from `~/.pureadmin.json`
--no-install	Skip dependency installation

Package manager is auto-detected (pnpm > bun > npm) and used for install, Makefile, and next steps.

Configuration

Config files are JSON, merged in priority order:

Source	Priority	Description
$PUREADMIN_API_KEY	Highest	API key for uploads
$PUREADMIN_URL	High	API base URL override
.pureadmin.json	Medium	Project local overrides (gitignored, API key)
pureadmin.json	Medium	Project config (committed, themes + themesDir)
~/.pureadmin.json	Low	User defaults (companies, workspaces, presets, URL, key)

Workspace detection

Map directory paths to company profiles in ~/.pureadmin.json. When running from a matching directory, the company is auto-selected in the wizard.

{
  "workspaces": {
    "C:/Git/KM": {
      "defaultCompany": "keenmate",
      "companies": ["keenmate", "babetti"]
    }
  },
  "companies": {
    "keenmate": {
      "name": "KeenMate s.r.o.",
      "copyright": "© 2026 KeenMate s.r.o.",
      "defaultThemes": "corporate,audi,dark",
      "defaultTheme": "corporate"
    }
  }
}

Online vs Offline Themes

Online (default) — theme files are downloaded by pureadmin themes update and should be gitignored.
Offline (--offline) — theme files are committed to the repo. Builds work without network access.

# Online — gitignore theme files, re-download on CI\npureadmin themes add audi corporate\n\n# Offline — commit to repo, no network needed at build time\npureadmin themes add express --offline

@keenmate/pureadmin CLI