Understand how the Hub isolates module failures and auto-activates safe mode after repeated crashes.
Each module boots in its own try-catch boundary. If a module throws during boot(), the Hub catches the exception, logs it, and continues booting other modules. The admin is never locked out.
After 3 consecutive boot failures, the Hub automatically disables the module and activates safe mode. The module won't boot again until an admin manually re-enables it via WP-CLI or the admin panel.
# Check module health
wp meteorack modules health my-module
# Re-enable after safe mode
wp meteorack modules enable my-module --force
# View crash log
wp meteorack modules log my-module --last=5React admin pages are wrapped in error boundaries. If your React app crashes, the boundary catches it and shows a recovery UI — the rest of wp-admin continues working normally.
// The Hub wraps your admin page automatically:
<ModuleErrorBoundary slug="my-module">
<YourAdminApp />
</ModuleErrorBoundary>
// You can also use it in your own components:
import { ModuleErrorBoundary } from '@meteorack/sdk/components';
function MyPage() {
return (
<ModuleErrorBoundary slug="my-module" fallback={<p>Something broke.</p>}>
<RiskyWidget />
</ModuleErrorBoundary>
);
}