Skip to content

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

License

Notifications You must be signed in to change notification settings

0xshariq/devforge

Repository files navigation

πŸ“¦ DevForge

npm version License: Apache-2.0 Node.js

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 @dev-forge/devforge

# Using yarn
yarn global add @dev-forge/devforge

# Using pnpm
pnpm add -g @dev-forge/devforge

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

🐳 Docker Installation

Docker Hub Docker Image Size

Run Package Installer CLI in a containerized environment with Docker:

Quick Usage with Docker

# Pull the latest image
docker pull 0xshariq/devforge-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/devforge-cli:latest

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

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

Docker Compose Setup

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

# Run with docker-compose
docker-compose run --rm devforge

# Development mode with hot reload
docker-compose --profile dev run --rm devforge-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++
CLI commanderjs, oclif, yargs JavaScript, TypeScript
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 @dev-forge/devforge

# Use npx if global installation fails
npx @dev-forge/devforge 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

Source Repositories

Support & Community


Happy coding! πŸš€ Create something amazing with Package Installer CLI.

About

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

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published