acadex-cli 1.1.0 → 1.2.0

package/README.md

@@ -53,25 +53,24 @@ npm link
 
 ## Usage
 
-Run the CLI tool using:
+### Interactive Menu (New in v1.1!)
+
+Launch the interactive menu with arrow key navigation:
 
 ```bash
-acadex <command> [arguments]
+acadex menu
 ```
 
-### Interactive Menu (New!)
+Navigate through categories using arrow keys and select commands easily!
 
-For a modern, interactive experience:
+### Command Line
+
+Run the CLI tool using:
 
 ```bash
-acadex menu
+acadex <command> [arguments]
 ```
 
-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,11 +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 -e "  ${GREEN}menu${NC}            Interactive menu (modern UI)"
     echo ""
     echo -e "${YELLOW}Examples:${NC}"
+    echo -e "  acadex menu           # Launch interactive menu"
     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"
@@ -83,84 +83,271 @@ show_help() {
     echo ""
 }
 
-# Interactive Menu
+# 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}      ${GREEN}ACADEX${NC} - Interactive Menu ${YELLOW}(Select Category)${NC}    ${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
+        echo -e "${YELLOW}Main Menu:${NC}"
+        echo ""
+        echo -e "  ${GREEN}1)${NC} 📦 Setup & Installation"
+        echo -e "  ${GREEN}2)${NC} 🚀 Development"
+        echo -e "  ${GREEN}3)${NC} 🧪 Testing"
+        echo -e "  ${GREEN}4)${NC} 💾 Database"
+        echo -e "  ${GREEN}5)${NC} 🔧 Maintenance"
+        echo -e "  ${GREEN}6)${NC} 📊 Code Quality"
+        echo -e "  ${GREEN}7)${NC} 📦 Dependencies"
+        echo -e "  ${GREEN}8)${NC} 🛠️  Other Tools"
+        echo ""
+        echo -e "  ${RED}0)${NC} ❌ Exit"
+        echo ""
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        read -p "$(echo -e ${YELLOW}Select category [0-8]:${NC} )" category
+        
+        case $category in
+            1) show_setup_menu ;;
+            2) show_development_menu ;;
+            3) show_testing_menu ;;
+            4) show_database_menu ;;
+            5) show_maintenance_menu ;;
+            6) show_code_quality_menu ;;
+            7) show_dependencies_menu ;;
+            8) show_other_menu ;;
+            0) echo -e "\n${GREEN}Goodbye!${NC}"; exit 0 ;;
+            *) echo -e "${RED}Invalid option!${NC}"; sleep 1 ;;
+        esac
+    done
+}
+
+# Setup & Installation submenu
+show_setup_menu() {
+    while true; do
+        clear
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}          ${GREEN}📦 Setup & Installation${NC}                    ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        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}0)${NC} ← Back to Main Menu"
+        echo ""
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        read -p "$(echo -e ${YELLOW}Select option [0-4]:${NC} )" choice
+        
+        case $choice in
+            1) echo ""; "$0" setup; read -p "Press Enter to continue..." ;;
+            2) echo ""; "$0" install:2fa; read -p "Press Enter to continue..." ;;
+            3) echo ""; "$0" install:notif; read -p "Press Enter to continue..." ;;
+            4) echo ""; "$0" check; read -p "Press Enter to continue..." ;;
+            0) return ;;
+            *) echo -e "${RED}Invalid option!${NC}"; sleep 1 ;;
+        esac
+    done
+}
+
+# Development submenu
+show_development_menu() {
+    while true; do
+        clear
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}              ${GREEN}🚀 Development${NC}                           ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        echo -e "  ${GREEN}1)${NC} serve    - Start production servers (Laravel + Queue + Scheduler + Reverb)"
+        echo -e "  ${GREEN}2)${NC} services - Start background services only (for Herd)"
+        echo -e "  ${GREEN}3)${NC} dev      - Start dev servers (Laravel + Queue + Logs + Vite + Reverb)"
+        echo -e "  ${GREEN}4)${NC} build    - Build assets for production"
+        echo -e "  ${GREEN}5)${NC} ui       - Rebuild UI assets and clear caches"
+        echo -e "  ${GREEN}6)${NC} start    - Start Laravel server only"
+        echo ""
+        echo -e "  ${YELLOW}0)${NC} ← Back to Main Menu"
+        echo ""
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        read -p "$(echo -e ${YELLOW}Select option [0-6]:${NC} )" choice
+        
+        case $choice in
+            1) echo ""; "$0" serve ;;
+            2) echo ""; "$0" services ;;
+            3) echo ""; "$0" dev ;;
+            4) echo ""; "$0" build; read -p "Press Enter to continue..." ;;
+            5) echo ""; "$0" ui; read -p "Press Enter to continue..." ;;
+            6) echo ""; "$0" start ;;
+            0) return ;;
+            *) echo -e "${RED}Invalid option!${NC}"; sleep 1 ;;
+        esac
+    done
+}
+
+# Testing submenu
+show_testing_menu() {
+    while true; do
+        clear
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}                ${GREEN}🧪 Testing${NC}                              ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        echo -e "  ${GREEN}1)${NC} test          - Run PHPUnit tests"
+        echo -e "  ${GREEN}2)${NC} test:coverage - Run tests with coverage"
+        echo ""
+        echo -e "  ${YELLOW}0)${NC} ← Back to Main Menu"
+        echo ""
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        read -p "$(echo -e ${YELLOW}Select option [0-2]:${NC} )" choice
+        
+        case $choice in
+            1) echo ""; "$0" test; read -p "Press Enter to continue..." ;;
+            2) echo ""; "$0" test:coverage; read -p "Press Enter to continue..." ;;
+            0) return ;;
+            *) echo -e "${RED}Invalid option!${NC}"; sleep 1 ;;
+        esac
+    done
+}
+
+# Database submenu
+show_database_menu() {
+    while true; do
+        clear
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}               ${GREEN}💾 Database${NC}                              ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        echo -e "  ${GREEN}1)${NC} migrate       - Run database migrations"
+        echo -e "  ${GREEN}2)${NC} migrate:fresh - Fresh migration with seeders"
+        echo -e "  ${GREEN}3)${NC} seed          - Run database seeders"
+        echo -e "  ${GREEN}4)${NC} tinker        - Start Laravel Tinker"
+        echo ""
+        echo -e "  ${YELLOW}0)${NC} ← Back to Main Menu"
+        echo ""
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        read -p "$(echo -e ${YELLOW}Select option [0-4]:${NC} )" choice
+        
+        case $choice in
+            1) echo ""; "$0" migrate; read -p "Press Enter to continue..." ;;
+            2) echo ""; "$0" migrate:fresh; read -p "Press Enter to continue..." ;;
+            3) echo ""; "$0" seed; read -p "Press Enter to continue..." ;;
+            4) echo ""; "$0" tinker ;;
+            0) return ;;
+            *) echo -e "${RED}Invalid option!${NC}"; sleep 1 ;;
+        esac
+    done
+}
+
+# Maintenance submenu
+show_maintenance_menu() {
+    while true; do
+        clear
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}              ${GREEN}🔧 Maintenance${NC}                           ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        echo -e "  ${GREEN}1)${NC} cache:clear - Clear all caches"
+        echo -e "  ${GREEN}2)${NC} optimize    - Optimize the application"
+        echo -e "  ${GREEN}3)${NC} logs        - Tail Laravel logs"
+        echo ""
+        echo -e "  ${YELLOW}0)${NC} ← Back to Main Menu"
+        echo ""
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        read -p "$(echo -e ${YELLOW}Select option [0-3]:${NC} )" choice
+        
+        case $choice in
+            1) echo ""; "$0" cache:clear; read -p "Press Enter to continue..." ;;
+            2) echo ""; "$0" optimize; read -p "Press Enter to continue..." ;;
+            3) echo ""; "$0" logs ;;
+            0) return ;;
+            *) echo -e "${RED}Invalid option!${NC}"; sleep 1 ;;
+        esac
+    done
+}
+
+# Code Quality submenu
+show_code_quality_menu() {
+    while true; do
+        clear
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}             ${GREEN}📊 Code Quality${NC}                          ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        echo -e "  ${GREEN}1)${NC} analyze - Run PHPStan static analysis"
+        echo -e "  ${GREEN}2)${NC} format  - Format code with Pint"
+        echo ""
+        echo -e "  ${YELLOW}0)${NC} ← Back to Main Menu"
+        echo ""
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        read -p "$(echo -e ${YELLOW}Select option [0-2]:${NC} )" choice
+        
+        case $choice in
+            1) echo ""; "$0" analyze; read -p "Press Enter to continue..." ;;
+            2) echo ""; "$0" format; read -p "Press Enter to continue..." ;;
+            0) return ;;
+            *) echo -e "${RED}Invalid option!${NC}"; sleep 1 ;;
+        esac
+    done
+}
+
+# Dependencies submenu
+show_dependencies_menu() {
+    while true; do
+        clear
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}              ${GREEN}📦 Dependencies${NC}                          ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        echo -e "  ${GREEN}1)${NC} install - Install all dependencies"
+        echo -e "  ${GREEN}2)${NC} update  - Update all dependencies"
+        echo ""
+        echo -e "  ${YELLOW}0)${NC} ← Back to Main Menu"
+        echo ""
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        read -p "$(echo -e ${YELLOW}Select option [0-2]:${NC} )" choice
+        
+        case $choice in
+            1) echo ""; "$0" install; read -p "Press Enter to continue..." ;;
+            2) echo ""; "$0" update; read -p "Press Enter to continue..." ;;
+            0) return ;;
+            *) echo -e "${RED}Invalid option!${NC}"; sleep 1 ;;
+        esac
+    done
+}
+
+# Other Tools submenu
+show_other_menu() {
+    while true; do
+        clear
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}              ${GREEN}🛠️  Other Tools${NC}                          ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        echo -e "  ${GREEN}1)${NC} routes          - List all routes"
+        echo -e "  ${GREEN}2)${NC} queue           - Start queue worker"
+        echo -e "  ${GREEN}3)${NC} schedule        - Run scheduled tasks"
+        echo -e "  ${GREEN}4)${NC} share           - Share site publicly via Expose"
+        echo -e "  ${GREEN}5)${NC} phpmyadmin      - Start Apache & open phpMyAdmin"
+        echo -e "  ${GREEN}6)${NC} phpmyadmin:stop - Stop Apache"
+        echo -e "  ${GREEN}7)${NC} docs            - Open ACADEX documentation"
+        echo -e "  ${GREEN}8)${NC} uninstall       - Uninstall ACADEX CLI globally"
+        echo ""
+        echo -e "  ${YELLOW}0)${NC} ← Back to Main Menu"
+        echo ""
+        echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        read -p "$(echo -e ${YELLOW}Select option [0-8]:${NC} )" 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 ;;
+            1) echo ""; "$0" routes; read -p "Press Enter to continue..." ;;
+            2) echo ""; "$0" queue ;;
+            3) echo ""; "$0" schedule; read -p "Press Enter to continue..." ;;
+            4) echo ""; "$0" share ;;
+            5) echo ""; "$0" phpmyadmin; read -p "Press Enter to continue..." ;;
+            6) echo ""; "$0" phpmyadmin:stop; read -p "Press Enter to continue..." ;;
+            7) echo ""; "$0" docs; read -p "Press Enter to continue..." ;;
+            8) echo ""; "$0" uninstall ;;
+            0) return ;;
+            *) echo -e "${RED}Invalid option!${NC}"; sleep 1 ;;
         esac
     done
 }

