@ssit-hub/mvp-generate-template/templates/js-default-node-cli/README.md

A beautiful CLI tool to quickly generate MVP project templates with modern frameworks and best practices

# Node.js CLI Application

A command-line interface application built with Commander.js, featuring interactive prompts and colored output.

## Features

- Command-line interface with Commander.js
- Interactive prompts with Inquirer.js
- Colored console output with Chalk
- Multiple commands and options
- Error handling and validation
- System information utilities

## Getting Started

### Prerequisites

- Node.js >= 16.0.0
- npm >= 7.0.0

### Installation

1. Install dependencies:
```bash
npm install
```

2. (Optional) Link globally for system-wide access:
```bash
npm link
```

### Running the Application

#### Direct execution:
```bash
node src/index.js [command] [options]
```

#### If linked globally:
```bash
mycli [command] [options]
```

#### Development mode:
```bash
npm run dev
```

## Available Commands

### Basic Commands

#### Show help:
```bash
mycli --help
```

#### Show version:
```bash
mycli --version
```

#### Hello command:
```bash
mycli hello [name]
mycli hello John --uppercase
mycli hello World --count 3
```

#### Interactive mode:
```bash
mycli interactive
```

#### System information:
```bash
mycli info
```

### Command Options

#### Hello Command Options:
- `-u, --uppercase` - Convert name to uppercase
- `-c, --count <number>` - Number of greetings (default: 1)

## Examples

```bash
# Basic greeting
mycli hello

# Greet specific person
mycli hello John

# Uppercase greeting with multiple counts
mycli hello john --uppercase --count 5

# Interactive mode
mycli interactive

# Show system info
mycli info
```

## Project Structure

```
src/
├── index.js              # Main CLI entry point
├── commands/
│   └── hello.js          # Hello command implementation
└── utils/
    └── logger.js         # Logging utilities
```

## Environment Variables

- `DEBUG` - Enable debug logging

## Scripts

- `npm start` - Run the CLI application
- `npm run dev` - Run in development mode with auto-restart

## Development

### Adding New Commands

1. Create a new file in `src/commands/`
2. Export a function that handles the command logic
3. Import and register in `src/index.js`

Example:
```javascript
// src/commands/newcommand.js
function newCommand(args, options) {
  // Command logic here
}

module.exports = newCommand;

// src/index.js
const newCommand = require('./commands/newcommand');

program
  .command('newcmd')
  .description('Description of new command')
  .action(newCommand);
```

## License

MIT