acadex-cli 1.0.5 → 1.1.0

package/README.md

@@ -10,12 +10,37 @@ A global CLI tool for managing Acadex projects with easy setup and automation.
 npm install -g acadex-cli
 ```
 
+**If you get an error about existing files:**
+
+```bash
+# On macOS/Linux
+sudo rm -f /usr/local/bin/acadex /opt/homebrew/bin/acadex
+npm install -g acadex-cli
+
+# On Windows (PowerShell as Admin)
+npm install -g acadex-cli --force
+```
+
 After installation, you can use the `acadex` command from anywhere:
 
 ```bash
 acadex --help
 ```
 
+### Uninstall
+
+To completely remove ACADEX CLI:
+
+```bash
+acadex uninstall
+```
+
+Or manually:
+
+```bash
+npm uninstall -g acadex-cli
+```
+
 ### Manual Installation
 
 Clone the repository and link it globally:
@@ -34,6 +59,19 @@ Run the CLI tool using:
 acadex <command> [arguments]
 ```
 
+### Interactive Menu (New!)
+
+For a modern, interactive experience:
+
+```bash
+acadex menu
+```
+
+This will launch an interactive menu where you can:
+- Browse all available commands by category
+- Select commands by number
+- Execute commands without memorizing syntax
+
 ### Available Commands
 
 #### Setup & Installation

package/acadex

@@ -70,9 +70,11 @@ show_help() {
     echo -e "  ${GREEN}phpmyadmin:stop${NC} Stop Apache"
     echo -e "  ${GREEN}docs${NC}            Open ACADEX documentation"
     echo -e "  ${GREEN}uninstall${NC}       Uninstall ACADEX CLI globally"
+    echo -e "  ${GREEN}menu${NC}            Launch interactive menu"
     echo ""
     echo -e "${YELLOW}Examples:${NC}"
     echo -e "  acadex setup          # First-time installation"
+    echo -e "  acadex menu           # Interactive command menu"
     echo -e "  acadex services       # Start services for Herd (recommended)"
     echo -e "  acadex serve          # Start full stack (without Herd)"
     echo -e "  acadex dev            # Start development"
@@ -81,8 +83,93 @@ show_help() {
     echo ""
 }
 
+# Interactive Menu
+show_menu() {
+    while true; do
+        clear
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}            ${GREEN}ACADEX${NC} - Interactive Command Menu            ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        echo -e "${YELLOW}Setup & Installation:${NC}"
+        echo -e "  ${GREEN}1)${NC}  setup           - First-time full installation"
+        echo -e "  ${GREEN}2)${NC}  install:2fa     - Install 2FA packages"
+        echo -e "  ${GREEN}3)${NC}  install:notif   - Install notification packages"
+        echo -e "  ${GREEN}4)${NC}  check           - Check system requirements"
+        echo ""
+        echo -e "${YELLOW}Development:${NC}"
+        echo -e "  ${GREEN}5)${NC}  serve           - Start production servers"
+        echo -e "  ${GREEN}6)${NC}  services        - Start background services (Herd)"
+        echo -e "  ${GREEN}7)${NC}  dev             - Start development servers"
+        echo -e "  ${GREEN}8)${NC}  build           - Build assets for production"
+        echo -e "  ${GREEN}9)${NC}  ui              - Rebuild UI and clear caches"
+        echo -e "  ${GREEN}10)${NC} start           - Start Laravel server only"
+        echo ""
+        echo -e "${YELLOW}Testing:${NC}"
+        echo -e "  ${GREEN}11)${NC} test            - Run PHPUnit tests"
+        echo -e "  ${GREEN}12)${NC} test:coverage   - Run tests with coverage"
+        echo ""
+        echo -e "${YELLOW}Database:${NC}"
+        echo -e "  ${GREEN}13)${NC} migrate         - Run database migrations"
+        echo -e "  ${GREEN}14)${NC} migrate:fresh   - Fresh migration with seeders"
+        echo -e "  ${GREEN}15)${NC} seed            - Run database seeders"
+        echo -e "  ${GREEN}16)${NC} tinker          - Start Laravel Tinker"
+        echo ""
+        echo -e "${YELLOW}Maintenance:${NC}"
+        echo -e "  ${GREEN}17)${NC} cache:clear     - Clear all caches"
+        echo -e "  ${GREEN}18)${NC} optimize        - Optimize the application"
+        echo -e "  ${GREEN}19)${NC} logs            - Tail Laravel logs"
+        echo ""
+        echo -e "${YELLOW}Code Quality:${NC}"
+        echo -e "  ${GREEN}20)${NC} analyze         - Run PHPStan static analysis"
+        echo -e "  ${GREEN}21)${NC} format          - Format code with Pint"
+        echo ""
+        echo -e "${YELLOW}Other:${NC}"
+        echo -e "  ${GREEN}22)${NC} routes          - List all routes"
+        echo -e "  ${GREEN}23)${NC} queue           - Start queue worker"
+        echo -e "  ${GREEN}24)${NC} docs            - Open ACADEX documentation"
+        echo ""
+        echo -e "  ${RED}0)${NC}  Exit"
+        echo ""
+        echo -e -n "${YELLOW}Select an option [0-24]:${NC} "
+        read choice
+        
+        case $choice in
+            1) "$0" setup ;;
+            2) "$0" install:2fa ;;
+            3) "$0" install:notif ;;
+            4) "$0" check; read -p "Press Enter to continue..." ;;
+            5) "$0" serve ;;
+            6) "$0" services ;;
+            7) "$0" dev ;;
+            8) "$0" build; read -p "Press Enter to continue..." ;;
+            9) "$0" ui; read -p "Press Enter to continue..." ;;
+            10) "$0" start ;;
+            11) "$0" test; read -p "Press Enter to continue..." ;;
+            12) "$0" test:coverage; read -p "Press Enter to continue..." ;;
+            13) "$0" migrate; read -p "Press Enter to continue..." ;;
+            14) "$0" migrate:fresh; read -p "Press Enter to continue..." ;;
+            15) "$0" seed; read -p "Press Enter to continue..." ;;
+            16) "$0" tinker ;;
+            17) "$0" cache:clear; read -p "Press Enter to continue..." ;;
+            18) "$0" optimize; read -p "Press Enter to continue..." ;;
+            19) "$0" logs ;;
+            20) "$0" analyze; read -p "Press Enter to continue..." ;;
+            21) "$0" format; read -p "Press Enter to continue..." ;;
+            22) "$0" routes; read -p "Press Enter to continue..." ;;
+            23) "$0" queue ;;
+            24) "$0" docs; read -p "Press Enter to continue..." ;;
+            0) echo -e "${GREEN}Goodbye!${NC}"; exit 0 ;;
+            *) echo -e "${RED}Invalid option. Please try again.${NC}"; sleep 2 ;;
+        esac
+    done
+}
+
 # Command handlers
 case "$1" in
