@qumra/cli

Build, develop, and deploy themes & apps for your Qumra Cloud store.

Documentation · Qumra Cloud · Get Started

Installation

npm install -g @qumra/cli

Quick Start

# 1. Login to your account
qumra login

# 2. Initialize a theme
qumra theme init

# 3. Start developing with hot reload
qumra theme dev

# 4. Publish when ready
qumra theme publish

Commands

Authentication

qumra login          Login to your Qumra Cloud account
qumra logout         Logout from your account
qumra info           Show current user info

Themes

qumra theme init     Initialize a new theme project
qumra theme dev      Start dev server with hot reload
qumra theme publish  Publish theme to Qumra Cloud
qumra theme bundle   Bundle theme for distribution
qumra theme patch    Bump patch version and publish
qumra theme minor    Bump minor version and publish
qumra theme major    Bump major version and publish

Apps

qumra app init       Initialize a new app project
qumra app dev        Start dev server with HTTPS tunnel
qumra app deploy     Deploy app to Qumra Cloud

Generators

qumra generate widget    Scaffold a new widget

Theme Development

qumra theme dev spins up a full local development environment:

┌─────────────────────────────────────────────┐
│  Qumra Dev Server                           │
├─────────────────────────────────────────────┤
│                                             │
│  Local:    http://localhost:3000             │
│  Store:    https://mystore.qumra.cloud      │
│  Editor:   https://app.qumra.cloud/...      │
│                                             │
│  ● Proxy server      — local asset serving  │
│  ● Hot reload        — instant CSS updates  │
│  ● File watcher      — auto cloud sync      │
│                                             │
├─────────────────────────────────────────────┤
│  q quit  ·  o open browser  ·  e editor     │
└─────────────────────────────────────────────┘

Theme Structure

my-theme/
├── assets/        Static files (images, fonts, scripts)
├── layouts/       Base layout templates (.njk)
├── templates/     Page templates (.njk)
├── ui/            UI components (.njk, .css)
├── widgets/       Widget schemas & templates
├── pages/         Page definitions (.json)
├── locales/       Translation files (.json)
└── settings/      Theme configuration
    ├── settings-schema.json
    ├── settings-data.json
    ├── header-schema.json
    ├── header-data.json
    ├── footer-schema.json
    ├── footer-data.json
    └── templates-settings.json

Requirements

• Node.js >= 18
• A Qumra Cloud account

Documentation

Full docs available at docs.qumra.cloud

License

MIT — Made with care by Qumra