Countdown Widget

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/widget-countdown`
Package slug	`widget-countdown`
Product group	Capell Foundation
Tier	free
Bundle	`foundation`
Runtime contexts	`admin`, `frontend`
Capell version	`^1.0`
Catalogue role	extension
Release channel	Beta
Source repository	`capell-app/packages`
Source path	`packages/widget-countdown`
Docs source	`packages/widget-countdown/docs`
Manifest	`capell.json`

What This Plugin Adds

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

Why It Matters

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.

Screens And Workflow

Screenshot contract: docs/screenshots.json.

Countdown Widget extension card (marketplace, supplementary documentation fixture).
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).

Technical Shape

Service providers

Capell\WidgetCountdown\Providers\WidgetCountdownServiceProvider

Filament classes

CountdownWidget

Data objects

CountdownInputData
CountdownRenderData

Manifest contributions

asset: Capell\WidgetCountdown\WidgetCountdownContribution
content-widget: Capell\WidgetCountdown\WidgetCountdownContribution

Health checks

Capell\WidgetCountdown\Health\WidgetCountdownHealthCheck

Blade views

packages/widget-countdown/resources/views/widget.blade.php

Cache tags

widget-countdown

Data Model

This package has no schema impact. It extends Capell through asset contributions and content-widget contributions instead of declaring package-owned tables.

Install Impact

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.

Common Pitfalls

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-countdown 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

Install the package: composer require capell-app/widget-countdown.
Open a host admin workflow that uses the package extension and verify Countdown Widget is available.