PHPackages warete/moonshine-upgrade - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. warete/moonshine-upgrade ActiveLibrary warete/moonshine-upgrade ======================== Package for upgrade MoonShine 1.0.7(5mo ago)12994↓34.6%1[1 issues](https://github.com/warete/moonshine-upgrade/issues)MITPHPPHP ^8.2CI passing Since Nov 7Pushed 5mo ago1 watchersCompare [ Source](https://github.com/warete/moonshine-upgrade)[ Packagist](https://packagist.org/packages/warete/moonshine-upgrade)[ Docs](https://getmoonshine.app)[ RSS](/packages/warete-moonshine-upgrade/feed)WikiDiscussions 1.x Synced 1mo ago READMEChangelog (8)Dependencies (5)Versions (17)Used By (0) Moonshine upgrade ================= [](#moonshine-upgrade) A small package that helps automate migration of a MoonShine application to a newer major version. It runs automated code transformations and configuration updates to prepare your codebase for an upgrade. Use the `--dry-run` option to preview changes before they are applied. Compatibility ------------- [](#compatibility) MoonShinemoonshine-upgradeCurrently supported>= 3.01.\*yes### Platform Support [](#platform-support) This package is tested and works on: - ✅ Linux/macOS - ✅ Windows (with limitations) **Windows Users**: For the best experience, we recommend using **WSL (Windows Subsystem for Linux)**. The package should work on native Windows, but we cannot guarantee 100% compatibility due to external dependencies (Rector and PHPActor) that may have Windows-specific quirks. If you encounter issues on Windows without WSL, please report them. Install ------- [](#install) **Make this before upgrade moonshine version in `composer.json`:** 1. `composer require --dev warete/moonshine-upgrade` 2. `php artisan vendor:publish --provider="Warete\MoonshineUpgrade\Providers\MoonshineUpgradeServiceProvider"` 3. `php artisan moonshine:upgrade `. By default will used last available version. 4. Then upgrade moonshine version in `composer.json` and run `composer update`! You can specify directory to upgrade by `--dir` option. For example: `php artisan moonshine:upgrade --dir=app/MoonShine/Resources`. > **Warning** > > The script performs automated edits to your codebase — files will be changed, and some files may be moved, renamed or removed by the upgrade process. Always make a backup (or use VCS) before running the upgrade. You can use the command option `--dry-run` to preview changes without writing files. > > Use the `-v` flag to see which files were modified and view their diffs. The upgrade command can be run multiple times — it will update only the outdated files. > **Note — manual follow-up required** > > Deprecated methods, classes and class properties will receive an automatically added PHPDoc containing an `@deprecated` tag and a short guidance on what needs to be changed manually. After running the automated upgrade you must review all members marked with `@deprecated` and apply the instructions in those comments — automated refactoring cannot safely handle all cases and skipping this step may cause your application to behave unexpectedly. Supported versions to upgrade ----------------------------- [](#supported-versions-to-upgrade) - 4.\* — current MoonShine major version supported. - Method signatures, namespaces, classes, interfaces, traits, properties and attributes changed. - Resources and their pages will be adapted to the new structure. - The `config/moonshine.php` configuration will be updated to support the latest features. Testing ------- [](#testing) This package includes two types of tests: ### Unit Tests (No MoonShine required) ✅ [](#unit-tests-no-moonshine-required-) Run lightweight tests that validate Rector rules and fixtures without requiring a full MoonShine installation: ``` composer test:unit # or composer test:v4 ``` These tests will always pass in CI/CD and during package development. ### Full E2E Tests (Requires MoonShine) [](#full-e2e-tests-requires-moonshine) To run the complete test suite including end-to-end upgrade tests: 1. Install MoonShine manually: `composer require moonshine/moonshine:^4.0 --dev` 2. Run all tests: `composer test:all` **Note**: MoonShine is intentionally not in `require-dev` to avoid version conflicts when this package is used within MoonShine applications. The E2E tests are primarily for development and validation in isolated environments. ### Health Score 43 — FairBetter than 91% of packages Maintenance68 Regular maintenance activity Popularity27 Limited adoption so far Community10 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor1 Top contributor holds 98.5% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~2 days Total 9 Last Release 177d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/3f24b1e0b67f6d685f7f478537d2e6ed7e8f18038e25b700778ba2fefddea7f3?d=identicon)[warete](/maintainers/warete) --- Top Contributors [![warete](https://avatars.githubusercontent.com/u/12802923?v=4)](https://github.com/warete "warete (64 commits)")[![shevl-dev](https://avatars.githubusercontent.com/u/118539450?v=4)](https://github.com/shevl-dev "shevl-dev (1 commits)") --- Tags upgrademoonshine ### Code Quality TestsPHPUnit Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/warete-moonshine-upgrade/health.svg) ``` [![Health](https://phpackages.com/badges/warete-moonshine-upgrade/health.svg)](https://phpackages.com/packages/warete-moonshine-upgrade) ``` ### Alternatives [moonshine/moonshine Laravel administration panel 1.3k217.1k59](/packages/moonshine-moonshine)[ssch/typo3-rector Instant fixes for your TYPO3 PHP code by using Rector. 2592.8M263](/packages/ssch-typo3-rector)[shalvah/upgrader Create automatic upgrades for your package. 1510.9M6](/packages/shalvah-upgrader)[sulu/sulu-rector Rector upgrades rules for Sulu CMS 17334.8k11](/packages/sulu-sulu-rector)[mwguerra/interactive-upgrader A CLI tool that handles both Composer and npm dependencies for Laravel projects. 1913.7k](/packages/mwguerra-interactive-upgrader)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 245.2k](/packages/aedart-athenaeum) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)