APPLICATION MODE SYSTEM - MIGRATION GUIDE
Date: 2026-01-14

SUMMARY
    The framework now supports three execution modes: development, debug,
    and production. A new RSX_MODE environment variable controls mode
    behavior. Production mode requires pre-built assets and includes
    optimizations like minification, JS/CSS merging, and CDN bundling.

AFFECTED FILES
    - .env (add RSX_MODE)
    - .gitignore (add /rsx-export/)

CHANGES REQUIRED

    1. Add RSX_MODE to .env

       Add to your .env file:

           RSX_MODE=development

       Valid values: development, debug, production

    2. Add Export Directory to .gitignore

       Add to your .gitignore:

           /rsx-export/

       This directory is created by rsx:prod:export and should not be
       committed to version control.

    3. Update Deployment Process

       If you deploy manually, update your process to use:

           php artisan rsx:prod:export

       This creates a deployment-ready copy in ./rsx-export/ with all
       production optimizations applied.

NEW COMMANDS

    rsx:mode:set <mode>
        Change application mode. Updates .env, clears artifacts, and
        rebuilds as appropriate for the new mode.

        php artisan rsx:mode:set production
        php artisan rsx:mode:set development

    rsx:prod:build
        Build all production assets (minified, merged, CDN cached).

    rsx:prod:export
        Export application for deployment to ./rsx-export/

VERIFICATION
    1. Add RSX_MODE=development to .env
    2. Run: php artisan rsx:mode:set production
    3. Verify ./rsx-export/ is NOT created (that requires rsx:prod:export)
    4. Verify site loads with production optimizations
    5. Run: php artisan rsx:mode:set development
    6. Verify automatic rebuilding resumes

REFERENCE
    php artisan rsx:man app_mode