v1.7.0
NebulaCMS v1.7.0
Release type: minor
Focus: Pre-built Inertia.js plugin support for shared hosting
Release commit: 107ee2c
Summary
This minor release introduces first-class support for pre-built Inertia.js frontend plugins in NebulaCMS. Plugin authors can now ship compiled frontend assets directly inside their plugin packages, allowing React/Inertia-based admin plugins to work in environments without terminal or SSH access, including shared hosting.
This release also adds an official starter plugin that demonstrates the recommended structure for building shared-hosting-compatible prebuilt Inertia admin plugins.
Added
- Pre-built Inertia Plugin Runtime: Added a runtime host and frontend shims for React, JSX runtime, and Inertia React so prebuilt plugin bundles can register pages dynamically at runtime.
- Dynamic Plugin Asset Resolution: Added
PluginFrontendAssetRegistryto resolve plugin frontend assets from each plugin's owndist/manifest.json. - Dedicated Plugin Asset Route: Added a secure route for serving compiled plugin frontend assets directly from plugin
distdirectories. - Plugin Frontend Manifest Support: Extended the
Pluginmodel with helpers to read frontend metadata, manifests, and entrypoints fromplugin.json. - Prebuilt Manifest Validation: Updated plugin requirement checks to validate frontend manifest requirements before plugin activation.
- Official Starter Plugin: Added
starter-inertia-prebuiltas a built-in reference plugin for creating shared-hosting-friendly Inertia admin plugins. - Automated Test Coverage: Added test coverage for plugin manifest parsing, asset resolution, asset serving, starter plugin compatibility, and prebuilt frontend validation.
Changed
- Blade App Shell: Updated the main Blade template to load plugin frontend assets based on the active Inertia page component instead of depending on the global Vite manifest alone.
- Inertia Page Resolution: Updated frontend page resolution so plugin pages can be loaded from the plugin runtime registry instead of source-based Vite discovery.
- Versioning: Bumped the internal NebulaCMS version to
1.7.0.
Upgrade notes
- Assets: Rebuild core frontend assets after pulling this release by running
npm run build. - Plugins: React/Inertia-based plugins should now ship their own compiled
dist/manifest.jsonand frontend asset files. - Starter Plugin: Use
plugins/starter-inertia-prebuiltas the reference template for new prebuilt admin plugins. - Database: No database migrations are introduced in this release.
Full Changelog: https://github.com/AngkasaLab/NebulaCMS/compare/v1.6.3...v1.7.0