npm package: @qumra/cli
Description: Official CLI for Qumra Cloud e-commerce platform. Build, develop, and deploy themes and apps.
Author: Qumra
Latest version: 2.5.3

<div align="center">

<br />

<picture>
  <source media="(prefers-color-scheme: dark)" srcset="https://qumra.cloud/logo-white.svg">
  <source media="(prefers-color-scheme: light)" srcset="https://qumra.cloud/logo.svg">
  <img alt="Qumra Cloud" src="https://qumra.cloud/logo.svg" width="200">
</picture>

<br />
<br />

# @qumra/cli

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

[![npm version](https://img.shields.io/npm/v/@qumra/cli?color=%23764abc&label=npm)](https://www.npmjs.com/package/@qumra/cli)
[![node](https://img.shields.io/node/v/@qumra/cli?color=%23339933)](https://nodejs.org)
[![license](https://img.shields.io/npm/l/@qumra/cli?color=%232563eb)](LICENSE)

[Documentation](https://docs.qumra.cloud/docs/cli/intro) · [Qumra Cloud](https://qumra.cloud) · [Get Started](https://app.qumra.cloud)

</div>

---

## Installation

```bash
npm install -g @qumra/cli
```

## Quick Start

```bash
# 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](https://qumra.cloud) account

## Documentation

Full docs available at **[docs.qumra.cloud](https://docs.qumra.cloud/docs/cli/intro)**

## License

[MIT](LICENSE) — Made with care by [Qumra](https://qumra.cloud)