package/acadex.ps1

@@ -103,11 +103,11 @@ function Show-Help {
     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 "Interactive menu (modern UI)"
     Write-Host ""
     Write-Host "Examples:" -ForegroundColor Yellow
+    Write-Host "  acadex menu           # Launch interactive menu"
     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"
@@ -116,91 +116,271 @@ function Show-Help {
     Write-Host ""
 }
 
-# Interactive Menu
+# Check if a command exists
+function Test-CommandExists {
+    param([string]$Cmd)
+    $null -ne (Get-Command $Cmd -ErrorAction SilentlyContinue)
+}
+
+# Interactive menu
 function Show-Menu {
     while ($true) {
         Clear-Host
         Write-Host "===========================================================" -ForegroundColor Cyan
-        Write-Host "            ACADEX - Interactive Command Menu              " -ForegroundColor Green
+        Write-Host "      ACADEX - Interactive Menu (Select Category)         " -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 "Main Menu:" -ForegroundColor Yellow
         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 "  1) 📦 Setup & Installation" -ForegroundColor Green
+        Write-Host "  2) 🚀 Development" -ForegroundColor Green
+        Write-Host "  3) 🧪 Testing" -ForegroundColor Green
+        Write-Host "  4) 💾 Database" -ForegroundColor Green
+        Write-Host "  5) 🔧 Maintenance" -ForegroundColor Green
+        Write-Host "  6) 📊 Code Quality" -ForegroundColor Green
+        Write-Host "  7) 📦 Dependencies" -ForegroundColor Green
+        Write-Host "  8) 🛠️  Other Tools" -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 "  0) ❌ Exit" -ForegroundColor Red
         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 "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Cyan
+        $category = Read-Host "Select category [0-8]"
+        
+        switch ($category) {
+            "1" { Show-SetupMenu }
+            "2" { Show-DevelopmentMenu }
+            "3" { Show-TestingMenu }
+            "4" { Show-DatabaseMenu }
+            "5" { Show-MaintenanceMenu }
+            "6" { Show-CodeQualityMenu }
+            "7" { Show-DependenciesMenu }
+            "8" { Show-OtherMenu }
+            "0" { Write-Host ""; Write-Host "Goodbye!" -ForegroundColor Green; return }
+            default { Write-Host "Invalid option!" -ForegroundColor Red; Start-Sleep -Seconds 1 }
+        }
+    }
+}
+
+function Show-SetupMenu {
+    while ($true) {
+        Clear-Host
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "          📦 Setup & Installation                          " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
         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 "  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 "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 "  0) ← Back to Main Menu" -ForegroundColor Yellow
         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 "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Cyan
+        $choice = Read-Host "Select option [0-4]"
+        
+        switch ($choice) {
+            "1" { Write-Host ""; & $MyInvocation.MyCommand.Path "setup"; Read-Host "Press Enter to continue" }
+            "2" { Write-Host ""; & $MyInvocation.MyCommand.Path "install:2fa"; Read-Host "Press Enter to continue" }
+            "3" { Write-Host ""; & $MyInvocation.MyCommand.Path "install:notif"; Read-Host "Press Enter to continue" }
+            "4" { Write-Host ""; & $MyInvocation.MyCommand.Path "check"; Read-Host "Press Enter to continue" }
+            "0" { return }
+            default { Write-Host "Invalid option!" -ForegroundColor Red; Start-Sleep -Seconds 1 }
+        }
+    }
+}
+
+function Show-DevelopmentMenu {
+    while ($true) {
+        Clear-Host
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "              🚀 Development                               " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        Write-Host "  1) serve    - Start production servers" -ForegroundColor Green
+        Write-Host "  2) services - Start background services only (for Herd)" -ForegroundColor Green
+        Write-Host "  3) dev      - Start dev servers" -ForegroundColor Green
+        Write-Host "  4) build    - Build assets for production" -ForegroundColor Green
+        Write-Host "  5) ui       - Rebuild UI assets and clear caches" -ForegroundColor Green
+        Write-Host "  6) start    - Start Laravel server only" -ForegroundColor Green
         Write-Host ""
-        Write-Host "  0)  Exit" -ForegroundColor Red
+        Write-Host "  0) ← Back to Main Menu" -ForegroundColor Yellow
         Write-Host ""
-        $choice = Read-Host "Select an option [0-24]"
+        Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Cyan
+        $choice = Read-Host "Select option [0-6]"
         
         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 }
+            "1" { Write-Host ""; & $MyInvocation.MyCommand.Path "serve" }
+            "2" { Write-Host ""; & $MyInvocation.MyCommand.Path "services" }
+            "3" { Write-Host ""; & $MyInvocation.MyCommand.Path "dev" }
+            "4" { Write-Host ""; & $MyInvocation.MyCommand.Path "build"; Read-Host "Press Enter to continue" }
+            "5" { Write-Host ""; & $MyInvocation.MyCommand.Path "ui"; Read-Host "Press Enter to continue" }
+            "6" { Write-Host ""; & $MyInvocation.MyCommand.Path "start" }
+            "0" { return }
+            default { Write-Host "Invalid option!" -ForegroundColor Red; Start-Sleep -Seconds 1 }
         }
     }
 }
 
