Generate a ZIP archive from a theme folder, with optional metadata override and repository push. If a .wpcignore file is present in the theme folder, it will be used to exclude files from the archive. See documentation for details.

​
Usage

wpc theme:build [options] [--] [<input>]

​
Arguments

​
input
string
Input directory containing theme sources (default: current working directory).

​
Options

​
--slug, -s
string
Theme slug. If omitted, the working directory name will be used.
​
--output-dir, -o
string
default:"../dist"
Output directory for the ZIP archive.
​
--filename, -f
string
Name of the output ZIP file.
​
--header
string[]
Override one or more theme headers (e.g. --header="Version=1.2.3"). Only existing headers in the theme file will be replaced, new ones will be ignored. Original file will be unchanged.
​
--push, -p
boolean
Push the archive to the configured repository. See push documentation.
​
--message, -m
string
Release notes used during push (ignored without push option).
​
--clean
boolean
Delete the ZIP file after it has been uploaded (ignored without push option).

​
Examples

# Build a zip from current working directory
$ wpc theme:build

# Build a zip by providing all directories and files name
$ wpc theme:build --slug=my-theme --output-dir=build --filename=my-theme.zip my-theme

# Build and push a zip with a specific version and with release notes
$ wpc theme:build --header="Version=1.2.3" --push --m "Add new block"