PHPackages capell-app/theme-foundation - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. capell-app/theme-foundation ActiveLibrary capell-app/theme-foundation =========================== Capell's foundation theme — base Blade layouts, runtime design tokens, the Tailwind asset pipeline, Blade directives, media/SVG handling, and the override contracts that all vertical Capell themes extend. v1.0.18(2w ago)0222proprietaryPHPPHP ^8.4 Since Jul 9Pushed 4d agoCompare [ Source](https://github.com/capell-app/theme-foundation)[ Packagist](https://packagist.org/packages/capell-app/theme-foundation)[ Docs](https://github.com/capell-app/theme-foundation)[ RSS](/packages/capell-app-theme-foundation/feed)WikiDiscussions 4.x Synced 1w ago READMEChangelog (10)Dependencies (13)Versions (21)Used By (2) Foundation Theme ================ [](#foundation-theme) What This Extension Adds ------------------------ [](#what-this-extension-adds) Foundation Theme is an **Available**, **No schema impact** Capell theme in the **Capell Foundation** product group. It ships as `capell-app/theme-foundation` and extends these surfaces: admin, frontend. Capell's foundation theme - base Blade layouts, runtime design tokens, the Tailwind asset pipeline, Blade directives, media/SVG handling, and the override contracts that all visual Capell themes extend. After install, admins can select the theme through the core theme management surface. Editors keep using normal Capell content workflows while the package controls public presentation. Status details: - Status: Available - Tier: free - Bundle: foundation - Composer package: `capell-app/theme-foundation` - Namespace: `Capell\FoundationTheme` - Theme key: `default` Why It Matters -------------- [](#why-it-matters) **For developers:** The package gives developers package-owned service providers, Actions, Data objects, Filament classes, and Blade views instead of pushing this behaviour into core or application code. **For teams:** The base theme every Capell site and child theme builds on: shared Blade layouts, a runtime design-token system (colours, spacing, radius), the Tailwind asset pipeline, an SVG sanitiser, and the section/area contracts that visual themes override. Screens And Workflow -------------------- [](#screens-and-workflow) Screenshot contract: `docs/screenshots.json`. - Default theme settings screen (admin, required). - Generated Tailwind asset output review (developer, required). - Frontend page using the default theme (frontend, required). - Foundation header Layout Builder area (frontend, required). - Homepage layout (frontend, required). - Standard content page (frontend, required). - Blog article layout (frontend, required). - Listing page layout (frontend, required). - Contact form layout (frontend, required). - Search results layout (frontend, required). - Events listing layout (frontend, required). - Access-gated page layout (frontend, required). Technical Shape --------------- [](#technical-shape) - Service providers: `Capell\FoundationTheme\Providers\FoundationThemeServiceProvider`. - Config files: `packages/theme-foundation/config/capell-theme-foundation.php`. - Settings migrations: `packages/theme-foundation/database/settings/2026_05_10_190850_01_create_theme_foundation_settings.php`, `packages/theme-foundation/database/settings/2026_05_23_160819_add_theme_foundation_design_tokens.php`, `packages/theme-foundation/database/settings/2026_05_23_161002_refresh_theme_foundation_design_token_defaults.php`, `packages/theme-foundation/database/settings/2026_05_23_170001_add_theme_foundation_composition_tokens.php`, `packages/theme-foundation/database/settings/2026_05_23_171201_quiet_theme_foundation_composition_palette.php`, `packages/theme-foundation/database/settings/2026_05_23_180101_add_theme_foundation_image_tokens.php`, `packages/theme-foundation/database/settings/2026_06_07_000001_add_theme_foundation_dark_design_tokens.php`, `packages/theme-foundation/database/settings/2026_06_07_000002_add_theme_foundation_typography_tokens.php`. - Settings classes: `FoundationThemeSettings`, `FoundationThemeSettingsMigrationProvider`. - Filament classes: `FoundationThemeSettingsSchema`. - Livewire components: `AbstractAssets`, `PageAssets`, `AbstractWidget`, `Pages`. - Listeners: `RunTailwindAssetsOnPackageChange`. - Actions: `BuildAssetBannerItemsAction`, `BuildBannerImageRenderDataAction`, `BuildHeroRailItemsRenderDataAction`, `BuildLayoutNeighborLinksDataAction`, `BuildPageContentRenderDataAction`, `BuildWidgetAssetRenderDataAction`, `InstallFoundationThemeDemoAction`, `InstallFoundationThemeLayoutDefaultsAction`, `MarkPrimaryHeadingRenderedAction`, `ResolveFoundationThemeTokensAction`, `ResolveLoadedLayoutContainerBackgroundImageAction`, `ResolveLoadedWidgetBackgroundImageAction`, `and 3 more`. - Data objects: `AssetBannerItemData`, `BannerImageRenderData`, `FoundationThemeTokensData`, `LayoutNeighborLinksData`, `PageContentRenderData`, `ThemeDemoInstallData`, `WidgetAssetRenderData`. - Command signatures: `capell:theme-foundation-demo`, `capell:theme-foundation-setup`. - Console command classes: `DemoCommand`, `GenerateTailwindAssetsCommand`, `SetupCommand`. - Health checks: `Capell\FoundationTheme\Health\FoundationThemeHealthCheck`. - Blade views: `packages/theme-foundation/resources/views/app.blade.php`, `packages/theme-foundation/resources/views/block/wrapper.blade.php`, `packages/theme-foundation/resources/views/components/actions/index.blade.php`, `packages/theme-foundation/resources/views/components/app/body.blade.php`, `packages/theme-foundation/resources/views/components/app/head/custom.blade.php`, `packages/theme-foundation/resources/views/components/app/head/tokens.blade.php`, `packages/theme-foundation/resources/views/components/badge.blade.php`, `packages/theme-foundation/resources/views/components/block/wrapper.blade.php`, `packages/theme-foundation/resources/views/components/button/index.blade.php`, `packages/theme-foundation/resources/views/components/content.blade.php`, `packages/theme-foundation/resources/views/components/demo/contact-page.blade.php`, `packages/theme-foundation/resources/views/components/dropdown/index.blade.php`, `and 78 more`. - Cache tags: `theme-foundation`. Child Theme Override Contract ----------------------------- [](#child-theme-override-contract) Foundation Theme owns the stable child theme override surface for Capell themes. Child themes should declare `extends: 'default'` and override documented sections, views, tokens, and chrome areas instead of replacing the whole public rendering path. Stable contract points: - Theme Studio sections: `navigation`, `hero`, `features`, `proof`, `content-listing`, `search`, `pagination`, `form`, `cta`, `footer`. - Shared views: `capell::theme.page`, `capell::layout.area`, `capell::media.svg`. - Runtime tokens: `--foundation-page-bg`, `--foundation-section-spacing`, `--foundation-widget-gap`. - Layout Builder chrome areas: `header`. - Public-output rule: child themes must not expose authoring metadata, editor controls, model IDs, field paths, permissions, or signed editor URLs. Data Model ---------- [](#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 -------------- [](#install-impact) - Admin navigation: adds package-owned Filament classes when registered. - Permissions: none declared in `capell.json`. - Public routes: none detected in package route files. - Database changes: no package migrations declared. - Settings: settings classes or settings migrations exist; verify the install flow registers them. - Queues or schedules: none detected in standard package paths. - Cache tags: `theme-foundation`. - Commands: `capell:theme-foundation-demo`, `capell:theme-foundation-setup`. Common Pitfalls --------------- [](#common-pitfalls) - Keep public Blade and cached HTML free of authoring markers, model IDs, permissions, signed editor URLs, and lazy database queries. - Keep `composer.json`, `composer.local.json`, `capell.json`, docs, screenshots, and tests aligned when the package surface changes. Troubleshooting --------------- [](#troubleshooting) SymptomLikely causeCheckFixPackage surface is missing after installProvider or manifest is not loadedConfirm `capell.json`, package `composer.json`, and provider registrationReinstall the package, refresh Composer autoload, and clear host cachesBackground work does not runQueue worker or scheduled command is not activeCheck package jobs, commands, and host scheduler configurationStart the queue or scheduler, then run the focused command or package testPublic output leaks unexpected stateRender data, cache variation, or authoring boundary has regressedCheck public Blade, cache tags, and public-output safety testsMove data loading out of Blade and rerun the package public-output testsQuick Start ----------- [](#quick-start) 1. Install the package: `composer require capell-app/theme-foundation`. 2. Run the required setup: `php artisan capell:theme-foundation-setup`. 3. Open the related Capell admin surface and verify Foundation Theme appears. Next Steps ---------- [](#next-steps) - [Package docs](docs/README.md) - [Overview](docs/overview.md) - [Screenshot contract](docs/screenshots.json) - [Marketplace assets](docs/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). - Focused tests: `vendor/bin/pest packages/theme-foundation/tests --configuration=phpunit.xml`. ### Health Score 47 — FairBetter than 93% of packages Maintenance98 Actively maintained with recent releases Popularity9 Limited adoption so far Community10 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~2 days Total 18 Last Release 16d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/85b211531c530cd60c8e1b7b2c125c7e42192c820cde99fb6b201b1dde7a9d96?d=identicon)[capell-app](/maintainers/capell-app) --- Top Contributors [![capell-app-user](https://avatars.githubusercontent.com/u/213955377?v=4)](https://github.com/capell-app-user "capell-app-user (7 commits)") --- Tags capellcapell-cmsfoundationlaravelphptailwindcssthemelaravelcmsthemefrontendcapell ### Embed Badge ![Health badge](/badges/capell-app-theme-foundation/health.svg) ``` [![Health](https://phpackages.com/badges/capell-app-theme-foundation/health.svg)](https://phpackages.com/packages/capell-app-theme-foundation) ``` ### Alternatives [relaticle/custom-fields User Defined Custom Fields for Laravel Filament 16472.9k](/packages/relaticle-custom-fields)[danestves/laravel-polar A package to easily integrate your Laravel application with Polar.sh 8327.5k](/packages/danestves-laravel-polar)[tarfin-labs/event-machine Event-driven state machines for Laravel with event sourcing, type-safe context, and full audit trail. 219.6k](/packages/tarfin-labs-event-machine) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)