Countdown Widget is an Available, No schema impact Capell package in the Capell Foundation product group. It ships as capell-app/widget-countdown and extends these surfaces: admin, frontend.
Countdown adds a Layout Builder widget for a scheduled target using an IANA timezone and normalized UTC value. Its public output includes a fallback state and time-change announcements.
Editors set the target, timezone, labels, and optional call to action in Layout Builder, and visitors see the remaining time on the public page.
Status details:
- Status: Available
- Tier: free
- Bundle: foundation
- Composer package:
capell-app/widget-countdown - Namespace:
Capell\WidgetCountdown - Theme key: not applicable
For developers: Typed input and render boundaries normalize time handling and reject invalid timezone or unsafe call-to-action values before rendering.
For teams: Campaign and event teams can publish a clear deadline without hand-calculating visitor-facing timezone differences.
Screenshot contract: docs/screenshots.json.
- Countdown Widget extension card (marketplace, required evidence).
- Countdown fields in Layout Builder (admin, supplementary evidence).
- Countdown public output (frontend, required evidence).
- Countdown fields in Layout Builder with admin sidebar menu open (admin, supplementary evidence).
Capell\WidgetCountdown\Providers\WidgetCountdownServiceProvider
CountdownWidget
CountdownInputDataCountdownRenderData
content-widget: Capell\WidgetCountdown\WidgetCountdownContribution
Capell\WidgetCountdown\Health\WidgetCountdownHealthCheck
packages/widget-countdown/resources/views/widget.blade.php
widget-countdown
This package has no schema impact. It extends Capell through content-widget contributions instead of declaring package-owned tables.
- 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:
content-widget: WidgetCountdownContribution. - 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:
widget-countdown. - Commands: none declared.
- 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
widget-countdowncache 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/widget-countdown. - Open the package detail or install-intent surface and confirm the Countdown Widget extension card is present.