@keenmate/pureadmin

The official CLI for Pure Admin — a lightweight, data-focused CSS/SCSS admin framework built for real applications.

Build themes, validate accessibility, scaffold apps, and publish to pureadmin.io.

• 14 themes — Audi, Ayu, Cobalt2, Corporate, Dark, Darkmatter, Dracula, Express, Gruvbox, Minimal, Night Owl, One Dark, Tokyo Night, Cafe Industrial
• Browse & download — pureadmin.io
• Theme source — github.com/keenmate/pure-admin-themes
• Framework source — github.com/keenmate/pure-admin

Install

npm install -g @keenmate/pureadmin

Or use without installing:

npx @keenmate/pureadmin <command>

Commands

build — Compile SCSS to CSS

# Build all themes in workspace
pureadmin build

# Build specific theme(s)
pureadmin build audi corporate

Works in multi-theme workspaces (directories with theme.json) and single-theme projects.

pack — Package theme into ZIP

# Build + pack all themes
pureadmin pack

# Pack specific theme(s)
pureadmin pack audi

# Pack without building (use existing CSS)
pureadmin pack audi --no-build

Computes SHA-256 checksums for all files, metadata hash, content_sha, detects external domains in CSS, and rejects undeclared JavaScript.

publish — Pack + upload to pureadmin.io

# Build + pack + upload all themes
pureadmin publish

# Publish specific theme
pureadmin publish audi

# With explicit API key
pureadmin publish audi --api-key YOUR_KEY

API key resolution (in order of precedence):

1. --api-key flag
2. .pureadmin.json → apiKey (gitignored, local overrides)
3. pureadmin.json → apiKey (project config)
4. ~/.pureadmin.json → apiKey (user defaults)
5. $PUREADMIN_API_KEY environment variable

validate — Check theme CSS quality

# Validate all themes in workspace
pureadmin validate

# Validate specific theme
pureadmin validate audi

Checks:

• Readability — WCAG contrast ratios for outline/filled buttons and color slots per mode (dark/light)
• CSS Variables — Required --pa-* variable definitions
• Consistency — Hardcoded border-radius values that should use CSS variables

list — List all themes

pureadmin list

Shows all available themes with slug, version, and tags.

info — Show theme details

pureadmin info audi

Output includes versions, core compatibility, font, tags, variants, and content SHA.

versions — Show available versions

pureadmin versions audi

search — Search themes

pureadmin search dark
pureadmin search "custom font"

compatible — List compatible themes

Filter themes by pure-admin-core version:

pureadmin compatible 2.0.0

download — Download a theme ZIP

# Latest version
pureadmin download audi

# Specific version
pureadmin download audi --version 2.0.2

# Custom output filename
pureadmin download audi --output my-theme.zip

themes — Manage project themes

List configured themes:

pureadmin themes

Add themes to your project (downloads + extracts to the configured directory):

# Add a single theme
pureadmin themes express

# Add multiple themes
pureadmin themes audi dark express

# Offline mode — theme files committed to repo for builds without network
pureadmin themes express --offline

# Custom output directory
pureadmin themes express --dir public/themes

Theme configuration is saved to pureadmin.json:

{
  "themesDir": "static/themes",
  "themes": {
    "audi": { "version": "2.0.2", "content_sha": "sha256:61df...", "offline": false },
    "express": { "version": "2.0.2", "content_sha": "sha256:1d77...", "offline": true }
  }
}

• online (--offline not set) — theme files are re-downloaded on pureadmin update. Gitignore them.
• offline (--offline) — theme files are committed to the repo. Build pipelines work without network access. pureadmin update still refreshes them when run with network.

update — Update themes

Checks each configured theme's content_sha against the server and re-downloads only what changed:

pureadmin update

init — Scaffold a new theme project

Creates a theme package project with template files and development tools:

pureadmin init my-theme "My Custom Theme"
cd my-theme
npm install
npm run build
npm run pack

create — Create a Pure Admin app

Scaffolds an app with Pure Admin components, theme switching, and FOUC prevention:

# Default SvelteKit app
pureadmin create my-app

# With specific themes and features
pureadmin create my-app --themes audi,dark --theme audi --font-awesome --profile-panel

# From a local template
pureadmin create my-app --template-path ../pure-admin-templates/svelte-spa

# With company preset
pureadmin create my-app --company keenmate --preset full

Options:

Flag	Description
--name <name>	Custom display name
--template <name>	App template (default: sveltekit)
--template-path <dir>	Use a local template directory
--themes <list>	Comma-separated theme slugs (default: corporate,audi,dark)
--theme <slug>	Default theme (default: first in --themes)
--font-awesome	Include FontAwesome 6 icons via CDN
--profile-panel	Include user profile slide-in panel
--settings-panel	Include theme switcher panel
--company <name>	Load company defaults from ~/.pureadmin.json
--preset <name>	Load feature/page preset from ~/.pureadmin.json
--no-makefile	Skip Makefile generation
--no-install	Skip dependency installation
--no-build	Skip initial build
--verbose	Show debug output

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

templates — Manage and publish templates

# List available templates from pureadmin.io
pureadmin templates list

# Pack template(s) into ZIP
pureadmin templates pack
pureadmin templates pack svelte-spa

# Pack + upload to pureadmin.io
pureadmin templates publish
pureadmin templates publish svelte-sveltekit

Run from a templates workspace (multiple template dirs) or a single template directory.

Configuration

All configuration is JSON. Three levels, merged in order (later overrides earlier):

File	Purpose	Check in?
~/.pureadmin.json	User defaults (API URL, key)	N/A
pureadmin.json	Project config (themes, URL)	Yes
.pureadmin.json	Local overrides (API key)	No (gitignore)

CLI flags (--server, --api-key) and env vars (PUREADMIN_URL, PUREADMIN_API_KEY) override all config files.

pureadmin.json (project config)

Checked into the repo. Tracks themes and project settings:

{
  "url": "https://pureadmin.io",
  "themesDir": "static/themes",
  "themes": {
    "audi": { "version": "2.3.2", "content_sha": "sha256:...", "offline": false }
  }
}

.pureadmin.json (local overrides)

Gitignored. Merges on top of pureadmin.json — use for secrets:

{
  "apiKey": "your-api-key-here"
}

~/.pureadmin.json (user defaults)

Base defaults for all projects. On Windows: C:\Users\<username>\.pureadmin.json

{
  "url": "https://pureadmin.io",
  "apiKey": "your-default-key"
}

License

MIT