-# Check if a command exists
-function Test-CommandExists {
-    param([string]$Cmd)
-    $null -ne (Get-Command $Cmd -ErrorAction SilentlyContinue)
+function Show-TestingMenu {
+    while ($true) {
+        Clear-Host
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "                🧪 Testing                                 " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        Write-Host "  1) test          - Run PHPUnit tests" -ForegroundColor Green
+        Write-Host "  2) test:coverage - Run tests with coverage" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "  0) ← Back to Main Menu" -ForegroundColor Yellow
+        Write-Host ""
+        Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Cyan
+        $choice = Read-Host "Select option [0-2]"
+        
+        switch ($choice) {
+            "1" { Write-Host ""; & $MyInvocation.MyCommand.Path "test"; Read-Host "Press Enter to continue" }
+            "2" { Write-Host ""; & $MyInvocation.MyCommand.Path "test:coverage"; Read-Host "Press Enter to continue" }
+            "0" { return }
+            default { Write-Host "Invalid option!" -ForegroundColor Red; Start-Sleep -Seconds 1 }
+        }
+    }
+}
+
+function Show-DatabaseMenu {
+    while ($true) {
+        Clear-Host
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "               💾 Database                                 " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        Write-Host "  1) migrate       - Run database migrations" -ForegroundColor Green
+        Write-Host "  2) migrate:fresh - Fresh migration with seeders" -ForegroundColor Green
+        Write-Host "  3) seed          - Run database seeders" -ForegroundColor Green
+        Write-Host "  4) tinker        - Start Laravel Tinker" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "  0) ← Back to Main Menu" -ForegroundColor Yellow
+        Write-Host ""
+        Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Cyan
+        $choice = Read-Host "Select option [0-4]"
+        
+        switch ($choice) {
+            "1" { Write-Host ""; & $MyInvocation.MyCommand.Path "migrate"; Read-Host "Press Enter to continue" }
+            "2" { Write-Host ""; & $MyInvocation.MyCommand.Path "migrate:fresh"; Read-Host "Press Enter to continue" }
+            "3" { Write-Host ""; & $MyInvocation.MyCommand.Path "seed"; Read-Host "Press Enter to continue" }
+            "4" { Write-Host ""; & $MyInvocation.MyCommand.Path "tinker" }
+            "0" { return }
+            default { Write-Host "Invalid option!" -ForegroundColor Red; Start-Sleep -Seconds 1 }
+        }
+    }
+}
+
+function Show-MaintenanceMenu {
+    while ($true) {
+        Clear-Host
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "              🔧 Maintenance                               " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        Write-Host "  1) cache:clear - Clear all caches" -ForegroundColor Green
+        Write-Host "  2) optimize    - Optimize the application" -ForegroundColor Green
+        Write-Host "  3) logs        - Tail Laravel logs" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "  0) ← Back to Main Menu" -ForegroundColor Yellow
+        Write-Host ""
+        Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Cyan
+        $choice = Read-Host "Select option [0-3]"
+        
+        switch ($choice) {
+            "1" { Write-Host ""; & $MyInvocation.MyCommand.Path "cache:clear"; Read-Host "Press Enter to continue" }
+            "2" { Write-Host ""; & $MyInvocation.MyCommand.Path "optimize"; Read-Host "Press Enter to continue" }
+            "3" { Write-Host ""; & $MyInvocation.MyCommand.Path "logs" }
+            "0" { return }
+            default { Write-Host "Invalid option!" -ForegroundColor Red; Start-Sleep -Seconds 1 }
+        }
+    }
+}
+
+function Show-CodeQualityMenu {
+    while ($true) {
+        Clear-Host
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "             📊 Code Quality                               " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        Write-Host "  1) analyze - Run PHPStan static analysis" -ForegroundColor Green
+        Write-Host "  2) format  - Format code with Pint" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "  0) ← Back to Main Menu" -ForegroundColor Yellow
+        Write-Host ""
+        Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Cyan
+        $choice = Read-Host "Select option [0-2]"
+        
+        switch ($choice) {
+            "1" { Write-Host ""; & $MyInvocation.MyCommand.Path "analyze"; Read-Host "Press Enter to continue" }
+            "2" { Write-Host ""; & $MyInvocation.MyCommand.Path "format"; Read-Host "Press Enter to continue" }
+            "0" { return }
+            default { Write-Host "Invalid option!" -ForegroundColor Red; Start-Sleep -Seconds 1 }
+        }
+    }
+}
+
+function Show-DependenciesMenu {
+    while ($true) {
+        Clear-Host
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "              📦 Dependencies                              " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        Write-Host "  1) install - Install all dependencies" -ForegroundColor Green
+        Write-Host "  2) update  - Update all dependencies" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "  0) ← Back to Main Menu" -ForegroundColor Yellow
+        Write-Host ""
+        Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Cyan
+        $choice = Read-Host "Select option [0-2]"
+        
+        switch ($choice) {
+            "1" { Write-Host ""; & $MyInvocation.MyCommand.Path "install"; Read-Host "Press Enter to continue" }
+            "2" { Write-Host ""; & $MyInvocation.MyCommand.Path "update"; Read-Host "Press Enter to continue" }
+            "0" { return }
+            default { Write-Host "Invalid option!" -ForegroundColor Red; Start-Sleep -Seconds 1 }
+        }
+    }
+}
+
+function Show-OtherMenu {
+    while ($true) {
+        Clear-Host
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "              🛠️  Other Tools                              " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        Write-Host "  1) routes          - List all routes" -ForegroundColor Green
+        Write-Host "  2) queue           - Start queue worker" -ForegroundColor Green
+        Write-Host "  3) schedule        - Run scheduled tasks" -ForegroundColor Green
+        Write-Host "  4) share           - Share site publicly via Expose" -ForegroundColor Green
+        Write-Host "  5) phpmyadmin      - Start Apache & open phpMyAdmin" -ForegroundColor Green
+        Write-Host "  6) phpmyadmin:stop - Stop Apache" -ForegroundColor Green
+        Write-Host "  7) docs            - Open ACADEX documentation" -ForegroundColor Green
+        Write-Host "  8) uninstall       - Uninstall ACADEX CLI globally" -ForegroundColor Green
+        Write-Host ""
+        Write-Host "  0) ← Back to Main Menu" -ForegroundColor Yellow
+        Write-Host ""
+        Write-Host "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" -ForegroundColor Cyan
+        $choice = Read-Host "Select option [0-8]"
+        
+        switch ($choice) {
+            "1" { Write-Host ""; & $MyInvocation.MyCommand.Path "routes"; Read-Host "Press Enter to continue" }
+            "2" { Write-Host ""; & $MyInvocation.MyCommand.Path "queue" }
+            "3" { Write-Host ""; & $MyInvocation.MyCommand.Path "schedule"; Read-Host "Press Enter to continue" }
+            "4" { Write-Host ""; & $MyInvocation.MyCommand.Path "share" }
+            "5" { Write-Host ""; & $MyInvocation.MyCommand.Path "phpmyadmin"; Read-Host "Press Enter to continue" }
+            "6" { Write-Host ""; & $MyInvocation.MyCommand.Path "phpmyadmin:stop"; Read-Host "Press Enter to continue" }
+            "7" { Write-Host ""; & $MyInvocation.MyCommand.Path "docs"; Read-Host "Press Enter to continue" }
+            "8" { Write-Host ""; & $MyInvocation.MyCommand.Path "uninstall" }
+            "0" { return }
+            default { Write-Host "Invalid option!" -ForegroundColor Red; Start-Sleep -Seconds 1 }
+        }
+    }
 }
 
 # Command handlers

package/bin/acadex.js

@@ -7,6 +7,17 @@ const fs = require('fs');
 
 const platform = os.platform();
 const scriptDir = path.join(__dirname, '..');
+const args = process.argv.slice(2);
+
+// Check if menu command with no additional args - use interactive menu
+if (args.length === 1 && args[0] === 'menu') {
+  const { startInteractiveMenu } = require('./interactive-menu');
+  startInteractiveMenu().catch(error => {
+    console.error('Error running interactive menu:', error.message);
+    process.exit(1);
+  });
+  return;
+}
 
 let scriptPath;
 let shell;
@@ -29,7 +40,7 @@ if (platform === 'win32') {
     '-NoProfile',
     '-ExecutionPolicy', 'Bypass',
     '-File', scriptPath,
-    ...process.argv.slice(2)
+    ...args
   ];
 } else if (platform === 'darwin' || platform === 'linux') {
   // macOS and Linux - use bash script
@@ -50,7 +61,7 @@ if (platform === 'win32') {
   }
   
   shell = 'bash';
-  shellArgs = [scriptPath, ...process.argv.slice(2)];
+  shellArgs = [scriptPath, ...args];
 } else {
   // Unsupported platform
   console.error(`Error: Unsupported platform: ${platform}`);

package/bin/interactive-menu.js

@@ -0,0 +1,432 @@
+#!/usr/bin/env node
+
+const inquirer = require('inquirer');
+const { spawn } = require('child_process');
+const path = require('path');
+
+// Get the script path based on platform
+const getScriptPath = (platform) => {
+  const scriptDir = path.join(__dirname, '..');
+  if (platform === 'win32') {
+    return path.join(scriptDir, 'acadex.ps1');
+  }
+  return path.join(scriptDir, 'acadex');
+};
+
+// Execute command
+const executeCommand = (command, platform) => {
+  return new Promise((resolve) => {
+    const scriptPath = getScriptPath(platform);
+    let shell, args;
+    
+    if (platform === 'win32') {
+      shell = 'powershell.exe';
+      args = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', scriptPath, command];
+    } else {
+      shell = 'bash';
+      args = [scriptPath, command];
+    }
+    
+    const child = spawn(shell, args, { stdio: 'inherit' });
+    
+    child.on('close', (code) => {
+      resolve(code);
+    });
+  });
+};
+
+// Main menu
+const showMainMenu = async (platform) => {
+  const { category } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'category',
+      message: '╔═══════════════════════════════════════╗\n║    ACADEX - Interactive Menu (v1.1)   ║\n╚═══════════════════════════════════════╝\n\nSelect a category:',
+      choices: [
+        { name: '[+] Setup & Installation', value: 'setup' },
+        { name: '[>] Development', value: 'development' },
+        { name: '[✓] Testing', value: 'testing' },
+        { name: '[#] Database', value: 'database' },
+        { name: '[*] Maintenance', value: 'maintenance' },
+        { name: '[~] Code Quality', value: 'quality' },
+        { name: '[=] Dependencies', value: 'dependencies' },
+        { name: '[•] Other Commands', value: 'other' },
+        new inquirer.Separator(),
+        { name: '[X] Exit', value: 'exit' }
+      ],
+      pageSize: 15
+    }
+  ]);
+  
+  if (category === 'exit') {
+    console.log('\n[✓] Goodbye!\n');
+    process.exit(0);
+  }
+  
+  return category;
+};
+
+// Setup & Installation submenu
+const showSetupMenu = async (platform) => {
+  const { command } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'command',
+      message: '\n[+] Setup & Installation - Select command:',
+      choices: [
+        { name: 'setup - First-time full installation', value: 'setup' },
+        { name: 'install:2fa - Install 2FA packages', value: 'install:2fa' },
+        { name: 'install:notif - Install notification packages', value: 'install:notif' },
+        { name: 'check - Check system requirements', value: 'check' },
+        new inquirer.Separator(),
+        { name: '← Back to Main Menu', value: 'back' }
+      ]
+    }
+  ]);
+  
+  if (command === 'back') return 'back';
+  
+  await executeCommand(command, platform);
+  
+  const { next } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'next',
+      message: '\nWhat would you like to do next?',
+      choices: [
+        { name: '← Back to Setup & Installation menu', value: 'submenu' },
+        { name: '[H] Back to Main Menu', value: 'main' }
+      ]
+    }
+  ]);
+  
+  return next === 'main' ? 'back' : 'repeat';
+};
+
+// Development submenu
+const showDevelopmentMenu = async (platform) => {
+  const { command } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'command',
+      message: '\n[>] Development - Select command:',
+      choices: [
+        { name: 'serve - Start production servers (Laravel + Queue + Scheduler + Reverb)', value: 'serve' },
+        { name: 'services - Start background services only (for Herd)', value: 'services' },
+        { name: 'dev - Start dev servers (Laravel + Queue + Logs + Vite + Reverb)', value: 'dev' },
+        { name: 'build - Build assets for production', value: 'build' },
+        { name: 'ui - Rebuild UI assets and clear caches', value: 'ui' },
+        { name: 'start - Start Laravel server only', value: 'start' },
+        new inquirer.Separator(),
+        { name: '← Back to Main Menu', value: 'back' }
+      ]
+    }
+  ]);
+  
+  if (command === 'back') return 'back';
+  
+  await executeCommand(command, platform);
+  
+  const { next } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'next',
+      message: '\nWhat would you like to do next?',
+      choices: [
+        { name: '← Back to Development menu', value: 'submenu' },
+        { name: '[H] Back to Main Menu', value: 'main' }
+      ]
+    }
+  ]);
+  
+  return next === 'main' ? 'back' : 'repeat';
+};
+
+// Testing submenu
+const showTestingMenu = async (platform) => {
+  const { command } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'command',
+      message: '\n[✓] Testing - Select command:',
+      choices: [
+        { name: 'test - Run PHPUnit tests', value: 'test' },
+        { name: 'test:coverage - Run tests with coverage', value: 'test:coverage' },
+        new inquirer.Separator(),
+        { name: '← Back to Main Menu', value: 'back' }
+      ]
+    }
+  ]);
+  
+  if (command === 'back') return 'back';
+  
+  await executeCommand(command, platform);
+  
+  const { next } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'next',
+      message: '\nWhat would you like to do next?',
+      choices: [
+        { name: '← Back to Testing menu', value: 'submenu' },
+        { name: '[H] Back to Main Menu', value: 'main' }
+      ]
+    }
+  ]);
+  
+  return next === 'main' ? 'back' : 'repeat';
+};
+
+// Database submenu
+const showDatabaseMenu = async (platform) => {
+  const { command } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'command',
+      message: '\n[#] Database - Select command:',
+      choices: [
+        { name: 'migrate - Run database migrations', value: 'migrate' },
+        { name: 'migrate:fresh - Fresh migration with seeders', value: 'migrate:fresh' },
+        { name: 'seed - Run database seeders', value: 'seed' },
+        { name: 'tinker - Start Laravel Tinker', value: 'tinker' },
+        new inquirer.Separator(),
+        { name: '← Back to Main Menu', value: 'back' }
+      ]
+    }
+  ]);
+  
+  if (command === 'back') return 'back';
+  
+  await executeCommand(command, platform);
+  
+  if (command === 'tinker') return 'back';
+  
+  const { next } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'next',
+      message: '\nWhat would you like to do next?',
+      choices: [
+        { name: '← Back to Database menu', value: 'submenu' },
+        { name: '[H] Back to Main Menu', value: 'main' }
+      ]
+    }
+  ]);
+  
+  return next === 'main' ? 'back' : 'repeat';
+};
+
+// Maintenance submenu
+const showMaintenanceMenu = async (platform) => {
+  const { command } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'command',
+      message: '\n[*] Maintenance - Select command:',
+      choices: [
+        { name: 'cache:clear - Clear all caches', value: 'cache:clear' },
+        { name: 'optimize - Optimize the application', value: 'optimize' },
+        { name: 'logs - Tail Laravel logs', value: 'logs' },
+        new inquirer.Separator(),
+        { name: '← Back to Main Menu', value: 'back' }
+      ]
+    }
+  ]);
+  
+  if (command === 'back') return 'back';
+  
+  await executeCommand(command, platform);
+  
+  if (command === 'logs') return 'back';
+  
+  const { next } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'next',
+      message: '\nWhat would you like to do next?',
+      choices: [
+        { name: '← Back to Maintenance menu', value: 'submenu' },
+        { name: '[H] Back to Main Menu', value: 'main' }
+      ]
+    }
+  ]);
+  
+  return next === 'main' ? 'back' : 'repeat';
+};
+
+// Code Quality submenu
+const showQualityMenu = async (platform) => {
+  const { command } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'command',
+      message: '\n[~] Code Quality - Select command:',
+      choices: [
+        { name: 'analyze - Run PHPStan static analysis', value: 'analyze' },
+        { name: 'format - Format code with Pint', value: 'format' },
+        new inquirer.Separator(),
+        { name: '← Back to Main Menu', value: 'back' }
+      ]
+    }
+  ]);
+  
+  if (command === 'back') return 'back';
+  
+  await executeCommand(command, platform);
+  
+  const { next } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'next',
+      message: '\nWhat would you like to do next?',
+      choices: [
+        { name: '← Back to Code Quality menu', value: 'submenu' },
+        { name: '[H] Back to Main Menu', value: 'main' }
+      ]
+    }
+  ]);
+  
+  return next === 'main' ? 'back' : 'repeat';
+};
+
+// Dependencies submenu
+const showDependenciesMenu = async (platform) => {
+  const { command } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'command',
+      message: '\n[=] Dependencies - Select command:',
+      choices: [
+        { name: 'install - Install all dependencies', value: 'install' },
+        { name: 'update - Update all dependencies', value: 'update' },
+        new inquirer.Separator(),
+        { name: '← Back to Main Menu', value: 'back' }
+      ]
+    }
+  ]);
+  
+  if (command === 'back') return 'back';
+  
+  await executeCommand(command, platform);
+  
+  const { next } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'next',
+      message: '\nWhat would you like to do next?',
+      choices: [
+        { name: '← Back to Dependencies menu', value: 'submenu' },
+        { name: '[H] Back to Main Menu', value: 'main' }
+      ]
+    }
+  ]);
+  
+  return next === 'main' ? 'back' : 'repeat';
+};
+
+// Other Commands submenu
+const showOtherMenu = async (platform) => {
+  const { command } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'command',
+      message: '\n[•] Other Commands - Select command:',
+      choices: [
+        { name: 'routes - List all routes', value: 'routes' },
+        { name: 'queue - Start queue worker', value: 'queue' },
+        { name: 'schedule - Run scheduled tasks', value: 'schedule' },
+        { name: 'share - Share site publicly via Expose', value: 'share' },
+        { name: 'phpmyadmin - Start Apache & open phpMyAdmin', value: 'phpmyadmin' },
+        { name: 'phpmyadmin:stop - Stop Apache', value: 'phpmyadmin:stop' },
+        { name: 'docs - Open ACADEX documentation', value: 'docs' },
+        new inquirer.Separator(),
+        { name: '← Back to Main Menu', value: 'back' }
+      ]
+    }
+  ]);
+  
+  if (command === 'back') return 'back';
+  
+  await executeCommand(command, platform);
+  
+  if (['queue', 'share'].includes(command)) return 'back';
+  
+  const { next } = await inquirer.prompt([
+    {
+      type: 'list',
+      name: 'next',
+      message: '\nWhat would you like to do next?',
+      choices: [
+        { name: '← Back to Other Commands menu', value: 'submenu' },
+        { name: '[H] Back to Main Menu', value: 'main' }
+      ]
+    }
+  ]);
+  
+  return next === 'main' ? 'back' : 'repeat';
+};
+
+// Main interactive loop
+const startInteractiveMenu = async () => {
+  const platform = require('os').platform();
+  
+  while (true) {
+    const category = await showMainMenu(platform);
+    
+    if (category === 'exit') {
+      console.log('\nGoodbye! 👋');
+      process.exit(0);
+    }
+    
+    // Stay in the submenu until user explicitly chooses to go back
+    let shouldReturn = false;
+    while (!shouldReturn) {
+      let result;
+      switch (category) {
+        case 'setup':
+          result = await showSetupMenu(platform);
+          break;
+        case 'development':
+          result = await showDevelopmentMenu(platform);
+          break;
+        case 'testing':
+          result = await showTestingMenu(platform);
+          break;
+        case 'database':
+          result = await showDatabaseMenu(platform);
+          break;
+        case 'maintenance':
+          result = await showMaintenanceMenu(platform);
+          break;
+        case 'quality':
+          result = await showQualityMenu(platform);
+          break;
+        case 'dependencies':
+          result = await showDependenciesMenu(platform);
+          break;
+        case 'other':
+          result = await showOtherMenu(platform);
+          break;
+        default:
+          shouldReturn = true;
+          break;
+      }
+      
+      // If submenu returns 'back', exit to main menu
+      if (result === 'back') {
+        shouldReturn = true;
+      }
+      // If submenu returns 'repeat', stay in submenu
+    }
+  }
+};
+
+module.exports = { startInteractiveMenu };
+
+// Run if called directly
+if (require.main === module) {
+  startInteractiveMenu().catch(error => {
+    console.error('Error:', error.message);
+    process.exit(1);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acadex-cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "A global CLI tool for managing Acadex projects with easy setup and automation",
   "main": "bin/acadex.js",
   "bin": {
@@ -33,6 +33,9 @@
     "node": ">=14.0.0"
   },
   "preferGlobal": true,
+  "dependencies": {
+    "inquirer": "^8.2.6"
+  },
   "os": [
     "darwin",
     "linux",