PHPackages                             capell-app/core - 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/core

ActiveLibrary

capell-app/core
===============

Laravel CMS content, publishing, extension, install, and upgrade foundations for Capell.

v1.0.35(2w ago)05815MITPHPPHP ^8.4

Since Jul 12Pushed 1w agoCompare

[ Source](https://github.com/capell-app/core)[ Packagist](https://packagist.org/packages/capell-app/core)[ Docs](https://github.com/capell-app/core)[ RSS](/packages/capell-app-core/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (10)Dependencies (40)Versions (38)Used By (15)

Capell Core
===========

[](#capell-core)

[![Capell Core architectural cutaway showing Site, Language, Page, URL, Settings, Theme, and Extension layers](docs/assets/readme/hero.jpg)](docs/assets/readme/hero.jpg)

[![Latest Release](https://camo.githubusercontent.com/be7ed2e3982bf0086948664ff60952a473486f0e3ef7782dbdc3ec2d33472f93/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f636170656c6c2d6170702f636f72653f7374796c653d666c61742d737175617265266c6162656c3d72656c65617365)](https://github.com/capell-app/core/releases/latest)[![Latest Version on Packagist](https://camo.githubusercontent.com/4a1dd5d6f6ee8d6377b3623161fbc7d83e5dc409969d925311644ca22bced67c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636170656c6c2d6170702f636f72652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/capell-app/core)[![Tests](https://github.com/capell-app/capell/actions/workflows/test-full.yml/badge.svg?branch=main)](https://github.com/capell-app/capell/actions/workflows/test-full.yml)[![PHP Quality](https://github.com/capell-app/capell/actions/workflows/code-quality-and-styling.yml/badge.svg?branch=main)](https://github.com/capell-app/capell/actions/workflows/code-quality-and-styling.yml)[![PHP](https://camo.githubusercontent.com/d072d1f17b6a8dc799e782e39d676d25cab3e73854efe49206d6ffcb6473abd4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e342d3737374242343f7374796c653d666c61742d737175617265266c6f676f3d706870266c6f676f436f6c6f723d7768697465)](#requirements-and-support-policy)[![Laravel Compatibility](https://camo.githubusercontent.com/e8cdab4a9e2bface79e092c14e6d24b7393749b3d5dc904a09cb063cde069295/68747470733a2f2f62616467652e6c61726176656c2e636c6f75642f62616467652f636170656c6c2d6170702f636f72653f7374796c653d666c6174)](https://packagist.org/packages/capell-app/core)[![Documentation](https://camo.githubusercontent.com/74103e2593167ea862d42050aa01301e640df4e220bea126345e2310db5fe14e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f63732d646f63732e636170656c6c2e6170702d626c75653f7374796c653d666c61742d737175617265)](https://docs.capell.app)

`capell-app/core` is the platform package for Capell CMS. It owns the shared content model, package registry, install and upgrade orchestration, settings infrastructure, and extension contracts used by Admin, Frontend, Installer, Marketplace, and first-party add-ons.

Use this package when a Laravel app needs Capell's domain records and extension API. It is not an editor UI or public renderer by itself.

Package Boundary
----------------

[](#package-boundary)

Core owns:

- sites, domains, languages, pages, page URLs, layouts, themes, blueprints, media records, redirects, package state, and upgrade log records
- install, upgrade, rollback, package cache, component cache, doctor, faker, and maker commands
- package manifest validation, package registry state, settings schemas, subscribers, render blocks, maker registration, and model-level contracts
- database migrations and settings migrations for the shared Capell schema

Core does not own:

- the Filament admin panel, resources, dashboard surfaces, and editor workflow; that is `capell-app/admin`
- public request handling and public HTML rendering; that is `capell-app/frontend`
- browser installer routes and setup removal; that is `capell-app/installer`
- catalogue browsing, account linking, and install authorization; that is `capell-app/marketplace`
- visual layout building, frontend authoring, generated HTML cache, SEO, blog, navigation, or migration/recovery features; those live in add-on packages

Install
-------

[](#install)

For a guided full-stack setup, require `capell-app/installer` and run `php artisan capell:install` — it brings in core and composer-requires the admin/frontend packages you choose. To use core on its own (headless or manual setups):

```
composer require capell-app/core
php artisan capell:install
```

`capell:install` coordinates the foundation install flow. On an existing Capell app, use:

```
php artisan capell:upgrade
php artisan capell:doctor
```

Use `php artisan list capell` in the host app to confirm the exact command set available after Composer discovery.

Runtime Surfaces
----------------

[](#runtime-surfaces)

- Provider: `Capell\Core\Providers\CapellServiceProvider`
- Config: `config/capell.php`, `config/redirects.php`
- Main models: `Page`, `PageUrl`, `Site`, `SiteDomain`, `Language`, `Layout`, `Theme`, `Blueprint`, `Type`, `Media`, `CapellExtension`, `UpgradeLogEntry`
- Main commands: `capell:install`, `capell:upgrade`, `capell:rollback`, `capell:doctor`, `capell:package-cache`, `capell:package-cache:clear`, `capell:publish-migrations`, `capell:delete-migrations`, `capell:publish-components`, `capell:make-*`
- Test case support: `Capell\Core\Testing\ExtensionTestHarness`

`Type` remains present for compatibility while the admin surface is moving toward Blueprint naming. New docs and UI copy should prefer Blueprint unless they are documenting a compatibility API that still uses type terminology.

Extension Points
----------------

[](#extension-points)

Use these extension points instead of patching first-party models or providers:

NeedExtension pointRegister a page subject type`CapellCore::registerPageType(new PageTypeData(...))`Register package settings`SettingsSchemaRegistry::register()`Register renderable definitions`RenderableRegistry::register()`Subscribe to lifecycle events`SubscriberManager::subscribe()`Register cache dependencies`CacheInvalidationRegistry::registerDependency()`Register Tailwind source/import metadata`TailwindAssetsRegistry::registerSource()` / `registerImport()`Create package files from project patterns`capell:make-*` maker commandsWhen adding a Core migration, also append it to `src/Concerns/HasMigrations.php`; otherwise package installs can miss the migration.

Data And Persistence
--------------------

[](#data-and-persistence)

Core is schema-owning. It creates the tables used by most Capell packages, including page, site, language, layout, theme, blueprint, media, extension, redirect, and upgrade state.

Settings migrations are part of package installation and must be idempotent. Wrap new settings migrations in existence checks so upgrades and fresh installs behave the same way.

Core records are used by public rendering and admin workflows, so avoid adding admin-only assumptions to models, casts, or public serialization paths.

Verification
------------

[](#verification)

From the split repository root, with development dependencies installed, run the smallest relevant check first:

```
vendor/bin/pest tests
```

For shared contract changes, also run the package boundary and manifest tests:

```
vendor/bin/pest tests/Arch tests/Unit/Manifest
```

Requirements And Support Policy
-------------------------------

[](#requirements-and-support-policy)

SurfaceSupported versionsPHP`^8.4` with `ext-intl`Laravel`^13.0`Filament support`^5.7.6`Symfony filesystem/process`^7.2` or `^8.0`Symfony HTML sanitizer`^7.0` or `^8.0`RuntimePHP-FPM; Laravel Octane with Swoole, RoadRunner, or FrankenPHPEach Capell 1.x minor receives security fixes for 24 months from its release date, and the latest 1.x minor is always supported. Upgrade all installed Capell foundation packages together to the same supported release before requesting a fix. See the [Capell security policy](https://github.com/capell-app/capell/security/policy) for vulnerability reporting.

Support covers the dependency ranges above. When an upstream PHP, Laravel, Filament, or Symfony release reaches its own end of life earlier, upgrading that dependency may be required to receive a safe fix.

Troubleshooting
---------------

[](#troubleshooting)

- Missing package surfaces usually mean Composer discovery or the Capell package cache is stale. Run `composer dump-autoload`, then `php artisan capell:package-cache:clear`.
- New migrations that work in tests but not on install are usually missing from `HasMigrations::getMigrations()`.
- Missing default page records or Blueprint warnings should be checked with `php artisan capell:doctor` before changing seed or setup code.
- Do not document moved features as Core behavior. Publishing Studio, generated HTML cache, site discovery, frontend authoring, SEO, blog, navigation, and Migration Assistant workflows are package-owned.

Development
-----------

[](#development)

Package development and coordinated verification happen in the [capell-app/capell monorepo](https://github.com/capell-app/capell). Split package repositories are release mirrors; use [docs.capell.app](https://docs.capell.app) for cross-package guidance. See the [contribution guide](https://github.com/capell-app/capell/blob/main/CONTRIBUTING.md), [security policy](https://github.com/capell-app/capell/security/policy), and [licence](https://github.com/capell-app/capell/blob/main/LICENSE.md).

Further Reading
---------------

[](#further-reading)

PageCovers[Core overview](docs/overview.md)Core responsibilities and the package docs index.[Page management](docs/page-management.md)Pages, URLs, types, and publishing state.[Content management](docs/content-management.md)Shared content records and ownership boundaries.[Extending Capell](docs/extending-capell.md)Core contracts and extension surfaces.[Cache](docs/cache.md)Shared cache helpers and invalidation behavior.[Multi-site and multi-lingual](docs/multi-site-multi-lingual.md)Sites, domains, languages, and localized URLs.[Relationship diagnostics](docs/relationship-diagnostics.md)Debug missing active site domains for page URL rendering.[Subscriber manager](docs/subscriber-manager.md)Lifecycle subscription registration.[Static-site extensions](docs/static-site-extensions.md)Static export integration points.[Authoring upgrade steps](docs/authoring-upgrade-steps.md)Upgrading packages that integrate authoring behavior.[Install debugging](docs/install-debugging.md)Common install and setup failures.The complete integration and extension guides are published at [docs.capell.app](https://docs.capell.app).

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance98

Actively maintained with recent releases

Popularity11

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 52.6% 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 ~1 days

Total

33

Last Release

16d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/85b211531c530cd60c8e1b7b2c125c7e42192c820cde99fb6b201b1dde7a9d96?d=identicon)[capell-app](/maintainers/capell-app)

---

Top Contributors

[![howdu](https://avatars.githubusercontent.com/u/533658?v=4)](https://github.com/howdu "howdu (41 commits)")[![capell-app-user](https://avatars.githubusercontent.com/u/213955377?v=4)](https://github.com/capell-app-user "capell-app-user (22 commits)")[![web2w](https://avatars.githubusercontent.com/u/23355558?v=4)](https://github.com/web2w "web2w (11 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (4 commits)")

---

Tags

capellcapell-cmscmscontent-managementlaravellaravel-packagemultilingualmultisitephplaravelcmscapell

### Embed Badge

![Health badge](/badges/capell-app-core/health.svg)

```
[![Health](https://phpackages.com/badges/capell-app-core/health.svg)](https://phpackages.com/packages/capell-app-core)
```

###  Alternatives

[fleetbase/core-api

Core Framework and Resources for Fleetbase API

1346.4k29](/packages/fleetbase-core-api)[pimcore/pimcore

Content & Product Management Framework (CMS/PIM/E-Commerce)

3.8k4.0M552](/packages/pimcore-pimcore)[spatie/laravel-health

Monitor the health of a Laravel application

89313.5M195](/packages/spatie-laravel-health)[illuminate/queue

The Illuminate Queue package.

20433.5M1.9k](/packages/illuminate-queue)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.4k1.4M241](/packages/sulu-sulu)[psalm/plugin-laravel

Psalm plugin for Laravel

3365.5M359](/packages/psalm-plugin-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)