Build and publish a theme
This tutorial scaffolds a theme, previews it with live reload, and pushes it to a store. Theme commands are shortcuts prefixed with +.
Prerequisites
- Shoplazza CLI installed — see Install
- Authenticated — see Authentication
1. Scaffold from Nova 2023
shoplazza themes init --name my-theme
cd my-theme
This clones the Nova 2023 template as your starting point.
2. Preview with live reload
Upload the theme to a store and preview it as a development theme:
shoplazza themes serve
The command returns a preview link to share and a link to the theme editor in the admin. CSS and section edits hot-reload; other changes refresh the page.
Run themes serve from a directory that matches the default theme structure.
3. Pull and push
Download files from a store, or overwrite the remote version with your local files:
shoplazza themes pull --theme-id <THEME_ID>
shoplazza themes push --theme-id <THEME_ID>
Run shoplazza themes list to discover theme IDs.
4. Share or package
Upload as a new, unpublished theme and get a shareable preview link:
shoplazza themes share
Or package the theme into a ZIP for distribution:
shoplazza themes package
Publishing
To publish a theme live, use the theme API commands — see themes (API) for publish and file management, and the Theme CLI guide for the full theme workflow.