checkout-extension

Build, develop and manage Shoplazza checkout extensions. Alias: checkout.

init

Scaffold a new checkout extension project (local, no network).

shoplazza checkout-extension init --name <project> --extension <first-extension>

Flags

Flag	Type	Description
--name	string	Project name (directory created in cwd)
--extension	string	First extension name

Examples

shoplazza checkout init --name my-project --extension my-ext

create

Create a new extension in an existing project (local, no network). Must be run inside a project created by init.

shoplazza checkout-extension create --name <extension>

Flags

Flag	Type	Description
--name	string	Extension name

Examples

shoplazza checkout create --name another-ext

dev

Run the checkout extension dev server (rebuild + HMR on :8888).

shoplazza checkout-extension dev [flags]

Flags

Flag	Type	Description
--extension-name	stringSlice	Extension name(s) to develop (repeatable, comma-separated)
--all	bool	Develop all extensions under ./extensions

Examples

# Develop a single extension
shoplazza checkout dev --extension-name my-ext

# Develop multiple extensions
shoplazza checkout dev --extension-name ext1,ext2

# Develop all extensions
shoplazza checkout dev --all

build

Build a checkout extension with the bundled Vite toolchain.

shoplazza checkout-extension build [flags]

Flags

Flag	Type	Description
--name	string	Extension name (the directory under ./extensions); optional inside an extension dir
--debug	bool	Verbose build logs to stderr

Examples

# Build from the project root
shoplazza checkout build --name my-ext

# Build from inside the extension directory
cd extensions/my-ext && shoplazza checkout build

push

Build and upload a new extension version (does NOT activate it). Use deploy to activate afterward.

shoplazza checkout-extension push --name <extension> [flags]

Flags

Flag	Type	Description
--name	string	Extension name (the directory under ./extensions) — required
--version	string	Optional. Write this version into extension.json before pushing (must be greater than the last pushed version)
--debug	bool	Verbose build logs to stderr

Examples

shoplazza checkout push --name my-ext
shoplazza checkout push --name my-ext --version 1.1

deploy

Activate a previously pushed extension version.

shoplazza checkout-extension deploy --extension-id <id> --version <version>

Flags

Flag	Type	Description
--extension-id	string	Server-side extension id
--version	string	Version to activate, e.g. 1.0 (resolved to its server id via checkout versions)
--dry-run	bool	Print the request that would be sent without executing it

Examples

shoplazza checkout deploy --extension-id abc123 --version 1.0

undeploy

Undeploy an extension (extension-level, no confirmation).

shoplazza checkout-extension undeploy --extension-id <id>

Flags

Flag	Type	Description
--extension-id	string	Server-side extension id — required
--dry-run	bool	Print the request that would be sent without executing it

Examples

shoplazza checkout undeploy --extension-id abc123

list

List checkout extensions. By default shows only published extensions.

shoplazza checkout-extension list [flags]

Flags

Flag	Type	Description
--all, -a	bool	List all extensions (not just published)
--dry-run	bool	Print the request that would be sent without executing it

Examples

shoplazza checkout list
shoplazza checkout list --all

versions

List versions of a checkout extension.

shoplazza checkout-extension versions --extension-id <id>

Flags

Flag	Type	Description
--extension-id	string	Server-side extension id (from checkout list) — required
--dry-run	bool	Print the request that would be sent without executing it

Examples

shoplazza checkout versions --extension-id abc123

preview

Generate a preview URL for an extension version.

shoplazza checkout-extension preview --extension-id <id> --version <version>

Flags

Flag	Type	Description
--extension-id	string	Server-side extension id
--version	string	Version to preview, e.g. 1.0 (resolved to its server id via checkout versions)
--dry-run	bool	Print the request that would be sent without executing it

Examples

shoplazza checkout preview --extension-id abc123 --version 1.0