nvmrc-wizard/Readme.md

Automatically generate and manage .nvmrc based on your framework's Node.js compatibility

# nvmrc-wizard

🚀 Automatically generate and manage `.nvmrc` based on your framework's Node.js compatibility.

Supports **Angular**, **React**, and **Vue** with comprehensive compatibility matrices.

## Features

- ✅ Auto-detects your framework and version
- ✅ Recommends the most compatible Node.js version
- ✅ Creates or updates `.nvmrc` file
- ✅ Optionally switches Node version using NVM
- ✅ Works on Windows, macOS, and Linux
- ✅ Shows NVM installation guide if needed if nvm is not installed

## Usage

```bash
# Run in your project directory
npx nvmrc-wizard
```

## What it does

1. **Detects your framework** from `package.json` (Angular/React/Vue)
2. **Finds the most compatible Node.js version** based on your framework version
3. **Creates `.nvmrc`** if it doesn't exist
4. **Prompts to update** if `.nvmrc` exists but has a different version
5. **Switches to the recommended version** (if NVM is installed and you confirm)

## Example output

```
🔍 Analyzing Node.js version compatibility...

📦 Detected: Angular v17.2.0
🎯 Most compatible Node.js version: v20.19.1
📄 No .nvmrc file found.
✅ Created .nvmrc with recommended Node.js v20.19.1
🔄 Switching to Node.js v20.19.1 as specified in .nvmrc...
✅ Successfully switched to Node.js v20.19.1
```

## Supported Frameworks

- **Angular** 13.x - 20.x
- **React** 14.x - 19.x
- **Vue** 2.6.x - 3.5.x

For native JavaScript projects, it uses the latest LTS version.

## Requirements

- Node.js >= 14
- (Optional) NVM for automatic version switching


## Use with Husky

Add to `.husky/pre-commit`:

```bash
#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

# Guid to auto-generate .nvmrc if missing
if [ ! -f .nvmrc ]; then
  echo "❌ ERROR: .nvmrc file is missing!"
  echo ""
  echo "📋 Please create .nvmrc by running:"
  echo "   npx nvmrc-wizard"
  echo ""
  exit 1
fi
```

## License

MIT