webmaker-cli

CLI agent for WebMaker Studio — sync generated files to your local machine, auto-install dependencies, and deploy to any hosting provider.

Installation

npm install -g webmaker-cli

Requires Node.js 18+.

Quick Start

# 1. Connect to your WebMaker account
webmaker login

# 2. Sync generated files in real-time
webmaker sync my-project

# 3. Deploy to a hosting provider
cd my-project
webmaker deploy

Commands

webmaker login

Connect to your WebMaker Studio server.

webmaker login
webmaker login --server http://localhost:4000

You'll be prompted for your email and password. The session is saved locally in ~/.webmaker/config.json.

webmaker sync [directory]

Watch for generated files and write them to your local machine in real-time via WebSocket.

webmaker sync                  # Sync to current directory
webmaker sync ./my-project     # Sync to specific folder
webmaker sync --no-install     # Skip automatic npm install

Features:

• Real-time file sync as WebMaker generates your project
• Auto-detects package.json and runs npm install automatically
• Auto-reconnects if the connection drops
• Shows file events with colored output

webmaker deploy

Deploy your project to a hosting provider with guided assistance.

webmaker deploy                    # Interactive provider selection
webmaker deploy --provider vercel  # Deploy directly to Vercel

Supported providers:

| Provider | Project types | How it works | |----------|--------------|--------------| | Vercel | Static, Node.js, React, Vue, Next.js | Installs Vercel CLI, deploys preview + production | | Render | Node.js, Python, Static | Guides GitHub push + dashboard setup, generates render.yaml | | Firebase | Static, Node.js | Installs Firebase CLI, configures hosting, deploys | | Netlify | Static, React, Vue, Next.js | Installs Netlify CLI, builds + deploys |

The CLI works in tandem with you:

• Automates everything it can (git init, CLI install, config files, push, deploy)
• Pauses and waits for your input when manual action is needed (create account, authorize, enter secrets)

webmaker status

Check your connection status and server health.

webmaker status

webmaker logout

Clear your saved credentials.

webmaker logout

How It Works

1. Login stores a JWT token locally
2. Sync connects via WebSocket to your WebMaker server and receives file events as the AI generates your project
3. Deploy detects your project type and walks you through deployment step by step

Requirements

• Node.js >= 18.0.0
• A WebMaker Studio account

License

MIT