theme
Theme development commands for scaffolding, previewing, and publishing themes. These are available as shortcuts (prefixed with +) for streamlined workflows.
+init
Scaffold a new theme based on Nova 2023.
shoplazza themes init --name <dir>
Flags
| Flag | Type | Description |
|---|---|---|
--name <dir> | string | Target directory name for the new theme (required) |
Clones the Nova 2023 template to your local machine as a starting point for theme development.
+serve
Upload the current theme to a store and preview it with live reload.
shoplazza themes serve [flags]
Flags
| Flag | Type | Description |
|---|---|---|
--theme-id, -t <THEME_ID> | string | Theme ID to preview. If omitted, uses a development theme. |
--port <PORT> | int | LiveReload server port (default: 21647) |
This command returns:
- A preview link to share with other developers
- A link to the theme editor in the Shoplazza admin
CSS and section changes trigger hot reload. Other file changes automatically refresh the page.
You can only run this command in a directory that matches the default Shoplazza theme directory structure.
+pull
Download theme files from a Shoplazza store.
shoplazza themes pull [flags]
Flags
| Flag | Type | Description |
|---|---|---|
--theme-id, -t <THEME_ID> | string | Theme ID to pull (required). Run shoplazza themes list to discover. |
+push
Upload local theme files to a Shoplazza store, overwriting the remote version.
shoplazza themes push [flags]
Flags
| Flag | Type | Description |
|---|---|---|
--theme-id, -t <THEME_ID> | string | Theme ID to overwrite (required). Run shoplazza themes list to discover. |
+package
Package local theme files into a ZIP file.
shoplazza themes package [flags]
Flags
| Flag | Type | Description |
|---|---|---|
--no-ignore | bool | Ignore .themeignore rules (default: false) |
The ZIP file is named theme_name-theme_version.zip based on your settings_schema.json.
+share
Upload your theme as a new, unpublished theme and return a shareable preview link.
shoplazza themes share
Related
- Theme CLI guide — Theme-focused documentation
- themes-api — Full API commands for themes (list, get, create, delete, publish, file management)