📦 Package Installer CLI

A powerful, cross-platform CLI for modern development workflows. Create projects, manage dependencies, analyze codebases, and streamline your development process with intelligent automation.

🚀 Core Features

• 🎨 Project Creation: React, Next.js, Express, Angular, Vue, Rust templates
• 🚀 Cloud Deployment: Seamless deployment to Vercel, AWS, GitHub Pages
• 📊 Code Analysis: Comprehensive project analytics and insights
• 📦 Dependency Management: Smart updates across multiple package managers
• 🩺 Health Diagnostics: Automated issue detection and fixes
• 🌍 Environment Analysis: Development environment optimization
• 🗄️ Intelligent Caching: Performance optimization with smart caching
• 📈 Usage Analytics: Real-time insights and productivity metrics
• ⚡ Cross-Platform: Windows, macOS, Linux support

📥 Installation

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

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

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

📋 Complete Installation Guide: For all installation methods including Python, Rust, Ruby, Go, Homebrew, and Docker, see installation.md

🐳 Docker Installation

Run Package Installer CLI in a containerized environment with Docker:

Quick Usage with Docker

# Pull the latest image
docker pull 0xshariq/package-installer-cli:latest

# Run interactively with current directory mounted
docker run -it --rm \
  -v "$(pwd)":/home/pi/projects \
  -v ~/.gitconfig:/home/pi/.gitconfig:ro \
  -v ~/.ssh:/home/pi/.ssh:ro \
  0xshariq/package-installer-cli:latest

# Create a new project
docker run -it --rm \
  -v "$(pwd)":/home/pi/projects \
  0xshariq/package-installer-cli:latest create my-app

# Analyze existing project
docker run -it --rm \
  -v "$(pwd)":/home/pi/projects \
  0xshariq/package-installer-cli:latest analyze

Docker Compose Setup

# Clone the repository
git clone https://github.com/0xshariq/package-installer-cli.git
cd package-installer-cli

# Run with docker-compose
docker-compose run --rm package-installer

# Development mode with hot reload
docker-compose --profile dev run --rm package-installer-dev

Docker Image Variants

| Tag | Description | Use Case | |-----|-------------|----------| | latest | Latest stable release | Production usage | | dev | Development version | Testing new features | | v3.17.5 | Specific version | Version pinning |

Volume Mounts

• Projects: Mount your project directory to /home/pi/projects
• Git Config: Mount ~/.gitconfig for Git authentication
• SSH Keys: Mount ~/.ssh for Git repository access

🎯 Quick Start

# Create new project interactively
pi create my-app

# Deploy to cloud platforms
pi deploy

# Analyze existing project
pi analyze

# Check project health
pi doctor

# Update dependencies
pi update

# Clean development artifacts
pi clean

📚 Documentation

| Document | Description | |----------|-------------| | � Installation | Complete installation guide for all package managers | | 🐳 Docker | Docker Usage and installation | | 📦 Bundle Info | Distribution bundle system and cross-platform packaging | | 📋 Commands | Complete command reference with examples | | ⚡ Features | Detailed feature documentation and usage | | 🎨 Templates | Available templates and customization options | | 🚀 Deployment | Deployment options and platform integration |

🛠️ Command Overview

| Command | Description | Key Options | |---------|-------------|-------------| | pi create | Create new projects from templates | Interactive framework selection | | pi analyze | Project analytics and insights | --detailed, --export | | pi update | Update project dependencies | --latest for breaking changes | | pi doctor | Diagnose and fix issues | --fix, --node, --deps, --tools | | pi env | Environment analysis | --check, --generate, --validate | | pi clone | Clone and setup repositories | --offline, --shallow, --branch | | pi add | Add features to projects | --list to see all features | | pi clean | Clean development artifacts | --all, --dry-run | | pi cache | Manage CLI cache | clear, stats, optimize | | pi check | Check package versions | --verbose for details | | pi upgrade-cli | Upgrade CLI version | Breaking change detection | | pi size | Show sizes for files and folders (accepts multiple paths; use . for current directory) | Shows per-path sizes, combined total, and top-N largest files | | pi email | Send feedback and messages | Direct communication with developer |

For complete documentation, see docs/commands.md

🏗️ Supported Technologies

| Category | Representative Frameworks / Tools | Primary Languages | |----------|------------------------------------|-------------------| | C++/C | cppcms, crow, restbed, ulfius, wt | C, C++ | | Combination Templates | react+express, react+nestjs (fullstack combos) | TS | | Desktop | electron, tauri, flutter, qt, nwjs, capacitor | JS, TS, Rust, Dart, Python | | Game | bevy, godot, unity, unreal, threejs, pygame, babylonjs | Rust, C#, C++, JS, Python | | Go | gin, echo, beego, buffalo, chi, gqlgen | Go | | Javascript | react, next, vue, angular, express, nestjs, svelte, remix | JavaScript, TypeScript | | Mobile | react-native, flutter, ionic, nativescript, swiftui | JavaScript, TypeScript, Dart, Swift | | Python | django, flask, fastapi, flask, tornado, streamlit | Python | | Ruby | rails, sinatra, hanami, roda | Ruby | | Rust | axum, rocket, warp, tide, poem, gotham | Rust | | Web3 | hardhat, truffle, anchor, foundry, ethers.js, brownie | Solidity, Rust, Python, JS |

For detailed information and per-template lists, see docs/templates.md

For detailed information, see docs/templates.md

🎯 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

Quick Fixes

# Clear cache and reinstall
npm cache clean --force
npm install -g @0xshariq/package-installer

# Use npx if global installation fails
npx @0xshariq/package-installer create my-app

# Check CLI status
pi doctor

🤝 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

Official Packages

• NPM: @0xshariq/package-installer
• PyPI: package-installer-cli
• Crates.io: package-installer-cli
• RubyGems: package-installer-cli
• Docker Hub: 0xshariq/package-installer-cli

Source Repositories

• Main (Node.js): package-installer-cli
• Python: py_package_installer_cli
• Rust: rust_package_installer_cli
• Ruby: ruby_package_installer_cli
• Go: go_package_installer_cli

Support & Community

• Issues & Feedback: GitHub Issues
• Discussions: GitHub Discussions

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