d523f0f600
Document application modes (development/debug/production) Add global file drop handler, order column normalization, SPA hash fix Serve CDN assets via /_vendor/ URLs instead of merging into bundles Add production minification with license preservation Improve JSON formatting for debugging and production optimization Add CDN asset caching with CSS URL inlining for production builds Add three-mode system (development, debug, production) Update Manifest CLAUDE.md to reflect helper class architecture Refactor Manifest.php into helper classes for better organization Pre-manifest-refactor checkpoint: Add app_mode documentation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
67 lines
1.8 KiB
Plaintext
Executable File
67 lines
1.8 KiB
Plaintext
Executable File
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
|