@zaflun/lumio-cli

The official CLI for building, testing, and deploying Lumio extensions.

Installation

npm install -g @zaflun/lumio-cli

Quick Start

# Log in to Lumio
lumio login

# Create a new extension
lumio init my-widget

# Start development
cd my-widget
npm install
lumio dev

# Build and deploy
lumio build
lumio deploy -v 1.0.0

Commands

| Command | Description | |---------|-------------| | lumio login | Authenticate via browser (PKCE) or token (--token) | | lumio logout | Remove local credentials | | lumio whoami | Show current user and account | | lumio init [name] | Create a new extension project (interactive wizard) | | lumio dev | Start local dev server with hot-reload | | lumio build | Bundle extension for deployment | | lumio deploy | Upload extension version (flags: -v, -d, --breaking, --draft) | | lumio env set <KEY> <VALUE> | Set a server-side secret | | lumio env list | List secret keys | | lumio env delete <KEY> | Delete a secret | | lumio run <type:name> | Execute a server function locally | | lumio status | Show review status of latest version | | lumio logs | Stream server function logs | | lumio dashboard | Open extension dashboard in browser |

CI/CD

# Token-based login for CI
lumio login --token $LUMIO_API_TOKEN

# Deploy in CI
lumio deploy -v $VERSION -d "Automated release"

Team Support

When you have developer teams, lumio init asks who owns the extension:

? Who owns this extension?
  ❯ Personal (Solo Developer)
    Team: Zaflun GmbH

Documentation

• CLI Reference
• Publishing Guide
• Full Docs

License

MIT © zaflun