acadex-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Learn From Xavi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,71 @@
+# acadex-cli
+
+A global CLI tool for managing Acadex projects with easy setup and automation.
+
+## Installation
+
+### Via npm (Global)
+
+```bash
+npm install -g acadex-cli
+```
+
+After installation, you can use the `acadex` command from anywhere:
+
+```bash
+acadex --help
+```
+
+### Manual Installation
+
+Clone the repository and link it globally:
+
+```bash
+git clone <repository-url>
+cd acadex-cli-global
+npm link
+```
+
+## Usage
+
+Run the CLI tool using:
+
+```bash
+acadex <command> [arguments]
+```
+
+### Available Commands
+
+#### Setup & Installation
+- `acadex setup` - First-time full installation
+- `acadex install:2fa` - Install 2FA packages
+- `acadex install:notif` - Install notification feature packages
+- `acadex check` - Check system requirements
+
+#### Development
+- `acadex serve` - Start production servers (Laravel + Queue + Scheduler + Reverb)
+- `acadex services` - Start background services only (for Herd)
+- `acadex dev` - Start dev servers (Laravel + Queue + Logs + Vite + Reverb)
+- `acadex build` - Build assets for production
+- `acadex ui` - Rebuild UI assets and clear caches
+- `acadex start` - Start Laravel server only
+
+#### Testing
+- `acadex test` - Run PHPUnit tests
+- `acadex test:coverage` - Run tests with coverage
+
+#### Database
+- `acadex migrate` - Run database migrations
+- `acadex migrate:fresh` - Fresh migration with seeders
+- `acadex seed` - Run database seeders
+- `acadex tinker` - Start Laravel Tinker
+
+## Requirements
+
+- Node.js >= 14.0.0
+- Bash shell (Linux/macOS) or PowerShell (Windows)
+- PHP and Composer (for Laravel projects)
+
+## License
+
+MIT

package/acadex

