Skip to main content

Theme commands

This reference lists the Shoplazza CLI commands for theme development. For the full command reference (all topics), see the CLI command reference.

Command overview

CommandDescription
themes initScaffold a new theme based on Nova 2023
themes servePreview theme with live reload
themes pullDownload theme from store
themes pushUpload theme to store
themes shareShare a preview link
themes packagePackage theme as ZIP
themes publishPublish a theme
themes listList store themes
themes deleteDelete a theme
auth loginLog in to Shoplazza
auth logoutLog out
auth store useSwitch store
versionShow CLI version
helpShow help

Theme shortcuts

init

Scaffold a new theme based on Nova 2023.

shell
shoplazza themes init --name <dir>

serve

Upload the current theme to a store and preview it with live reload.

shell
shoplazza themes serve

This command returns:

  • A preview link that you can share with other developers
  • A link to the theme editor in the Shoplazza admin

serve flags

FlagDescription
--theme-id, -t <THEME_ID>Theme ID to preview. If omitted, uses a development theme.

pull

Download theme files from Shoplazza.

shell
shoplazza themes pull --theme-id <THEME_ID>

pull flags

FlagDescription
--theme-id, -t <THEME_ID>Theme ID to pull (required). Run shoplazza themes list to discover.

push

Upload local theme files to Shoplazza, overwriting the remote version.

shell
shoplazza themes push --theme-id <THEME_ID>

push flags

FlagDescription
--theme-id, -t <THEME_ID>Theme ID to overwrite (required). Run shoplazza themes list to discover.

share

Upload your theme as a new, unpublished theme and return a shareable preview link.

shell
shoplazza themes share

package

Package local theme files into a ZIP file named theme_name-theme_version.zip.

shell
shoplazza themes package

Theme API commands

list

List all themes in your store with their IDs and statuses.

shell
shoplazza themes list --format table

publish

Publish a theme to the live store.

shell
shoplazza themes publish --id <THEME_ID>

delete

Delete a theme from your store.

shell
shoplazza themes delete --id <THEME_ID>

Authentication commands

login

Log in via OAuth 2.0:

shell
shoplazza auth login --store-domain my-store.myshoplaza.com --domain themes

login flags

FlagDescription
--store-domain <domain>Store domain to connect to
--domain <domains>Business domains for scope expansion

logout

Log out and remove stored credentials:

shell
shoplazza auth logout

store use

Switch to a different store:

shell
shoplazza auth store use --store-domain another-store.myshoplaza.com

Utility commands

version

Display the CLI version:

shell
shoplazza version

help

List available commands:

shell
shoplazza help
shoplazza help [command]
shoplazza [command] --help