Package Installer CLI (Rust Wrapper)

A cross-platform, interactive CLI to scaffold modern web application templates with support for multiple frameworks, languages, and development tools. This Rust wrapper automatically manages Node.js dependencies and provides both local and global installation options.

🚀 Installation Options

Option 1: Local NPM Installation (Recommended)

# Using npm (recommended)
npm install @0xshariq/package-installer

# Using yarn
yarn add @0xshariq/package-installer

# Using pnpm
pnpm add @0xshariq/package-installer

Benefits:

• ✅ Always Works: No compatibility issues with dependencies
• ✅ Latest Version: Gets the most up-to-date CLI directly from npm
• ✅ Project-Scoped: Keeps CLI version consistent with your project
• ✅ Full Feature Set: Access to all CLI features without limitations

Option 2: Global Installation via Cargo

cargo install package-installer-cli

Benefits:

• ✅ Smart Detection: Automatically finds local npm installations
• ✅ Bundled Fallback: Includes bundled CLI for offline use
• ✅ Cross-Platform: Works on Windows, macOS, and Linux
• ✅ Single Command: Install once, use anywhere

🎯 How It Works

The Rust wrapper intelligently manages the TypeScript CLI:

1. 🔍 Local Priority: First checks for local npm/yarn/pnpm installations in your project
2. 📦 Bundled Fallback: Uses bundled CLI version if no local installation found
3. 🚀 Seamless Execution: Automatically runs the best available version
4. ⚡ Zero Configuration: No manual setup or dependency installation required

Prerequisites

• Node.js (v16 or higher) - Download here
• Package Manager - npm, yarn, or pnpm (npm comes with Node.js)

🚀 Quick Features

• 🎨 Multiple Frameworks: React, Next.js, Express, Angular, Vue, Rust
• 🔤 Language Support: TypeScript & JavaScript variants
• 🎭 UI Libraries: Tailwind CSS, Material-UI, shadcn/ui
• 📦 Smart Package Management: Auto-detects npm, yarn, pnpm
• ⚡ Lightning Fast: Optimized template generation with intelligent caching
• 🌈 Beautiful CLI: Gorgeous terminal interface with real-time analytics
• 🔍 Project Analysis: Advanced dependency analysis and project insights

✨ New Features

• 📊 Enhanced Analytics Dashboard: Real-time usage analytics with detailed insights
• 🎯 Smart Dependency Updates: Project-specific dependency management for JS, Python, Rust, Go, Ruby, PHP
• 🚀 Intelligent CLI Upgrades: Separate upgrade system with breaking change detection
• 💾 .package-installer-cli Folder: All cache and history stored in dedicated folder
• 📈 Usage Tracking: Comprehensive command and feature usage tracking
• ⚡ Performance Insights: Productivity scoring and usage patterns

🎯 Usage

Global Usage (after cargo install)

# Create a new project
pi create my-app

# Get help
pi --help

# List available templates  
pi list

# Analyze existing project
pi analyze

Local Usage (after npm install)

# Using npx (recommended)
npx pi create my-app

# Using direct path
./node_modules/.bin/pi create my-app

# Add to package.json scripts
{
  "scripts": {
    "scaffold": "pi create",
    "analyze": "pi analyze"
  }
}

🛠️ How to Use

With Local Installation (Recommended)

# Install locally in your project
npm install @0xshariq/package-installer

# Use with npx
npx pi create my-app

# Or add to package.json scripts
{
  "scripts": {
    "create": "pi create"
  }
}

With Global Cargo Installation

# Install globally
cargo install package-installer-cli

# Use directly (will find local installation if available)
pi create my-app

# Or use the binary name directly
package-installer-cli create my-app

Priority Order

The Rust wrapper checks for CLI in this order:

1. Local npm packages (./node_modules/@0xshariq/package-installer)
2. Parent directory npm packages (up to 5 levels)
3. Bundled standalone version (bundle/pkg-ready/index.js)
4. Bundled native executable (bundle/executables/package-installer-[platform])

📚 Documentation

🛠️ Command Overview

For complete command documentation, see commands

🏗️ Supported Project Types

For detailed template information, see templates

🎯 System Requirements

• Node.js: 18.0.0 or higher
• Operating Systems: Windows, macOS, Linux
• Package Managers: npm, yarn, or pnpm
• Git: Required for project initialization

🐛 Troubleshooting

Common Issues & Solutions

"Node.js not found" Error

# Install Node.js from https://nodejs.org
# Or use package managers:

# macOS (Homebrew)  
brew install node

# Ubuntu/Debian
sudo apt-get install nodejs npm

# Windows (Chocolatey)
choco install nodejs

# Verify installation
node --version
npm --version

"Dependencies installation failed"

# Option 1: Use local installation
npm install @0xshariq/package-installer
npx pi create my-app

# Option 2: Clear cache and retry
rm -rf ~/.cache/.package-installer-cli  # Linux/macOS
pi create my-app

# Option 3: Manual installation
cd ~/.cache/.package-installer-cli
npm install --production

"Permission denied" on Linux/macOS

# Fix npm permissions
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH

# Or use local installation
npx @0xshariq/package-installer create my-app

Cache Management

Cache locations:

• Linux: ~/.cache/.package-installer-cli/
• macOS: ~/Library/Caches/.package-installer-cli/
• Windows: %LOCALAPPDATA%\.package-installer-cli\

Clear cache:

# Linux/macOS
rm -rf ~/.cache/.package-installer-cli

# Windows (PowerShell)
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\.package-installer-cli"

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Links

• RUST Crate: package-installer-cli
• GitHub Repository: package-installer-cli
• Issues & Feedback: GitHub Issues

Happy coding! 🚀 Create something amazing with Package Installer CLI.