Skip to main content

Theme Bundle

Want to create a bundle (archive) of your local theme so you can upload it to Qumra Cloud or share it with someone or another environment? This command prepares a compressed theme bundle file ready for you.

qumra theme bundle​

This command collects your theme files, runs the build step, and generates a zipped bundle ready for upload. It does not upload it to the cloud—just prepares it locally on your machine.

Description​

qumra theme bundle does the following:

  1. Checks that your qumra.config.json has all required fields, especially themeName.
  2. Runs your configured build script.
  3. Gathers all required theme files and metadata.
  4. Compresses everything into a .zip file and shows you the path.

Useful if you want to upload the theme manually from the Qumra dashboard, or you’re working with another build or CI pipeline.

Example Usage​

# Create a theme bundle locally in one step
qumra theme bundle

Example Error Message​

PS \theme> qumralocal theme bundle

❌ themeName is missing from your Qumra config file

This means you haven't set themeName inside your .qumra/qumra.config.json or it's missing. Add it like this:

{
  "themeName": "your-theme-name",
  ...
}

Expected Output if Successful​

Theme Root: ./theme
Output File: ./theme/themeName-theme.zip
✅ Bundle created successfully: themeName-theme.zip
📏 Size: 4.10 MB

Next Steps​

  • Upload your bundle file from the Qumra dashboard depending on your target environment.
  • If you make frequent changes, use qumra theme dev for testing, then bundle when you're ready.
  • You can use the bundle file as an artifact in any pipeline for deployment or further automation.

Troubleshooting​

Problem: "❌ themeName is missing from your Qumra config file"​

If you see this message:

/theme> qumralocal theme bundle

❌ themeName is missing from your Qumra config file

It means you need to add themeName to your .qumra/qumra.config.json file. Open the file and make sure it includes a line like:

{
  "themeName": "your-theme-name",
  ...
}

Without this line, you won't be able to bundle your theme.