Build and publish a theme
This tutorial scaffolds a theme, previews it with live reload, and pushes it to a store. Theme commands are subcommands of shoplazza themes.
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 prints a preview link to share and a link to the theme editor in the admin. Each saved change is synced to the theme and reloads the page. Press Ctrl-C to stop.
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. In a terminal, you can omit --theme-id and pick a theme from a list. push asks you to confirm before it overwrites the theme.
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:
shoplazza themes publish --params '{"theme_id":"<THEME_ID>"}'
See themes (API) for publish and file management, and the Theme CLI guide for the full theme workflow.