Skip to main content

Theme Init

CLI command for creating a new theme in the Qumra platform.

qumra theme init​

Create a new theme from the Qumra starter template.

Description​

This command creates a new theme from scratch using the Qumra starter template. The command will:

  1. Initialize the theme via Qumra's API
  2. Clone the theme template from GitHub
  3. Save theme settings in the configuration file

Usage​

qumra theme init

Interactive Steps​

When you run the command, it will prompt you for:

  1. Theme name: Must contain only English letters, numbers, and dashes (no spaces or special characters)
Example
qumra theme init
🧱 Enter your new theme name: my-awesome-theme

Output​

After a successful operation, it will:

  • Create a folder with the theme name in the current directory
  • Clone the starter template into the folder
  • Save theme settings in qumra.config.json
  • Display a success message with next steps

Example​

$ qumra theme init
🧱 Enter your new theme name: my-shop-theme

📡 Initializing theme with Qumra API...
📥 Cloning theme starter into "my-shop-theme"...
✅ Theme created and cloned successfully!

SUCCESS

my-shop-theme theme has been initialized successfully.

Development Environment:
Directory: my-shop-theme/
Command: qumra theme dev

Quick Start:
1. cd my-shop-theme
2. qumra theme dev

🎨 Ready to build something amazing!

Next Steps​

After creating the theme, navigate to the theme folder and start developing:

cd my-shop-theme
qumra theme dev

Troubleshooting​

Error: "A folder named 'X' already exists"​

Solution: Use a different name for the theme or delete the existing folder.

Error: "Failed to initialize theme"​

Solution:

  • Make sure you're connected to the internet
  • Verify your authentication credentials
  • Make sure Git is installed on your system