Hero is an Available, No schema impact Capell package in the Capell Foundation product group. It ships as capell-app/hero and extends these surfaces: admin, frontend, console.
Hero adds a Layout Builder hero widget with page copy, actions, responsive images or video, multiple slides, and inherited theme background options.
Editors configure the hero through Layout Builder and theme or widget background fields, while visitors receive the responsive hero rendered by the active theme.
Status details:
- Status: Available
- Tier: free
- Bundle: foundation
- Composer package:
capell-app/hero - Namespace:
Capell\Hero - Theme key: not applicable
For developers: Prepared Data objects and resolution Actions keep media and background decisions outside Blade, and tests enforce query-free public rendering without editor metadata.
For teams: Teams can establish reusable home-page defaults and still change copy, media, slides, and background treatment per widget without replacing unrelated page content.
Screenshot contract: docs/screenshots.json.
- Insights consent priming capture (frontend, supplementary evidence).
- Hero home widget rendered on a public page (frontend, required evidence).
Capell\Hero\Providers\HeroServiceProvider
HeroBackgroundSchemaHeroBackgroundThemeSchemaExtenderHeroBackgroundWidgetAssetSchemaExtenderHeroBackgroundWidgetSchemaExtender
InstallHeroLayoutDefaultsActionResolveHeroBackgroundDataActionResolveHeroMediaDataAction
HeroAssetSlideDataHeroBackgroundDataHeroMediaDataHeroWidgetRenderData
capell:hero-setup
SetupCommand
Capell\Hero\Health\HeroHealthCheck
packages/hero/resources/views/components/hero/background.blade.phppackages/hero/resources/views/components/hero/content.blade.phppackages/hero/resources/views/components/hero/media.blade.phppackages/hero/resources/views/components/hero/related.blade.phppackages/hero/resources/views/components/hero/slide.blade.phppackages/hero/resources/views/components/hero/wrapper.blade.phppackages/hero/resources/views/components/widget/default.blade.phppackages/hero/resources/views/components/widget/hero.blade.php
hero
This package has no schema impact. It registers runtime behaviour through Capell\Hero\Providers\HeroServiceProvider while persistence remains with Capell core or required packages.
- Required packages:
capell-app/admin,capell-app/core,capell-app/frontend,capell-app/layout-builder. - Admin navigation: no admin page or resource contribution is declared.
- Admin/editor extensions: none declared.
- Permissions: no package permission declarations or Shield gates detected; host access rules still apply.
- Public routes: none declared.
- Database changes: no package migrations declared.
- Config: no package config files.
- Settings: no package settings declared.
- Queues or schedules: none declared.
- Cache tags:
hero. - Commands:
capell:hero-setup.
- Keep required Capell packages on compatible v4 releases:
capell-app/admin,capell-app/core,capell-app/frontend,capell-app/layout-builder. - Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries.
- Custom write integrations must preserve invalidation for
herocache tags.
| Symptom | Likely cause | Check | Fix |
|---|---|---|---|
| Package surface is missing after install | Provider or manifest is not loaded | Confirm capell.json, package composer.json, and provider registration |
Reinstall the package, refresh Composer autoload, and clear host caches |
| Public output leaks unexpected state | Render data, cache variation, or authoring boundary has regressed | Check public Blade, cache tags, and public-output safety tests | Move data loading out of Blade and rerun the package public-output tests |
- Install the package:
composer require capell-app/hero. - Run the package setup:
php artisan capell:hero-setup. - Open
/and confirm the public output renders without admin state.