Package Overview
First-party optional packages for Capell CMS. This repository is the package workspace beside the host application in ../capell-4; install only the packages a project needs.
Package pages are published at docs.capell.app/packages/<package>/. Each package page should be useful on its own for developers searching for a specific Capell capability, and should link to deeper docs when the package owns setup, data, workflow, API, or extension details.
Each package README follows the same shape:
- At a glance: Composer name, namespace, runtime surfaces, service providers, and package dependencies.
- What it adds: the editor, frontend, console, queue, or integration behaviour the package owns.
- Code map: the package directories future changes should inspect first.
- Surfaces: Filament, Livewire, HTTP, commands, persistence, extension points, docs, and tests.
Find A Package By Job
Section titled “Find A Package By Job”| Job | Start with | Why |
|---|---|---|
| Build editable pages and reusable layouts | layout-builder, content-sections, hero | Owns layout containers, elements, content sections, and starter visual content. |
| Publish articles, archives, and tagged content | blog, tags, site-discovery | Adds article workflow, taxonomy, public archives, and sitemap discovery. |
| Add campaign and conversion reporting | campaign-studio, insights, ga4-reports | Connects landing pages, goals, first-party events, and GA4 snapshots. |
| Improve technical SEO and search | seo-suite, search, site-discovery | Covers metadata, structured data, sitemaps, public search, and discoverability checks. |
| Prepare demos, screenshots, and fixture sites | demo-kit, foundation-theme | Generates repeatable demo sites, package demo content, and frontend theme output. |
| Tighten admin operations and access controls | diagnostics, dashboard-reports, password-policy, login-audit | Adds health checks, dashboard signals, password enforcement, and login visibility. |
Package Index
Section titled “Package Index”Foundation And Content
Section titled “Foundation And Content”| Package | Composer package | Purpose |
|---|---|---|
| address | capell-app/address | Country, region, and address data for Capell forms and admin records. |
| block-library | capell-app/content-blocks | Shared typed content block primitives used by layout and content packages. |
| blog | capell-app/blog | Article publishing, archive pages, tag pages, article elements, and sitemap contributions. |
| content-sections | capell-app/content-sections | Reusable content section records and Livewire rendering. |
| events | capell-app/events | Event records, venues, occurrences, registrations, calendar pages, and iCalendar feeds. |
| hero | capell-app/hero | Default home-page hero element rendering and setup. |
| media-library | capell-app/media-library | Awcodes Curator backend integration for Capell media. |
| navigation | capell-app/navigation | Editor-managed menus for Capell frontend themes. |
| notes | capell-app/notes | Contextual notes, assignments, mentions, and reminders. |
| tags | capell-app/tags | Shared editor-controlled taxonomies. |
| foundation-theme | capell-app/foundation-theme | Default frontend theme, asset pipeline, Blade directives, URL generation, and SVG media rendering. |
Authoring And Publishing
Section titled “Authoring And Publishing”| Package | Composer package | Purpose |
|---|---|---|
| frontend-authoring | capell-app/frontend-authoring | Authenticated admin in-page editing bridge for public frontend pages. |
| frontend-optimizer | capell-app/frontend-optimizer | Profile-based CSS and JavaScript delivery for public pages. |
| html-cache | capell-app/html-cache | Static HTML cache, dependency indexing, and cache administration. |
| publishing-studio | capell-app/publishing-studio | Revisions, release workspaces, scheduling, approvals, previews, and controlled publishing. |
| translation-manager | capell-app/translation-manager | File-based Laravel translation management for Capell and Filament panels. |
| welcome-tour | capell-app/welcome-tour | Optional Filament welcome tour for Capell Admin. |
Forms, Access, And Public Workflows
Section titled “Forms, Access, And Public Workflows”| Package | Composer package | Purpose |
|---|---|---|
| access-gate | capell-app/access-gate | Public access gates, entitlement checks, and gated delivery foundations. |
| form-builder | capell-app/form-builder | Editor-managed forms, fields, submissions, validation, and notifications. |
| newsletter | capell-app/newsletter | Audience management, subscriptions, consent state, imports, notifications, and public subscription routes. |
| password-policy | capell-app/password-policy | Password expiry, forced password changes, and password safety policy. |
| public-actions | capell-app/public-actions | Reusable public submit actions, outbound automation dispatch, and integration endpoints. |
Growth, Search, And Reporting
Section titled “Growth, Search, And Reporting”| Package | Composer package | Purpose |
|---|---|---|
| campaign-studio | capell-app/campaign-studio | Campaign landing pages, CTA blocks, UTM attribution, conversion goals, and campaign insights. |
| dashboard-reports | capell-app/dashboard-reports | Generic reporting widgets for Capell dashboards. |
| email-studio | capell-app/email-studio | Transactional templates, delivery audit, provider events, replies, and suppressions. |
| ga4-reports | capell-app/ga4-reports | GA4 dashboard reporting for Capell. |
| insights | capell-app/insights | First-party insights, visitor journeys, click tracking, and consent management. |
| search | capell-app/search | Public site search, optional logging, and admin search insights. |
| seo-suite | capell-app/seo-suite | Metadata panels, structured data, social meta, SEO audits, sitemaps, and AI-assisted SEO. |
| site-discovery | capell-app/site-discovery | Public discoverability and sitemap outputs. |
Operations, Agents, And Migration
Section titled “Operations, Agents, And Migration”| Package | Composer package | Purpose |
|---|---|---|
| agent-bridge | capell-app/agent-bridge | Agent Bridge servers and capability adapters. |
| ai-orchestrator | capell-app/ai-orchestrator | AI providers, prompts, structured requests, and package integration workflows. |
| demo-kit | capell-app/demo-kit | Demo content and media setup for Capell packages. |
| deployments | capell-app/deployments | Repository deployment connections and Composer publishing. |
| diagnostics | capell-app/diagnostics | Developer and operational diagnostics. |
| login-audit | capell-app/login-audit | Authentication log and login visibility. |
| media-ai | capell-app/media-ai | Optional AI-assisted media actions. |
| migration-assistant | capell-app/migration-assistant | Export, import, rollback report, and migration workflow support. |
| wordpress-importer | capell-app/wordpress-importer | WordPress WXR import source for Migration Assistant. |
Themes
Section titled “Themes”Use the Capell Theme Scale when creating a theme, changing renderer contracts, or deciding whether configuration belongs in theme settings, page blueprints, widget blueprints, Layout Builder assets, or Blade.
| Package | Composer package | Tier | Purpose |
|---|---|---|---|
| foundation-theme | capell-app/foundation-theme | Free | Default frontend runtime and renderer. |
| theme-agency | capell-app/theme-agency | Free | Expressive agency theme for Capell. |
| theme-corporate | capell-app/theme-corporate | Free | Trust-led corporate theme for Capell. |
| theme-commerce | capell-app/theme-commerce | Premium | Image-led commerce theme for Capell. |
| theme-healthcare | capell-app/theme-healthcare | Premium | Appointment-led healthcare theme for Capell. |
| theme-saas | capell-app/theme-saas | Premium | Velocity SaaS theme for Capell. |
Install Pattern
Section titled “Install Pattern”Install packages from the host Capell application:
composer require capell-app/<package>Then run the package install command listed in that package README when it owns migrations, settings, generated pages, demo data, or external setup.
Install Ordering Notes
Section titled “Install Ordering Notes”- Install
capell-app/layout-builderbeforecapell-app/blog. - Install
capell-app/layout-builder, thencapell-app/foundation-theme, before any premium theme package. - Install
capell-app/migration-assistantbeforecapell-app/wordpress-importer.
Working In This Repository
Section titled “Working In This Repository”Use package-level checks while editing:
vendor/bin/pest packages/<package>/tests --configuration=phpunit.xmlUse broader checks before integration:
composer testcomposer preflightDo not run php artisan in this repository. Testbench provides the Laravel context for package tests.
Documentation
Section titled “Documentation”- Per-package READMEs live at
packages/<package>/README.md. - Deeper package docs live under
packages/<package>/docs/when the package needs API, database, workflow, or design notes. - Screenshot generation is manifest-driven where
packages/<package>/docs/screenshots.jsonexists. - External docs: docs.capell.app.
License
Section titled “License”Proprietary unless an individual package states otherwise.