@@ -0,0 +1,497 @@
+#!/bin/bash
+
+# ACADEX - Custom command wrapper for AcadexV3
+# Usage: ./acadex <command> [arguments]
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Project root directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+# Display help
+show_help() {
+    echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+    echo -e "${BLUE}║${NC}                 ${GREEN}ACADEX${NC} - AcadexV3 Commands                ${BLUE}║${NC}"
+    echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+    echo ""
+    echo -e "${YELLOW}Usage:${NC} acadex <command> [arguments]"
+    echo ""
+    echo -e "${YELLOW}Available Commands:${NC}"
+    echo ""
+    echo -e "  ${BLUE}Setup & Installation:${NC}"
+    echo -e "  ${GREEN}setup${NC}           First-time full installation"
+    echo -e "  ${GREEN}install:2fa${NC}     Install 2FA packages (existing install)"
+    echo -e "  ${GREEN}install:notif${NC}   Install notification feature packages"
+    echo -e "  ${GREEN}check${NC}           Check system requirements"
+    echo ""
+    echo -e "  ${BLUE}Development:${NC}"
+    echo -e "  ${GREEN}serve${NC}           Start production servers (Laravel + Queue + Scheduler + Reverb)"
+    echo -e "  ${GREEN}services${NC}        Start background services only (for Herd)"
+    echo -e "  ${GREEN}dev${NC}             Start dev servers (Laravel + Queue + Logs + Vite + Reverb)"
+    echo -e "  ${GREEN}build${NC}           Build assets for production (npm run build)"
+    echo -e "  ${GREEN}ui${NC}              Rebuild UI assets and clear caches"
+    echo -e "  ${GREEN}start${NC}           Start Laravel server only"
+    echo ""
+    echo -e "  ${BLUE}Testing:${NC}"
+    echo -e "  ${GREEN}test${NC}            Run PHPUnit tests"
+    echo -e "  ${GREEN}test:coverage${NC}   Run tests with coverage"
+    echo ""
+    echo -e "  ${BLUE}Database:${NC}"
+    echo -e "  ${GREEN}migrate${NC}         Run database migrations"
+    echo -e "  ${GREEN}migrate:fresh${NC}   Fresh migration with seeders"
+    echo -e "  ${GREEN}seed${NC}            Run database seeders"
+    echo -e "  ${GREEN}tinker${NC}          Start Laravel Tinker"
+    echo ""
+    echo -e "  ${BLUE}Maintenance:${NC}"
+    echo -e "  ${GREEN}cache:clear${NC}     Clear all caches"
+    echo -e "  ${GREEN}optimize${NC}        Optimize the application"
+    echo -e "  ${GREEN}logs${NC}            Tail Laravel logs"
+    echo ""
+    echo -e "  ${BLUE}Code Quality:${NC}"
+    echo -e "  ${GREEN}analyze${NC}         Run PHPStan static analysis"
+    echo -e "  ${GREEN}format${NC}          Format code with Pint"
+    echo ""
+    echo -e "  ${BLUE}Dependencies:${NC}"
+    echo -e "  ${GREEN}install${NC}         Install all dependencies"
+    echo -e "  ${GREEN}update${NC}          Update all dependencies"
+    echo ""
+    echo -e "  ${BLUE}Other:${NC}"
+    echo -e "  ${GREEN}routes${NC}          List all routes"
+    echo -e "  ${GREEN}queue${NC}           Start queue worker"
+    echo -e "  ${GREEN}schedule${NC}        Run scheduled tasks"
+    echo -e "  ${GREEN}share${NC}           Share site publicly via Expose"
+    echo -e "  ${GREEN}phpmyadmin${NC}      Start Apache & open phpMyAdmin (port 8080)"
+    echo -e "  ${GREEN}phpmyadmin:stop${NC} Stop Apache"
+    echo -e "  ${GREEN}docs${NC}            Open ACADEX documentation"
+    echo ""
+    echo -e "${YELLOW}Examples:${NC}"
+    echo -e "  acadex setup          # First-time installation"
+    echo -e "  acadex services       # Start services for Herd (recommended)"
+    echo -e "  acadex serve          # Start full stack (without Herd)"
+    echo -e "  acadex dev            # Start development"
+    echo -e "  acadex test           # Run tests"
+    echo -e "  acadex migrate:fresh  # Reset database"
+    echo ""
+}
+
+# Command handlers
+case "$1" in
+    setup)
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}            ${GREEN}ACADEX${NC} - First Time Installation              ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        
+        # Step 1: Check requirements
+        echo -e "${YELLOW}[1/9]${NC} Checking requirements..."
+        
+        # Check PHP
+        if command -v php &> /dev/null; then
+            PHP_VERSION=$(php -r "echo PHP_MAJOR_VERSION.'.'.PHP_MINOR_VERSION;")
+            echo -e "  ${GREEN}✓${NC} PHP $PHP_VERSION found"
+        else
+            echo -e "  ${RED}✗${NC} PHP not found. Please install PHP 8.2+"
+            exit 1
+        fi
+        
+        # Check Composer
+        if command -v composer &> /dev/null; then
+            echo -e "  ${GREEN}✓${NC} Composer found"
+        else
+            echo -e "  ${RED}✗${NC} Composer not found. Please install Composer"
+            exit 1
+        fi
+        
+        # Check Node
+        if command -v node &> /dev/null; then
+            NODE_VERSION=$(node -v)
+            echo -e "  ${GREEN}✓${NC} Node.js $NODE_VERSION found"
+        else
+            echo -e "  ${RED}✗${NC} Node.js not found. Please install Node.js"
+            exit 1
+        fi
+        
+        # Check npm
+        if command -v npm &> /dev/null; then
+            echo -e "  ${GREEN}✓${NC} npm found"
+        else
+            echo -e "  ${RED}✗${NC} npm not found. Please install npm"
+            exit 1
+        fi
+        
+        echo ""
+        
+        # Step 2: Copy .env
+        echo -e "${YELLOW}[2/9]${NC} Setting up environment file..."
+        if [ ! -f .env ]; then
+            if [ -f .env.example ]; then
+                cp .env.example .env
+                echo -e "  ${GREEN}✓${NC} Created .env from .env.example"
+            else
+                echo -e "  ${RED}✗${NC} .env.example not found!"
+                exit 1
+            fi
+        else
+            echo -e "  ${GREEN}✓${NC} .env already exists"
+        fi
+        echo ""
+        
+        # Step 3: Install Composer dependencies
+        echo -e "${YELLOW}[3/9]${NC} Installing Composer dependencies..."
+        echo -e "  ${BLUE}→${NC} This includes: Laravel, Excel, 2FA, Socialite, notifications, etc."
+        composer install --no-interaction
+        if [ $? -eq 0 ]; then
+            echo -e "  ${GREEN}✓${NC} Composer dependencies installed"
+        else
+            echo -e "  ${RED}✗${NC} Composer install failed!"
+            exit 1
+        fi
+        echo ""
+        
+        # Step 4: Install npm dependencies
+        echo -e "${YELLOW}[4/9]${NC} Installing npm dependencies..."
+        npm install
+        if [ $? -eq 0 ]; then
+            echo -e "  ${GREEN}✓${NC} npm dependencies installed"
+        else
+            echo -e "  ${RED}✗${NC} npm install failed!"
+            exit 1
+        fi
+        echo -e "  ${BLUE}→${NC} Installing notification features..."
+        npm install @alpinejs/intersect --save
+        if [ $? -eq 0 ]; then
+            echo -e "  ${GREEN}✓${NC} Notification packages installed"
+        fi
+        echo ""
+        
+        # Step 5: Generate app key
+        echo -e "${YELLOW}[5/9]${NC} Generating application key..."
+        if grep -q "APP_KEY=base64:" .env; then
+            echo -e "  ${GREEN}✓${NC} APP_KEY already set"
+        else
+            php artisan key:generate --ansi
+            echo -e "  ${GREEN}✓${NC} APP_KEY generated"
+        fi
+        echo ""
+        
+        # Step 6: Database setup prompt
+        echo -e "${YELLOW}[6/9]${NC} Database configuration..."
+        echo -e "  ${BLUE}→${NC} Please configure your database in .env file"
+        echo -e "  ${BLUE}→${NC} DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD"
+        echo ""
+        read -p "  Have you configured the database? (y/n): " db_configured
+        if [ "$db_configured" != "y" ] && [ "$db_configured" != "Y" ]; then
+            echo -e "  ${YELLOW}!${NC} Please configure the database in .env and run: acadex migrate"
+            echo ""
+        else
+            # Step 7: Run migrations
+            echo ""
+            echo -e "${YELLOW}[7/9]${NC} Running database migrations..."
+            php artisan migrate --force
+            if [ $? -eq 0 ]; then
+                echo -e "  ${GREEN}✓${NC} Migrations completed"
+            else
+                echo -e "  ${RED}✗${NC} Migration failed! Check your database configuration."
+            fi
+            echo ""
+            
+            # Seeding prompt
+            read -p "  Run database seeders? (y/n): " run_seeders
+            if [ "$run_seeders" = "y" ] || [ "$run_seeders" = "Y" ]; then
+                php artisan db:seed --force
+                echo -e "  ${GREEN}✓${NC} Database seeded"
+            fi
+        fi
+        echo ""
+        
+        # Step 8: Build assets
+        echo -e "${YELLOW}[8/9]${NC} Building frontend assets..."
+        npm run build
+        if [ $? -eq 0 ]; then
+            echo -e "  ${GREEN}✓${NC} Assets built"
+        else
+            echo -e "  ${RED}✗${NC} Build failed!"
+        fi
+        echo ""
+        
+        # Step 9: Optimize
+        echo -e "${YELLOW}[9/9]${NC} Optimizing application..."
+        php artisan config:cache
+        php artisan route:cache
+        php artisan view:cache
+        echo -e "  ${GREEN}✓${NC} Application optimized"
+        echo ""
+        
+        # Done!
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}              ${GREEN}✓ Installation Complete!${NC}                    ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        echo -e "${YELLOW}Next steps:${NC}"
+        echo -e "  1. Configure your .env file (database, mail, etc.)"
+        echo -e "  2. Run ${GREEN}acadex dev${NC} to start development servers"
+        echo -e "  3. Visit ${BLUE}http://localhost:8000${NC}"
+        echo ""
+        ;;
+    
+    install:2fa)
+        echo -e "${GREEN}Installing 2FA packages...${NC}"
+        echo ""
+        composer require pragmarx/google2fa-laravel bacon/bacon-qr-code
+        if [ $? -eq 0 ]; then
+            echo ""
+            echo -e "${GREEN}✓ 2FA packages installed successfully!${NC}"
+            echo -e "  - pragmarx/google2fa-laravel"
+            echo -e "  - bacon/bacon-qr-code"
+        else
+            echo -e "${RED}✗ Installation failed!${NC}"
+            exit 1
+        fi
+        ;;
+    
+    install:notif)
+        echo -e "${GREEN}Installing notification feature packages...${NC}"
+        echo ""
+        npm install @alpinejs/intersect --save
+        if [ $? -eq 0 ]; then
+            echo ""
+            echo -e "${GREEN}✓ Notification packages installed successfully!${NC}"
+            echo -e "  - @alpinejs/intersect"
+        else
+            echo -e "${RED}✗ Installation failed!${NC}"
+            exit 1
+        fi
+        ;;
+    
+    check)
+        echo -e "${BLUE}╔══════════════════════════════════════════════════════════╗${NC}"
+        echo -e "${BLUE}║${NC}              ${GREEN}ACADEX${NC} - System Requirements                ${BLUE}║${NC}"
+        echo -e "${BLUE}╚══════════════════════════════════════════════════════════╝${NC}"
+        echo ""
+        
+        # PHP
+        echo -e "${YELLOW}PHP:${NC}"
+        if command -v php &> /dev/null; then
+            PHP_VERSION=$(php -v | head -n 1)
+            echo -e "  ${GREEN}✓${NC} $PHP_VERSION"
+        else
+            echo -e "  ${RED}✗${NC} PHP not found (required: 8.2+)"
+        fi
+        
+        # Composer
+        echo -e "${YELLOW}Composer:${NC}"
+        if command -v composer &> /dev/null; then
+            COMPOSER_VERSION=$(composer --version)
+            echo -e "  ${GREEN}✓${NC} $COMPOSER_VERSION"
+        else
+            echo -e "  ${RED}✗${NC} Composer not found"
+        fi
+        
+        # Node.js
+        echo -e "${YELLOW}Node.js:${NC}"
+        if command -v node &> /dev/null; then
+            NODE_VERSION=$(node -v)
+            echo -e "  ${GREEN}✓${NC} Node.js $NODE_VERSION"
+        else
+            echo -e "  ${RED}✗${NC} Node.js not found"
+        fi
+        
+        # npm
+        echo -e "${YELLOW}npm:${NC}"
+        if command -v npm &> /dev/null; then
+            NPM_VERSION=$(npm -v)
+            echo -e "  ${GREEN}✓${NC} npm $NPM_VERSION"
+        else
+            echo -e "  ${RED}✗${NC} npm not found"
+        fi
+        
+        # Git
+        echo -e "${YELLOW}Git:${NC}"
+        if command -v git &> /dev/null; then
+            GIT_VERSION=$(git --version)
+            echo -e "  ${GREEN}✓${NC} $GIT_VERSION"
+        else
+            echo -e "  ${RED}✗${NC} Git not found"
+        fi
+        
+        echo ""
+        
+        # Project status
+        echo -e "${YELLOW}Project Status:${NC}"
+        
+        if [ -f .env ]; then
+            echo -e "  ${GREEN}✓${NC} .env file exists"
+        else
+            echo -e "  ${RED}✗${NC} .env file missing"
+        fi
+        
+        if [ -d vendor ]; then
+            echo -e "  ${GREEN}✓${NC} Composer dependencies installed"
+        else
+            echo -e "  ${RED}✗${NC} Composer dependencies not installed"
+        fi
+        
+        if [ -d node_modules ]; then
+            echo -e "  ${GREEN}✓${NC} npm dependencies installed"
+        else
+            echo -e "  ${RED}✗${NC} npm dependencies not installed"
+        fi
+        
+        if [ -d public/build ]; then
+            echo -e "  ${GREEN}✓${NC} Assets built"
+        else
+            echo -e "  ${RED}✗${NC} Assets not built (run: acadex build)"
+        fi
+        
+        echo ""
+        ;;
+    
+    serve)
+        echo -e "${GREEN}Starting production servers (Laravel + Queue + Scheduler + Reverb)...${NC}"
+        npx concurrently -c "#93c5fd,#c4b5fd,#4ade80,#fbbf24" \
+            "php artisan serve" \
+            "php artisan queue:work --tries=3 --timeout=90" \
+            "php artisan schedule:work" \
+            --names=server,queue,scheduler
+        ;;
+    dev)
+        echo -e "${GREEN}Starting development servers (Laravel + Queue + Logs + Vite + Reverb)...${NC}"
+        npx concurrently -c "#93c5fd,#c4b5fd,#fb7185,#fdba74,#fbbf24" \
+            "php artisan serve" \
+            "php artisan queue:work --tries=3 --timeout=90" \
+            "php artisan pail --timeout=0" \
+            "npm run dev" \
+            "php artisan reverb:start" \
+            --names=server,queue,logs,vite,reverb
+        ;;
+    build)
+        echo -e "${GREEN}Building assets for production...${NC}"
+        npm run build
+        ;;
+    ui)
+        echo -e "${GREEN}Rebuilding UI and clearing caches...${NC}"
+        echo -e "  ${BLUE}→${NC} Building frontend assets..."
+        npm run build
+        echo -e "  ${BLUE}→${NC} Clearing all caches..."
+        php artisan optimize:clear
+        echo -e "${GREEN}✓ UI refreshed! Hard refresh your browser (Ctrl+Shift+R or Cmd+Shift+R)${NC}"
+        ;;
+    start)
+        echo -e "${GREEN}Starting Laravel server only...${NC}"
+        php artisan serve
+        ;;
+    test)
+        echo -e "${GREEN}Running tests...${NC}"
+        php artisan test "${@:2}"
+        ;;
+    test:coverage)
+        echo -e "${GREEN}Running tests with coverage...${NC}"
+        php artisan test --coverage "${@:2}"
+        ;;
+    migrate)
+        echo -e "${GREEN}Running migrations...${NC}"
+        php artisan migrate "${@:2}"
+        ;;
+    migrate:fresh)
+        echo -e "${YELLOW}Running fresh migration with seeders...${NC}"
+        php artisan migrate:fresh --seed "${@:2}"
+        ;;
+    seed)
+        echo -e "${GREEN}Running seeders...${NC}"
+        php artisan db:seed "${@:2}"
+        ;;
+    tinker)
+        echo -e "${GREEN}Starting Tinker...${NC}"
+        php artisan tinker
+        ;;
+    cache:clear)
+        echo -e "${GREEN}Clearing all caches...${NC}"
+        php artisan config:clear
+        php artisan cache:clear
+        php artisan route:clear
+        php artisan view:clear
+        echo -e "${GREEN}All caches cleared!${NC}"
+        ;;
+    optimize)
+        echo -e "${GREEN}Optimizing application...${NC}"
+        php artisan optimize
+        ;;
+    logs)
+        echo -e "${GREEN}Tailing Laravel logs...${NC}"
+        tail -f storage/logs/laravel.log
+        ;;
+    analyze)
+        echo -e "${GREEN}Running PHPStan analysis...${NC}"
+        ./vendor/bin/phpstan analyse "${@:2}"
+        ;;
+    format)
+        echo -e "${GREEN}Formatting code with Pint...${NC}"
+        ./vendor/bin/pint "${@:2}"
+        ;;
+    install)
+        echo -e "${GREEN}Installing dependencies...${NC}"
+        composer install
+        npm install
+        echo -e "${BLUE}→${NC} Installing notification features..."
+        npm install @alpinejs/intersect --save
+        echo -e "${GREEN}Dependencies installed!${NC}"
+        ;;
+    update)
+        echo -e "${GREEN}Updating dependencies...${NC}"
+        composer update
+        npm update
+        echo -e "${GREEN}Dependencies updated!${NC}"
+        ;;
+    routes)
+        echo -e "${GREEN}Listing routes...${NC}"
+        php artisan route:list "${@:2}"
+        ;;
+    queue)
+        echo -e "${GREEN}Starting queue worker...${NC}"
+        php artisan queue:work "${@:2}"
+        ;;
+    schedule)
+        echo -e "${GREEN}Running scheduled tasks...${NC}"
+        php artisan schedule:run
+        ;;
+    share)
+        echo -e "${GREEN}Sharing site via Expose...${NC}"
+        echo -e "${YELLOW}Public URL will be displayed below${NC}"
+        echo -e "${YELLOW}Press Ctrl+C to stop sharing${NC}"
+        echo ""
+        expose share https://acadexv3.test
+        ;;
+    phpmyadmin)
+        echo -e "${GREEN}Starting Apache & opening phpMyAdmin...${NC}"
+        sudo /Applications/XAMPP/xamppfiles/bin/apachectl start
+        echo -e "${GREEN}✓ Apache started on port 8080${NC}"
+        echo -e "${YELLOW}Opening http://localhost:8080/phpmyadmin/${NC}"
+        open http://localhost:8080/phpmyadmin/
+        echo ""
+        echo -e "${YELLOW}To stop Apache: acadex phpmyadmin:stop${NC}"
+        ;;
+    phpmyadmin:stop)
+        echo -e "${GREEN}Stopping Apache...${NC}"
+        sudo /Applications/XAMPP/xamppfiles/bin/apachectl stop
+        echo -e "${GREEN}✓ Apache stopped${NC}"
+        ;;
+    docs)
+        echo -e "${GREEN}Opening ACADEX documentation...${NC}"
+        open "https://xaviworks.github.io/AcadexV3/"
+        ;;
+    help|--help|-h|"")
+        show_help
+        ;;
+    *)
+        echo -e "${RED}Unknown command: $1${NC}"
+        echo ""
+        show_help
+        exit 1
+        ;;
+esac

