auto-dev-setup 0.1.0 → 0.1.1

package/README.md

@@ -2,14 +2,35 @@
 
 A cross-platform command-line tool that automates developer environment setup on Windows, macOS, and Linux.
 
+```
+╭─────────────────────────────────────────────────────╮
+│                                                     │
+│   auto-dev-setup                                    │
+│   Cross-platform Developer Environment Setup Tool   │
+│                                                     │
+╰─────────────────────────────────────────────────────╯
+```
+
 ## Features
 
 - **Cross-Platform**: Works consistently on Windows, macOS, and Linux
 - **Interactive Setup**: Guided installation with clear prompts
-- **Idempotent**: Safe to run multiple times
+- **Idempotent**: Safe to run multiple times - skips already installed tools
 - **Transparent**: Shows all commands before execution
 - **Modular**: Install only what you need
 
+## Quick Start
+
+```bash
+# Install globally
+npm install -g auto-dev-setup
+
+# Run the setup wizard
+auto-setup
+```
+
+That's it! The tool will guide you through the rest.
+
 ## What Gets Installed
 
 ### Always Installed (Base + Web Stack)
@@ -21,55 +42,31 @@ A cross-platform command-line tool that automates developer environment setup on
   - Prettier
   - GitLens
 
-### Optional (Interactive Prompts)
+### Optional (You Choose)
 - **Python Stack**: Python 3, pip, pipx, virtualenv, Jupyter, NumPy, Pandas
 - **Java Stack**: OpenJDK (LTS), JAVA_HOME configuration
 
 ## Installation
 
-### npm (Recommended)
-
-```bash
-npm install -g auto-dev-setup
-```
-
-### pip
-
-```bash
-pip install auto-dev-setup
-```
-
-### Homebrew (macOS)
+### Prerequisites
 
-```bash
-brew tap yourusername/auto-dev-setup
-brew install auto-dev-setup
-```
+You need Node.js (v16+) installed. If you don't have it:
 
