# Theme Broadsheet ## Package docs status This page is generated from package source documentation in `the Capell packages repository` and the checked-in manifest. Source documentation is not distribution status. Before running a Composer command, verify that the exact package and compatible 1.x release are available through public Packagist or the authenticated marketplace account. | Field | Value | | --- | --- | | Composer package | `capell-app/theme-broadsheet` | | Package slug | `theme-broadsheet` | | Product group | Capell Themes | | Tier | premium | | Bundle | `themes` | | Runtime contexts | `frontend` | | Capell version | `^1.0` | | Catalogue role | extension | | Release channel | Labs | | Source repository | `capell-app/packages` | | Source path | `packages/theme-broadsheet` | | Docs source | `packages/theme-broadsheet/docs` | | Manifest | [`capell.json`](https://github.com/capell-app/packages/edit/main/packages/theme-broadsheet/capell.json) | ## What This Plugin Adds Theme Broadsheet is an **Available**, **No schema impact** Capell theme in the **Capell Themes** product group. It ships as `capell-app/theme-broadsheet` and extends these surfaces: frontend. Theme Broadsheet adds numbers-first presentation for published prices, standings, results, edition wires, schedules, and notices. Capell and Layout Builder retain the content; the theme owns its public-safe rendering and progressive enhancement. Visitors receive a dense but readable board whose tables, absolute timestamps, and sparklines work before JavaScript; the active-theme module then adds sorting, relative display times, and controlled ticker motion without fetching data. Evidence: [`src/BroadsheetThemeServiceProvider.php`](src/BroadsheetThemeServiceProvider.php), [`src/Enums/WidgetComponentEnum.php`](src/Enums/WidgetComponentEnum.php), [`resources/views/sections/league-board.blade.php`](resources/views/sections/league-board.blade.php), [`resources/views/sections/front-page-lede.blade.php`](resources/views/sections/front-page-lede.blade.php), [`resources/js/broadsheet-frontend.js`](resources/js/broadsheet-frontend.js), [`resources/views/sections/ticker-strip.blade.php`](resources/views/sections/ticker-strip.blade.php), [`tests/Unit/BoardMarkupTest.php`](tests/Unit/BoardMarkupTest.php), [`tests/Feature/FrontendScriptTest.php`](tests/Feature/FrontendScriptTest.php). Status details: - Status: Available - Tier: premium - Bundle: themes - Composer package: `capell-app/theme-broadsheet` - Namespace: `Capell\ThemeBroadsheet` - Theme key: `broadsheet` ## Why It Matters **For developers:** The package keeps domain decisions in Actions and Data, registers ten layout widgets through one allowlisted dispatcher, and contributes a hashed module only while Broadsheet is active. **For teams:** Editorial and operations teams can publish price boards, league tables, rankings, notices, and schedules with a clear edition-based presentation and honest fallbacks when optional extensions are absent. Evidence: [`src/Actions/ResolveBroadsheetSectionAction.php`](src/Actions/ResolveBroadsheetSectionAction.php), [`src/Actions/ResolveBroadsheetIntegrationsAction.php`](src/Actions/ResolveBroadsheetIntegrationsAction.php), [`src/Data/BroadsheetSectionData.php`](src/Data/BroadsheetSectionData.php), [`tests/Feature/WidgetRegistrationTest.php`](tests/Feature/WidgetRegistrationTest.php), [`src/Support/Demo/BroadsheetDemoContent.php`](src/Support/Demo/BroadsheetDemoContent.php), [`resources/views/sections/notice-board.blade.php`](resources/views/sections/notice-board.blade.php), [`resources/views/sections/session-clock.blade.php`](resources/views/sections/session-clock.blade.php), [`tests/Feature/AvailabilityFallbackTest.php`](tests/Feature/AvailabilityFallbackTest.php). ## Screens And Workflow Screenshot contract: `docs/screenshots.json`. ![Broadsheet dark data-board marketplace card](assets/marketplace/extension-card.svg) Desktop, tablet, and mobile variants remain defined in the screenshot contract; this list groups them by workflow. - Broadsheet Exchange front page (frontend, optional). - Broadsheet Complete board directory (frontend, optional). - Broadsheet Series detail and standings (frontend, optional). - Broadsheet Auction floor contact (frontend, optional). - Broadsheet Empty board recovery (frontend, optional). - Broadsheet Wire correction page (frontend, optional). - Broadsheet Membership closing notice (frontend, optional). ## Technical Shape - Service providers: `Capell\ThemeBroadsheet\BroadsheetThemeServiceProvider`. - Actions: `InstallBroadsheetThemeDemoAction`, `ResolveBroadsheetIntegrationsAction`, `ResolveBroadsheetSectionAction`. - Data objects: `BroadsheetIntegrationsData`, `BroadsheetSectionData`. - Command signatures: `capell:theme-broadsheet-demo`. - Console command classes: `DemoCommand`. - Manifest contributions: `admin-page: Capell\ThemeBroadsheet\Manifest\ThemeManagementPageContribution`. - Health checks: `Capell\ThemeBroadsheet\Health\ThemeBroadsheetHealthCheck`. - Blade views: `packages/theme-broadsheet/resources/views/components/delta.blade.php`, `packages/theme-broadsheet/resources/views/components/sparkline.blade.php`, `packages/theme-broadsheet/resources/views/footer.blade.php`, `packages/theme-broadsheet/resources/views/header/index.blade.php`, `packages/theme-broadsheet/resources/views/sections/content-listing--boardroom.blade.php`, `packages/theme-broadsheet/resources/views/sections/content-listing.blade.php`, `packages/theme-broadsheet/resources/views/sections/cta--closing-notice.blade.php`, `packages/theme-broadsheet/resources/views/sections/cta.blade.php`, `packages/theme-broadsheet/resources/views/sections/data-fact-columns.blade.php`, `packages/theme-broadsheet/resources/views/sections/footer.blade.php`, `packages/theme-broadsheet/resources/views/sections/front-page-lede.blade.php`, `packages/theme-broadsheet/resources/views/sections/index-footer-band.blade.php`, `and 9 more`. - Cache tags: `theme-broadsheet`. ## Data Model This theme has no schema impact. It relies on core Capell site, page, locale, and theme records instead of declaring package-owned tables. ## Install Impact - Required packages: `capell-app/core`, `capell-app/frontend`, `capell-app/layout-builder`, `capell-app/theme-foundation`. - Admin navigation: declares `admin-page: ThemeManagementPageContribution`; each Filament page or resource controls its own navigation visibility. - Admin/editor extensions: none declared. - Permissions: none declared in `capell.json`. - 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: `theme-broadsheet`. - Commands: `capell:theme-broadsheet-demo`. ## Common Pitfalls - Keep required Capell packages on compatible v4 releases: `capell-app/core`, `capell-app/frontend`, `capell-app/layout-builder`, `capell-app/theme-foundation`. - 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 `theme-broadsheet` cache tags. ## Troubleshooting | 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 | ## Quick Start 1. Install the package: `composer require capell-app/theme-broadsheet`. 2. No package-specific setup command or migrations are declared. 3. Run `php artisan list` and verify the package command signatures are registered. ## Next Steps - [Package docs](README.md) - [Overview](overview.md) - [Troubleshooting](#troubleshooting) - [Screenshot contract](screenshots.json) - [Marketplace assets](assets/marketplace/) - [Capell content language plan](../../docs/CONTENT_LANGUAGE_PLAN.md) - [Capell documentation design system](../../docs/DESIGN_SYSTEM.md) - [Capell and package ERD notes](../../docs/erd/capell-and-package-erds.md) - Related packages: [Layout Builder](../layout-builder/README.md), [Theme Foundation](../theme-foundation/README.md), [Blog](../blog/README.md), [Events](../events/README.md), [Form Builder](../form-builder/README.md), [Newsletter](../newsletter/README.md), [Search](../search/README.md), [Widget Countdown](../widget-countdown/README.md), [Widget Data Chart](../widget-data-chart/README.md), [Widget Location Map](../widget-location-map/README.md). - Focused tests: `vendor/bin/pest packages/theme-broadsheet/tests --configuration=phpunit.xml`.