package/acadex.ps1

@@ -0,0 +1,594 @@
+<#
+.SYNOPSIS
+    ACADEX - Custom command wrapper for AcadexV3 (Windows PowerShell)
+.DESCRIPTION
+    Usage: acadex <command> [arguments]
+#>
+
+param(
+    [Parameter(Position=0)]
+    [string]$Command,
+    
+    [Parameter(Position=1, ValueFromRemainingArguments=$true)]
+    [string[]]$Arguments
+)
+
+# Project root directory
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+Set-Location $ScriptDir
+
+# Display help
+function Show-Help {
+    Write-Host "===========================================================" -ForegroundColor Cyan
+    Write-Host "                 ACADEX - AcadexV3 Commands                " -ForegroundColor Green
+    Write-Host "===========================================================" -ForegroundColor Cyan
+    Write-Host ""
+    Write-Host "Usage: acadex <command> [arguments]" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "Available Commands:" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "  Setup and Installation:" -ForegroundColor Cyan
+    Write-Host "  setup           " -ForegroundColor Green -NoNewline
+    Write-Host "First-time full installation"
+    Write-Host "  install:2fa     " -ForegroundColor Green -NoNewline
+    Write-Host "Install 2FA packages (existing install)"
+    Write-Host "  install:notif   " -ForegroundColor Green -NoNewline
+    Write-Host "Install notification feature packages"
+    Write-Host "  check           " -ForegroundColor Green -NoNewline
+    Write-Host "Check system requirements"
+    Write-Host ""
+    Write-Host "  Development:" -ForegroundColor Cyan
+    Write-Host "  serve           " -ForegroundColor Green -NoNewline
+    Write-Host "Start production servers (Laravel + Queue + Scheduler + Reverb)"
+    Write-Host "  services        " -ForegroundColor Green -NoNewline
+    Write-Host "Start background services only (for Herd/Laragon)"
+    Write-Host "  dev             " -ForegroundColor Green -NoNewline
+    Write-Host "Start dev servers (Laravel + Queue + Logs + Vite + Reverb)"
+    Write-Host "  build           " -ForegroundColor Green -NoNewline
+    Write-Host "Build assets for production (npm run build)"
+    Write-Host "  ui              " -ForegroundColor Green -NoNewline
+    Write-Host "Rebuild UI assets and clear caches"
+    Write-Host "  start           " -ForegroundColor Green -NoNewline
+    Write-Host "Start Laravel server only"
+    Write-Host ""
+    Write-Host "  Testing:" -ForegroundColor Cyan
+    Write-Host "  test            " -ForegroundColor Green -NoNewline
+    Write-Host "Run PHPUnit tests"
+    Write-Host "  test:coverage   " -ForegroundColor Green -NoNewline
+    Write-Host "Run tests with coverage"
+    Write-Host ""
+    Write-Host "  Database:" -ForegroundColor Cyan
+    Write-Host "  migrate         " -ForegroundColor Green -NoNewline
+    Write-Host "Run database migrations"
+    Write-Host "  migrate:fresh   " -ForegroundColor Green -NoNewline
+    Write-Host "Fresh migration with seeders"
+    Write-Host "  seed            " -ForegroundColor Green -NoNewline
+    Write-Host "Run database seeders"
+    Write-Host "  tinker          " -ForegroundColor Green -NoNewline
+    Write-Host "Start Laravel Tinker"
+    Write-Host ""
+    Write-Host "  Maintenance:" -ForegroundColor Cyan
+    Write-Host "  cache:clear     " -ForegroundColor Green -NoNewline
+    Write-Host "Clear all caches"
+    Write-Host "  optimize        " -ForegroundColor Green -NoNewline
+    Write-Host "Optimize the application"
+    Write-Host "  logs            " -ForegroundColor Green -NoNewline
+    Write-Host "Tail Laravel logs"
+    Write-Host ""
+    Write-Host "  Code Quality:" -ForegroundColor Cyan
+    Write-Host "  analyze         " -ForegroundColor Green -NoNewline
+    Write-Host "Run PHPStan static analysis"
+    Write-Host "  format          " -ForegroundColor Green -NoNewline
+    Write-Host "Format code with Pint"
+    Write-Host ""
+    Write-Host "  Dependencies:" -ForegroundColor Cyan
+    Write-Host "  install         " -ForegroundColor Green -NoNewline
+    Write-Host "Install all dependencies"
+    Write-Host "  update          " -ForegroundColor Green -NoNewline
+    Write-Host "Update all dependencies"
+    Write-Host ""
+    Write-Host "  Other:" -ForegroundColor Cyan
+    Write-Host "  routes          " -ForegroundColor Green -NoNewline
+    Write-Host "List all routes"
+    Write-Host "  queue           " -ForegroundColor Green -NoNewline
+    Write-Host "Start queue worker"
+    Write-Host "  schedule        " -ForegroundColor Green -NoNewline
+    Write-Host "Run scheduled tasks"    Write-Host "  share           " -ForegroundColor Green -NoNewline
+    Write-Host "Share site publicly via Expose"    Write-Host "  phpmyadmin      " -ForegroundColor Green -NoNewline
+    Write-Host "Start Apache & open phpMyAdmin (Windows)"
+    Write-Host "  phpmyadmin:stop " -ForegroundColor Green -NoNewline
+    Write-Host "Stop Apache (Windows)"
+    Write-Host "  docs            " -ForegroundColor Green -NoNewline
+    Write-Host "Open ACADEX documentation"
+    Write-Host ""
+    Write-Host "Examples:" -ForegroundColor Yellow
+    Write-Host "  acadex setup          # First-time installation"
+    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"
+    Write-Host "  acadex test           # Run tests"
+    Write-Host "  acadex migrate:fresh  # Reset database"
+    Write-Host ""
+}
+
+# Check if a command exists
+function Test-CommandExists {
+    param([string]$Cmd)
+    $null -ne (Get-Command $Cmd -ErrorAction SilentlyContinue)
+}
+
+# Command handlers
+switch ($Command) {
+    "setup" {
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "            ACADEX - First Time Installation              " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        
+        # Step 1: Check requirements
+        Write-Host "[1/9] Checking requirements..." -ForegroundColor Yellow
+        
+        # Check PHP
+        if (Test-CommandExists "php") {
+            $phpVersion = php -r "echo PHP_MAJOR_VERSION.'.'.PHP_MINOR_VERSION;"
+            Write-Host "  [OK] PHP $phpVersion found" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] PHP not found. Please install PHP 8.2+" -ForegroundColor Red
+            exit 1
+        }
+        
+        # Check Composer
+        if (Test-CommandExists "composer") {
+            Write-Host "  [OK] Composer found" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] Composer not found. Please install Composer" -ForegroundColor Red
+            exit 1
+        }
+        
+        # Check Node
+        if (Test-CommandExists "node") {
+            $nodeVersion = node -v
+            Write-Host "  [OK] Node.js $nodeVersion found" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] Node.js not found. Please install Node.js" -ForegroundColor Red
+            exit 1
+        }
+        
+        # Check npm
+        if (Test-CommandExists "npm") {
+            Write-Host "  [OK] npm found" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] npm not found. Please install npm" -ForegroundColor Red
+            exit 1
+        }
+        
+        Write-Host ""
+        
+        # Step 2: Copy .env
+        Write-Host "[2/9] Setting up environment file..." -ForegroundColor Yellow
+        if (!(Test-Path ".env")) {
+            if (Test-Path ".env.example") {
+                Copy-Item ".env.example" ".env"
+                Write-Host "  [OK] Created .env from .env.example" -ForegroundColor Green
+            } else {
+                Write-Host "  [X] .env.example not found!" -ForegroundColor Red
+                exit 1
+            }
+        } else {
+            Write-Host "  [OK] .env already exists" -ForegroundColor Green
+        }
+        Write-Host ""
+        
+        # Step 3: Install Composer dependencies
+        Write-Host "[3/9] Installing Composer dependencies..." -ForegroundColor Yellow
+        Write-Host "  -> This includes: Laravel, Excel, 2FA, Socialite, notifications, etc." -ForegroundColor Cyan
+        composer install --no-interaction
+        if ($LASTEXITCODE -eq 0) {
+            Write-Host "  [OK] Composer dependencies installed" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] Composer install failed!" -ForegroundColor Red
+            exit 1
+        }
+        Write-Host ""
+        
+        # Step 4: Install npm dependencies
+        Write-Host "[4/9] Installing npm dependencies..." -ForegroundColor Yellow
+        npm install
+        if ($LASTEXITCODE -eq 0) {
+            Write-Host "  [OK] npm dependencies installed" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] npm install failed!" -ForegroundColor Red
+            exit 1
+        }
+        Write-Host "  -> Installing notification features..." -ForegroundColor Cyan
+        npm install @alpinejs/intersect --save
+        if ($LASTEXITCODE -eq 0) {
+            Write-Host "  [OK] Notification packages installed" -ForegroundColor Green
+        }
+        Write-Host ""
+        
+        # Step 5: Generate app key
+        Write-Host "[5/9] Generating application key..." -ForegroundColor Yellow
+        $envContent = Get-Content ".env" -Raw
+        if ($envContent -match "APP_KEY=base64:") {
+            Write-Host "  [OK] APP_KEY already set" -ForegroundColor Green
+        } else {
+            php artisan key:generate --ansi
+            Write-Host "  [OK] APP_KEY generated" -ForegroundColor Green
+        }
+        Write-Host ""
+        
+        # Step 6: Database setup prompt
+        Write-Host "[6/9] Database configuration..." -ForegroundColor Yellow
+        Write-Host "  -> Please configure your database in .env file" -ForegroundColor Cyan
+        Write-Host "  -> DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD" -ForegroundColor Cyan
+        Write-Host ""
+        $dbConfigured = Read-Host "  Have you configured the database? (y/n)"
+        if ($dbConfigured -ne "y" -and $dbConfigured -ne "Y") {
+            Write-Host "  [!] Please configure the database in .env and run: acadex migrate" -ForegroundColor Yellow
+            Write-Host ""
+        } else {
+            # Step 7: Run migrations
+            Write-Host ""
+            Write-Host "[7/9] Running database migrations..." -ForegroundColor Yellow
+            php artisan migrate --force
+            if ($LASTEXITCODE -eq 0) {
+                Write-Host "  [OK] Migrations completed" -ForegroundColor Green
+            } else {
+                Write-Host "  [X] Migration failed! Check your database configuration." -ForegroundColor Red
+            }
+            Write-Host ""
+            
+            # Seeding prompt
+            $runSeeders = Read-Host "  Run database seeders? (y/n)"
+            if ($runSeeders -eq "y" -or $runSeeders -eq "Y") {
+                php artisan db:seed --force
+                Write-Host "  [OK] Database seeded" -ForegroundColor Green
+            }
+        }
+        Write-Host ""
+        
+        # Step 8: Build assets
+        Write-Host "[8/9] Building frontend assets..." -ForegroundColor Yellow
+        npm run build
+        if ($LASTEXITCODE -eq 0) {
+            Write-Host "  [OK] Assets built" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] Build failed!" -ForegroundColor Red
+        }
+        Write-Host ""
+        
+        # Step 9: Optimize
+        Write-Host "[9/9] Optimizing application..." -ForegroundColor Yellow
+        php artisan config:cache
+        php artisan route:cache
+        php artisan view:cache
+        Write-Host "  [OK] Application optimized" -ForegroundColor Green
+        Write-Host ""
+        
+        # Done!
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "              Installation Complete!                       " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        Write-Host "Next steps:" -ForegroundColor Yellow
+        Write-Host "  1. Configure your .env file (database, mail, etc.)"
+        Write-Host "  2. Run 'acadex dev' to start development servers" -ForegroundColor Green
+        Write-Host "  3. Visit http://localhost:8000" -ForegroundColor Cyan
+        Write-Host ""
+    }
+    
+    "install:2fa" {
+        Write-Host "Installing 2FA packages..." -ForegroundColor Green
+        Write-Host ""
+        composer require pragmarx/google2fa-laravel bacon/bacon-qr-code
+        if ($LASTEXITCODE -eq 0) {
+            Write-Host ""
+            Write-Host "[OK] 2FA packages installed successfully!" -ForegroundColor Green
+            Write-Host "  - pragmarx/google2fa-laravel"
+            Write-Host "  - bacon/bacon-qr-code"
+        } else {
+            Write-Host "[X] Installation failed!" -ForegroundColor Red
+            exit 1
+        }
+    }
+    
+    "install:notif" {
+        Write-Host "Installing notification feature packages..." -ForegroundColor Green
+        Write-Host ""
+        npm install @alpinejs/intersect --save
+        if ($LASTEXITCODE -eq 0) {
+            Write-Host ""
+            Write-Host "[OK] Notification packages installed successfully!" -ForegroundColor Green
+            Write-Host "  - @alpinejs/intersect"
+        } else {
+            Write-Host "[X] Installation failed!" -ForegroundColor Red
+            exit 1
+        }
+    }
+    
+    "check" {
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host "              ACADEX - System Requirements                " -ForegroundColor Green
+        Write-Host "===========================================================" -ForegroundColor Cyan
+        Write-Host ""
+        
+        # PHP
+        Write-Host "PHP:" -ForegroundColor Yellow
+        if (Test-CommandExists "php") {
+            $phpVersion = php -v | Select-Object -First 1
+            Write-Host "  [OK] $phpVersion" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] PHP not found (required: 8.2+)" -ForegroundColor Red
+        }
+        
+        # Composer
+        Write-Host "Composer:" -ForegroundColor Yellow
+        if (Test-CommandExists "composer") {
+            $composerVersion = composer --version
+            Write-Host "  [OK] $composerVersion" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] Composer not found" -ForegroundColor Red
+        }
+        
+        # Node.js
+        Write-Host "Node.js:" -ForegroundColor Yellow
+        if (Test-CommandExists "node") {
+            $nodeVersion = node -v
+            Write-Host "  [OK] Node.js $nodeVersion" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] Node.js not found" -ForegroundColor Red
+        }
+        
+        # npm
+        Write-Host "npm:" -ForegroundColor Yellow
+        if (Test-CommandExists "npm") {
+            $npmVersion = npm -v
+            Write-Host "  [OK] npm $npmVersion" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] npm not found" -ForegroundColor Red
+        }
+        
+        # Git
+        Write-Host "Git:" -ForegroundColor Yellow
+        if (Test-CommandExists "git") {
+            $gitVersion = git --version
+            Write-Host "  [OK] $gitVersion" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] Git not found" -ForegroundColor Red
+        }
+        
+        Write-Host ""
+        
+        # Project status
+        Write-Host "Project Status:" -ForegroundColor Yellow
+        
+        if (Test-Path ".env") {
+            Write-Host "  [OK] .env file exists" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] .env file missing" -ForegroundColor Red
+        }
+        
+        if (Test-Path "vendor") {
+            Write-Host "  [OK] Composer dependencies installed" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] Composer dependencies not installed" -ForegroundColor Red
+        }
+        
+        if (Test-Path "node_modules") {
+            Write-Host "  [OK] npm dependencies installed" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] npm dependencies not installed" -ForegroundColor Red
+        }
+        
+        if (Test-Path "public/build") {
+            Write-Host "  [OK] Assets built" -ForegroundColor Green
+        } else {
+            Write-Host "  [X] Assets not built (run: acadex build)" -ForegroundColor Red
+        }
+        
+        Write-Host ""
+    }
+    
+    "serve" {
+        Write-Host "Starting production servers (Laravel + Queue + Scheduler)..." -ForegroundColor Green
+        npx concurrently -c "#93c5fd,#c4b5fd,#4ade80" "php artisan serve" "php artisan queue:work --tries=3 --timeout=90" "php artisan schedule:work" --names=server,queue,scheduler
+    }
+    
+    "dev" {
+        Write-Host "Starting development servers (Laravel + Queue + Logs + Vite + Reverb)..." -ForegroundColor Green
+        npx concurrently -c "#93c5fd,#c4b5fd,#fb7185,#fdba74,#fbbf24" "php artisan serve" "php artisan queue:work --tries=3 --timeout=90" "php artisan pail --timeout=0" "npm run dev" "php artisan reverb:start" --names=server,queue,logs,vite,reverb
+    }
+    
+    "build" {
+        Write-Host "Building assets for production..." -ForegroundColor Green
+        npm run build
+    }
+    
+    "ui" {
+        Write-Host "Rebuilding UI and clearing caches..." -ForegroundColor Green
+        Write-Host "  -> Building frontend assets..." -ForegroundColor Cyan
+        npm run build
+        Write-Host "  -> Clearing all caches..." -ForegroundColor Cyan
+        php artisan optimize:clear
+        Write-Host "[OK] UI refreshed! Hard refresh your browser (Ctrl+Shift+R or Cmd+Shift+R)" -ForegroundColor Green
+    }
+    
+    "start" {
+        Write-Host "Starting Laravel server only..." -ForegroundColor Green
+        php artisan serve
+    }
+    
+    "test" {
+        Write-Host "Running tests..." -ForegroundColor Green
+        if ($Arguments) {
+            php artisan test @Arguments
+        } else {
+            php artisan test
+        }
+    }
+    
+    "test:coverage" {
+        Write-Host "Running tests with coverage..." -ForegroundColor Green
+        if ($Arguments) {
+            php artisan test --coverage @Arguments
+        } else {
+            php artisan test --coverage
+        }
+    }
+    
+    "migrate" {
+        Write-Host "Running migrations..." -ForegroundColor Green
+        if ($Arguments) {
+            php artisan migrate @Arguments
+        } else {
+            php artisan migrate
+        }
+    }
+    
+    "migrate:fresh" {
+        Write-Host "Running fresh migration with seeders..." -ForegroundColor Yellow
+        if ($Arguments) {
+            php artisan migrate:fresh --seed @Arguments
+        } else {
+            php artisan migrate:fresh --seed
+        }
+    }
+    
+    "seed" {
+        Write-Host "Running seeders..." -ForegroundColor Green
+        if ($Arguments) {
+            php artisan db:seed @Arguments
+        } else {
+            php artisan db:seed
+        }
+    }
+    
+    "tinker" {
+        Write-Host "Starting Tinker..." -ForegroundColor Green
+        php artisan tinker
+    }
+    
+    "cache:clear" {
+        Write-Host "Clearing all caches..." -ForegroundColor Green
+        php artisan config:clear
+        php artisan cache:clear
+        php artisan route:clear
+        php artisan view:clear
+        Write-Host "All caches cleared!" -ForegroundColor Green
+    }
+    
+    "optimize" {
+        Write-Host "Optimizing application..." -ForegroundColor Green
+        php artisan optimize
+    }
+    
+    "logs" {
+        Write-Host "Tailing Laravel logs..." -ForegroundColor Green
+        Get-Content "storage/logs/laravel.log" -Wait -Tail 50
+    }
+    
+    "analyze" {
+        Write-Host "Running PHPStan analysis..." -ForegroundColor Green
+        if ($Arguments) {
+            & ./vendor/bin/phpstan analyse @Arguments
+        } else {
+            & ./vendor/bin/phpstan analyse
+        }
+    }
+    
+    "format" {
+        Write-Host "Formatting code with Pint..." -ForegroundColor Green
+        if ($Arguments) {
+            & ./vendor/bin/pint @Arguments
+        } else {
+            & ./vendor/bin/pint
+        }
+    }
+    
+    "install" {
+        Write-Host "Installing dependencies..." -ForegroundColor Green
+        composer install
+        npm install
+        Write-Host "  -> Installing notification features..." -ForegroundColor Cyan
+        npm install @alpinejs/intersect --save
+        Write-Host "Dependencies installed!" -ForegroundColor Green
+    }
+    
+    "update" {
+        Write-Host "Updating dependencies..." -ForegroundColor Green
+        composer update
+        npm update
+        Write-Host "Dependencies updated!" -ForegroundColor Green
+    }
+    
+    "routes" {
+        Write-Host "Listing routes..." -ForegroundColor Green
+        if ($Arguments) {
+            php artisan route:list @Arguments
+        } else {
+            php artisan route:list
+        }
+    }
+    
+    "queue" {
+        Write-Host "Starting queue worker..." -ForegroundColor Green
+        if ($Arguments) {
+            php artisan queue:work @Arguments
+        } else {
+            php artisan queue:work
+        }
+    }
+    
+    "schedule" {
+        Write-Host "Running scheduled tasks..." -ForegroundColor Green
+        php artisan schedule:run
+    }
+    
+    "share" {
+        Write-Host "Sharing site via Expose..." -ForegroundColor Green
+        Write-Host "Public URL will be displayed below" -ForegroundColor Yellow
+        Write-Host "Press Ctrl+C to stop sharing" -ForegroundColor Yellow
+        Write-Host ""
+        expose share http://localhost:8000
+    }
+    
+    "phpmyadmin" {
+        Write-Host "Starting Apache & opening phpMyAdmin..." -ForegroundColor Green
+        # Adjust path for your XAMPP/Laragon installation
+        $apachePath = "C:\xampp\apache\bin\httpd.exe"
+        if (Test-Path $apachePath) {
+            Start-Process $apachePath -WindowStyle Hidden
+            Write-Host "[OK] Apache started" -ForegroundColor Green
+            Write-Host "Opening http://localhost/phpmyadmin/" -ForegroundColor Yellow
+            Start-Process "http://localhost/phpmyadmin/"
+            Write-Host ""
+            Write-Host "To stop Apache: acadex phpmyadmin:stop" -ForegroundColor Yellow
+        } else {
+            Write-Host "[X] Apache not found at $apachePath" -ForegroundColor Red
+            Write-Host "Please adjust the path in acadex.ps1" -ForegroundColor Yellow
+        }
+    }
+    
+    "phpmyadmin:stop" {
+        Write-Host "Stopping Apache..." -ForegroundColor Green
+        Stop-Process -Name "httpd" -Force -ErrorAction SilentlyContinue
+        Write-Host "[OK] Apache stopped" -ForegroundColor Green
+    }
+    
+    "docs" {
+        Write-Host "Opening ACADEX documentation..." -ForegroundColor Green
+        Start-Process "https://xaviworks.github.io/AcadexV3/"
+    }
+    
+    { $_ -in @("help", "--help", "-h", "", $null) } {
+        Show-Help
+    }
+    
+    default {
+        Write-Host "Unknown command: $Command" -ForegroundColor Red
+        Write-Host ""
+        Show-Help
+        exit 1
+    }
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "acadex-cli",
+  "version": "1.0.0",
+  "description": "A global CLI tool for managing Acadex projects with easy setup and automation",
+  "main": "acadex",
+  "bin": {
+    "acadex": "./acadex"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "acadex",
+    "cli",
+    "laravel",
+    "automation",
+    "development"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "preferGlobal": true,
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
+}
+