-### Development / Local Installation
+| Platform | Install Node.js |
+|----------|-----------------|
+| **Windows** | Download from [nodejs.org](https://nodejs.org) or run `winget install OpenJS.NodeJS.LTS` |
+| **macOS** | Run `brew install node` or download from [nodejs.org](https://nodejs.org) |
+| **Linux** | Use your package manager: `apt install nodejs npm` or `dnf install nodejs npm` |
 
-If you're installing from a cloned repository (for development or testing):
+### Install auto-dev-setup
 
 ```bash
-# Clone the repository
-git clone https://github.com/yourusername/auto-dev-setup.git
-cd auto-dev-setup
-
-# Install dependencies first (required!)
-npm install
-
-# Then link globally
-npm link
-
-# Now you can use the command
-auto-setup --version
+npm install -g auto-dev-setup
 ```
 
-**Note:** When installing from npm registry (`npm install -g auto-dev-setup`), dependencies are installed automatically. The extra `npm install` step is only needed for local development.
-
 ## Usage
 
-### Run the Setup Wizard
+### Interactive Mode (Recommended)
 
 ```bash
 auto-setup
@@ -77,23 +74,29 @@ auto-setup
 
 This will:
 1. Detect your platform (Windows/macOS/Linux)
-2. Install base system tools
-3. Install the web developer stack
-4. Prompt for Python stack installation
-5. Prompt for Java stack installation
-6. Display a summary of all changes
+2. Install base system tools (Git, curl)
+3. Install the web developer stack (Node.js, npm, VS Code)
+4. Ask if you want Python stack
+5. Ask if you want Java stack
+6. Configure all PATH variables
+7. Display a summary
 
-### Command Options
+### Non-Interactive Mode
 
 ```bash
-# Run with all stacks (no prompts)
+# Install everything without prompts
 auto-setup --yes
 
 # Skip specific stacks
 auto-setup --skip-python
 auto-setup --skip-java
+auto-setup --yes --skip-java
+```
+
+### Other Commands
 
-# Check installed tools
+```bash
+# Check what's already installed
 auto-setup check
 
 # Display system info
@@ -106,54 +109,93 @@ auto-setup --version
 auto-setup --help
 ```
 
+## Example Output
+
+```
+Step 1: Platform Detection
+
+╭──────────────────────────────────────────────────────╮
+│   System Information                                 │
+│                                                      │
+│   💻 OS: Windows (win32)                             │
+│   🔧 Architecture: x86_64 (64-bit)                   │
+│   📁 Shell: powershell                               │
+│   📦 Package Manager: winget                         │
+╰──────────────────────────────────────────────────────╯
+
+Step 2: Base System Setup
+
+✓ Using package manager: winget
+✓ Git already installed
+✓ curl already available
+
+Step 3: Web Developer Stack (Mandatory)
+
+✓ Node.js LTS already installed
+✓ Visual Studio Code already installed
+→ Installing VS Code extensions...
+  • ESLint - installed
+  • Prettier - already installed
+  • GitLens - already installed
+
+...
+
+╭──────────────────────────────────────╮
+│   Installation Summary               │
+│                                      │
+│   Installed (6):                     │
+│     ✔ VS Code: ESLint                │
+│     ✔ pipx                           │
+│     ✔ virtualenv                     │
+│     ✔ NumPy                          │
+│     ✔ Pandas                         │
+│     ✔ JAVA_HOME configuration        │
+│                                      │
+│   Skipped (15):                      │
+│     → Already installed items...     │
+│                                      │
+│   Failed (0):                        │
+│     None                             │
+╰──────────────────────────────────────╯
+
+🚀 Setup Complete!
+```
+
 ## Platform-Specific Behavior
 
+### Windows
+- Uses **winget** (preferred) or **Chocolatey**
+- May require Administrator privileges for some installations
+- Automatically configures PATH for Python Scripts
+
 ### macOS
-- Installs Xcode Command Line Tools
-- Uses Homebrew for package management
-- Supports both Intel and Apple Silicon
+- Installs **Xcode Command Line Tools** if needed
+- Uses **Homebrew** for package management
+- Supports both Intel and Apple Silicon Macs
 
 ### Linux
-- Detects distribution (Debian/Ubuntu, Fedora/RHEL, Arch, etc.)
-- Uses native package manager (apt, dnf, pacman, etc.)
+- Auto-detects your distribution
+- Uses native package manager (apt, dnf, pacman, zypper, apk)
 - Sets up NodeSource repository for latest Node.js LTS
 
-### Windows
-- Requires PowerShell
-- Uses winget (preferred) or Chocolatey
-- May require Administrator privileges for some installations
+## After Installation
 
-## Project Structure
+**Important**: Restart your terminal after installation for PATH changes to take effect.
 
-```
-auto-dev-setup/
-├── bin/
-│   └── auto-setup.js          # CLI entry point
-├── src/
-│   ├── cli.js                 # Main CLI logic
-│   ├── index.js               # Module exports
-│   ├── platform/
-│   │   ├── detector.js        # OS/arch/shell detection
-│   │   ├── macos.js           # macOS installers
-│   │   ├── linux.js           # Linux installers
-│   │   └── windows.js         # Windows installers
-│   ├── stacks/
-│   │   ├── base.js            # Base tools installer
-│   │   ├── web.js             # Web stack installer
-│   │   ├── python.js          # Python stack installer
-│   │   └── java.js            # Java stack installer
-│   ├── utils/
-│   │   ├── executor.js        # Command execution
-│   │   ├── logger.js          # Console output
-│   │   ├── prompts.js         # User prompts
-│   │   └── verifier.js        # Installation verification
-│   └── config/
-│       └── extensions.js      # VS Code extensions config
-├── python/                    # pip distribution
-├── homebrew/                  # Homebrew formula
-├── package.json
-├── pyproject.toml
-└── README.md
+| Platform | How to Apply Changes |
+|----------|---------------------|
+| **Windows** | Close PowerShell/Terminal and open a new one |
+| **macOS** | Run `source ~/.zshrc` or restart Terminal |
+| **Linux** | Run `source ~/.bashrc` (or `~/.zshrc`) or restart terminal |
+
+Then verify everything works:
+
+```bash
+node --version
+npm --version
+python --version
+java --version
+jupyter --version
 ```
 
 ## Safety
@@ -166,26 +208,13 @@ auto-dev-setup/
 
 ## Requirements
 
-- **Node.js** >= 16.0.0 (for npm installation)
-- **Python** >= 3.8 (for pip installation)
+- **Node.js** >= 16.0.0
 - Internet connection for downloading packages
 
-## Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-1. Fork the repository
-2. Create your feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add some amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
-
 ## License
 
-MIT License - see [LICENSE](LICENSE) for details.
+MIT License
 
-## Acknowledgments
+## Author
 
-- Built with [Commander.js](https://github.com/tj/commander.js)
-- Uses [Inquirer.js](https://github.com/SBoudrias/Inquirer.js) for prompts
-- Styled with [Chalk](https://github.com/chalk/chalk)
+Built with Node.js using Commander.js, Inquirer.js, and Chalk.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auto-dev-setup",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Cross-platform CLI tool to automate developer environment setup on Windows, macOS, and Linux",
   "main": "src/index.js",
   "bin": {