v1.5.0
NebulaCMS v1.5.0
Release type: minor
Focus: Headless API, plugin routing, admin navigation, plugin page loading, improved plugin page resolution, and public docs submodule
Release commit: 9092ddab87292a4d0e0a5a26f66b2af94717754d
Summary
This release introduces the first Headless API layer for NebulaCMS, covering pages, categories, tags, menus, and settings through dedicated API controllers and resources. It also expands the plugin system with plugin routing, admin navigation, and dynamic plugin page loading for Inertia-based admin pages.
On top of that, plugin frontend page resolution has been improved with safer lookup logic and clearer error handling. Documentation assets have also been reorganized to use a public docs submodule.
Added
- Headless API: Added API endpoints and resources for pages, categories, tags, menus, and settings.
- API test coverage: Added
HeadlessApiTestto cover the new headless endpoints. - Plugin routing: Added support for plugin-defined route configuration such as prefix, name prefix, and middleware.
- Plugin admin navigation: Added support for loading admin sidebar navigation items from plugin configuration.
- Plugin page loading: Added dynamic Inertia page resolution for plugin-provided admin pages.
- Plugin hooks: Added filter hook support for plugin route configuration and admin navigation items.
- TypeScript coverage: Extended TypeScript configuration and shared types to support plugin source files and plugin navigation data.
Changed
- Inertia page resolver: Refactored frontend page resolution to support both core and plugin pages.
- Plugin error handling: Improved plugin page lookup logic with safer checks and clearer errors when a page cannot be found.
- Admin sidebar integration: Updated sidebar and navigation components to render plugin-provided admin menu items.
- Documentation structure: Switched public docs to a Git submodule-based workflow.
Upgrade notes
- Database: No new migrations are introduced in this release.
- Plugin compatibility: If you maintain custom plugins, you can now define route config, admin navigation, and plugin admin pages; verify custom plugin pages resolve correctly after upgrading.
- Docs checkout: If you work from source and need the docs locally, run
git submodule update --init --recursive. - Reported version: If NebulaCMS displays an application version in Settings → System, bump it to 1.5.0 before or together with the release tag.
Full changelog
https://github.com/AngkasaLab/NebulaCMS/compare/v1.4.0...v1.5.0