CLI Overview

The CyberPod Apps CLI (cpod-apps) helps you create, validate, and bundle CyberPod applications.

Installation

npm install -g @cpod/cli

Or use directly with npx:

npx @cpod/cli create my-app

Commands

Command	Description
create	Scaffold a new CyberPod app
validate	Validate an app folder or bundle
bundle	Create a signed deployment bundle
keygen	Generate signing keys
doctor	Check your environment

Quick Start

1. Create a New App

cpod-apps create my-app

This creates a new app with:

• app.json - App manifest
• Dockerfile - Container config
• package.json - Dependencies with @cpod/sdk
• Next.js app structure

2. Develop Your App

cd my-app
npm install
npm run dev

3. Bundle for Deployment

cpod-apps bundle

This creates a signed .zip bundle in dist/ ready for deployment.

Workflow

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│   CREATE    │ --> │   DEVELOP   │ --> │   BUNDLE    │
│  cpod-apps  │     │  npm run    │     │  cpod-apps  │
│   create    │     │    dev      │     │   bundle    │
└─────────────┘     └─────────────┘     └─────────────┘
       │                                       │
       v                                       v
  app.json                              my-app-1.0.0.zip
  Dockerfile                            (with config.json)
  package.json
  app/