Cloud Wizz App CLI

A CLI tool to scaffold Cloud Wizz applications with a full-stack template including frontend, backend, and database services.

Installation

Using npx (recommended)

npx cloud-wizz-app my-project-name

Global installation

npm install -g cloud-wizz-app
cloud-wizz-app my-project-name

Usage

Create a new project

cloud-wizz-app my-project-name

Or run interactively:

cloud-wizz-app

The CLI will prompt you for a project name and create a new directory with the complete application template.

Start your project

cd my-project-name
docker-compose up

Features

• 🚀 Quick project scaffolding
• 📦 Pre-configured full-stack template
• 🐳 Docker Compose setup included
• ✨ Interactive prompts with validation
• 🎨 Beautiful CLI output
• ⚠️ Overwrite protection for existing directories

Requirements

• Node.js >= 14.0.0
• Docker and Docker Compose (for running the generated project)

What it does

1. Prompts for a project name (if not provided)
2. Validates project name format
3. Checks for existing directory and prompts to overwrite if needed
4. Creates a new directory with the project name
5. Copies all boilerplate files from the template
6. Updates the package.json with your project name
7. Provides next steps for getting started

Template Structure

The generated project includes:

• Frontend application
• Backend API
• Database configuration
• Docker Compose setup
• Pre-configured environment files

Place your boilerplate files in the template/ directory. The CLI will copy everything from this directory to the new project.

Development

Test locally

cd cli-package
npm link
cloud-wizz-app test-project

Prepare template before publishing

The prepublishOnly script automatically prepares the template before publishing to npm:

npm run prepublishOnly

Publishing to npm

1. Update version in package.json
2. Login to npm: npm login
3. Publish: npm publish

License

MIT