npm.io
1.0.0 • Published 3d agoCLI

create-safqi-theme

Licence
proprietary
Version
1.0.0
Deps
0
Size
648 kB
Vulns
0
Weekly
0
SummaryDependencyVersions

create-safqi-theme

Scaffold a standalone Safqi storefront theme built on @safqi/storefront-core.

# a full runtime theme (owns its presentation, depends on the versioned core)
npx create-safqi-theme my-shop

# a zero-build variant (re-skin of an existing runtime theme via tokens.css)
npx create-safqi-theme my-shop --kind=variant --extends=basic

# point at a local/prerelease core (git url or file: path)
npx create-safqi-theme my-shop --core=file:../storefront-core

Flags

flag default meaning
<name> — theme name (positional); the slug is derived from it
--kind runtime runtime (full Vite build) or variant (zero-build overlay)
--extends basic variant only — the runtime theme it re-skins
--slug from name override the derived slug
--title from name <title> / display name
--core ^1.0.0 npm spec for @safqi/storefront-core (caret, git url, or file: path)
--author — package author

What you get

  • runtime — a complete, buildable theme: theme.config.json, vite.config.ts (via the core defineThemeConfig preset), a thin main.tsx (bootStorefront), the token palette, chrome, ProductCard, the pattern engine, section renderers, pages, an embedded theme-feature skill + CLAUDE.md, and scripts/gen-reference.mjs (npm run reference) which writes a drift-free THEME-REFERENCE.md + capabilities.json from the installed core — the list of patterns, section types, settings, and endpoints the theme may consume.
  • variant — just theme.config.json + tokens.css + a README. No build.

The upgrade story

The core is versioned. A runtime theme floats on @safqi/storefront-core: ^1 and upgrades with npm update @safqi/storefront-core && npm run build. A variant inherits automatically via its runtime's bundle. One bump, every theme current.

Keywords

safqistorefrontthemegeneratorscaffold