+    menu)
+        show_menu
+        ;;
     setup)
         echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
         echo -e "${BLUE}║${NC}            ${GREEN}ACADEX${NC} - First Time Installation              ${BLUE}║${NC}"

package/acadex.ps1

@@ -102,9 +102,12 @@ function Show-Help {
     Write-Host "Open ACADEX documentation"
     Write-Host "  uninstall       " -ForegroundColor Green -NoNewline
     Write-Host "Uninstall ACADEX CLI globally"
+    Write-Host "  menu            " -ForegroundColor Green -NoNewline
+    Write-Host "Launch interactive menu"
     Write-Host ""
     Write-Host "Examples:" -ForegroundColor Yellow
     Write-Host "  acadex setup          # First-time installation"
+    Write-Host "  acadex menu           # Interactive command menu"
     Write-Host "  acadex services       # Start services for Herd/Laragon (recommended)"
     Write-Host "  acadex serve          # Start full stack (without Herd/Laragon)"
     Write-Host "  acadex dev            # Start development"
@@ -113,6 +116,87 @@ function Show-Help {
     Write-Host ""
 }
 
+# Interactive Menu
+function Show-Menu {
+    while ($true) {
+        Clear-Host
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "            ACADEX - Interactive Command Menu              " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        Write-Host "Setup & Installation:" -ForegroundColor Yellow
+        Write-Host "  1)  setup           - First-time full installation" -ForegroundColor Green
+        Write-Host "  2)  install:2fa     - Install 2FA packages" -ForegroundColor Green
+        Write-Host "  3)  install:notif   - Install notification packages" -ForegroundColor Green
+        Write-Host "  4)  check           - Check system requirements" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "Development:" -ForegroundColor Yellow
+        Write-Host "  5)  serve           - Start production servers" -ForegroundColor Green
+        Write-Host "  6)  services        - Start background services (Herd)" -ForegroundColor Green
+        Write-Host "  7)  dev             - Start development servers" -ForegroundColor Green
+        Write-Host "  8)  build           - Build assets for production" -ForegroundColor Green
+        Write-Host "  9)  ui              - Rebuild UI and clear caches" -ForegroundColor Green
+        Write-Host "  10) start           - Start Laravel server only" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "Testing:" -ForegroundColor Yellow
+        Write-Host "  11) test            - Run PHPUnit tests" -ForegroundColor Green
+        Write-Host "  12) test:coverage   - Run tests with coverage" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "Database:" -ForegroundColor Yellow
+        Write-Host "  13) migrate         - Run database migrations" -ForegroundColor Green
+        Write-Host "  14) migrate:fresh   - Fresh migration with seeders" -ForegroundColor Green
+        Write-Host "  15) seed            - Run database seeders" -ForegroundColor Green
+        Write-Host "  16) tinker          - Start Laravel Tinker" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "Maintenance:" -ForegroundColor Yellow
+        Write-Host "  17) cache:clear     - Clear all caches" -ForegroundColor Green
+        Write-Host "  18) optimize        - Optimize the application" -ForegroundColor Green
+        Write-Host "  19) logs            - Tail Laravel logs" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "Code Quality:" -ForegroundColor Yellow
+        Write-Host "  20) analyze         - Run PHPStan static analysis" -ForegroundColor Green
+        Write-Host "  21) format          - Format code with Pint" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "Other:" -ForegroundColor Yellow
+        Write-Host "  22) routes          - List all routes" -ForegroundColor Green
+        Write-Host "  23) queue           - Start queue worker" -ForegroundColor Green
+        Write-Host "  24) docs            - Open ACADEX documentation" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "  0)  Exit" -ForegroundColor Red
+        Write-Host ""
+        $choice = Read-Host "Select an option [0-24]"
+        
+        switch ($choice) {
+            "1" { & $MyInvocation.MyCommand.Path setup }
+            "2" { & $MyInvocation.MyCommand.Path install:2fa }
+            "3" { & $MyInvocation.MyCommand.Path install:notif }
+            "4" { & $MyInvocation.MyCommand.Path check; Read-Host "Press Enter to continue" }
+            "5" { & $MyInvocation.MyCommand.Path serve }
+            "6" { & $MyInvocation.MyCommand.Path services }
+            "7" { & $MyInvocation.MyCommand.Path dev }
+            "8" { & $MyInvocation.MyCommand.Path build; Read-Host "Press Enter to continue" }
+            "9" { & $MyInvocation.MyCommand.Path ui; Read-Host "Press Enter to continue" }
+            "10" { & $MyInvocation.MyCommand.Path start }
+            "11" { & $MyInvocation.MyCommand.Path test; Read-Host "Press Enter to continue" }
+            "12" { & $MyInvocation.MyCommand.Path test:coverage; Read-Host "Press Enter to continue" }
+            "13" { & $MyInvocation.MyCommand.Path migrate; Read-Host "Press Enter to continue" }
+            "14" { & $MyInvocation.MyCommand.Path migrate:fresh; Read-Host "Press Enter to continue" }
+            "15" { & $MyInvocation.MyCommand.Path seed; Read-Host "Press Enter to continue" }
+            "16" { & $MyInvocation.MyCommand.Path tinker }
+            "17" { & $MyInvocation.MyCommand.Path cache:clear; Read-Host "Press Enter to continue" }
+            "18" { & $MyInvocation.MyCommand.Path optimize; Read-Host "Press Enter to continue" }
+            "19" { & $MyInvocation.MyCommand.Path logs }
+            "20" { & $MyInvocation.MyCommand.Path analyze; Read-Host "Press Enter to continue" }
+            "21" { & $MyInvocation.MyCommand.Path format; Read-Host "Press Enter to continue" }
+            "22" { & $MyInvocation.MyCommand.Path routes; Read-Host "Press Enter to continue" }
+            "23" { & $MyInvocation.MyCommand.Path queue }
+            "24" { & $MyInvocation.MyCommand.Path docs; Read-Host "Press Enter to continue" }
+            "0" { Write-Host "Goodbye!" -ForegroundColor Green; exit 0 }
+            default { Write-Host "Invalid option. Please try again." -ForegroundColor Red; Start-Sleep -Seconds 2 }
+        }
+    }
+}
+
 # Check if a command exists
 function Test-CommandExists {
     param([string]$Cmd)
@@ -121,6 +205,10 @@ function Test-CommandExists {
 
 # Command handlers
 switch ($Command) {
+    "menu" {
+        Show-Menu
+    }
+    
     "setup" {
         Write-Host "===========================================================" -ForegroundColor Cyan
         Write-Host "            ACADEX - First Time Installation              " -ForegroundColor Green

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acadex-cli",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "A global CLI tool for managing Acadex projects with easy setup and automation",
   "main": "bin/acadex.js",
   "bin": {