# Approved Packages Capell keeps the normal product small and installs larger features as packages. This repository contains Core, Admin, Frontend, Installer, and Marketplace. First-party add-ons live in the sibling `capell-app/capell-packages` monorepo and are published as `capell-app/`. Use this page to check what exists, what is free, and which premium product group owns each package. Package-specific READMEs remain the source of truth for detailed install flags, models, actions, and command signatures. The generated public package shelf is the best entry point for browsing package pages by product group, runtime context, and tier: [Package Shelf](https://docs.capell.app/packages/). Keep this catalogue focused on package selection and use package READMEs for implementation details. ## Package Selection Shortcuts | Need | Start with | | ------------------------------------------------------------------------------ | ------------------------------------------------------------ | | Build pages, layouts, theme chrome areas, sections, and starter visual content | ContentSections, Content Sections, Hero, Foundation Theme | | Publish articles, tags, archives, and discoverable URLs | Blog, Tags, Site Discovery | | Add search, metadata, schema, audits, and AI discovery checks | SEO Suite, Search | | Run campaigns and measure conversion | Campaign Studio, Insights, GA4 Reports | | Monitor site health and admin operations | Diagnostics, Dashboard Reports, Login Audit, Password Policy | | Create repeatable demo sites and package screenshots | Demo Kit, Foundation Theme | ## Install Pattern Most first-party packages follow this pattern: ```bash composer require capell-app/ php artisan capell:-install ``` Always confirm the exact command with: ```bash php artisan list capell ``` The Marketplace admin page can also install compatible packages when the marketplace is enabled. ## Normal Product Packages | Package | Composer name | Location | Purpose | | ----------- | ------------------------ | --------- | -------------------------------------------------------------------------------------------------- | | Core | `capell-app/core` | This repo | Sites, pages, languages, types, settings, package registry, install/upgrade orchestration. | | Admin | `capell-app/admin` | This repo | Filament panel, resources, dashboards, settings UI, users, page editing, media UI, recovery shell. | | Frontend | `capell-app/frontend` | This repo | Public rendering, Tailwind aggregation, Blade helpers, and frontend middleware. | | Installer | `capell-app/installer` | This repo | Browser installer guide and installer cleanup flow. | | Marketplace | `capell-app/marketplace` | This repo | Extension marketplace browsing, acquisition, and install authorization records. | ## Capell Foundation Free packages every serious Capell site can reasonably use. | Package | Composer name | Purpose | | ------------------ | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | | ContentSections | `capell-app/content-sections` | Visual content sections, content-first editing, element assets, theme layout areas, and public layout graph rendering. | | Blog | `capell-app/blog` | Blog post type, article archives, RSS-style content, and blog admin resources. | | Navigation | `capell-app/navigation` | Navigation tree management for header, footer, sidebar, and other menus. | | Tags | `capell-app/tags` | Shared taxonomy support for content types that need tags. | | Address | `capell-app/address` | Address and country fields for sites or other models. | | Media Library | `capell-app/media-library` | Awcodes Curator backend for Capell media, with Curator picker integration and migration support. | | Frontend Authoring | `capell-app/frontend-authoring` | Admin-only beacon, in-page edit controls, and cache-aware Filament field editing from public pages. | | Foundation Theme | `capell-app/foundation-theme` | Standard Tailwind frontend theme, Blade directives, URL generation, and SVG media component. | | HTML Cache | `capell-app/html-cache` | Optional generated public HTML cache and static-site warming commands. | | Site Discovery | `capell-app/site-discovery` | XML sitemap generation and discovery files. | Core uses Spatie MediaLibrary by default through Capell media contracts. Media Library stays free because media management is foundational; it swaps the implementation behind those contracts when a project wants Curator. ## Capell FormBuilder Premium lead capture and submission workflows. | Package | Composer name | Purpose | | ----------- | ------------------------- | ---------------------------------------------------------------------------------------------- | | FormBuilder | `capell-app/form-builder` | Form builder, submissions, validation, notifications, exports, and frontend/admin integration. | ## Capell Commercial Premium commercial capabilities that coordinate across installed packages without forcing those packages to depend on paid features. | Package | Composer name | Purpose | | -------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | AIOrchestrator | `capell-app/ai-orchestrator` | AI orchestration, prompt-driven capabilities, provider connectors, approval levels, and optional integrations such as ContentSections layout planning. | ## Capell Publishing Pro Premium editorial workflow and team publishing features. | Package | Composer name | Purpose | | ---------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------ | | PublishingStudio | `capell-app/publishing-studio` | Revisions, approvals, scheduling, controlled publishing, workspace activity, and draft-aware editorial flow. | ## Capell Operations Premium site health, maintenance, recovery, and admin safety. | Package | Composer name | Purpose | | ----------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------- | | Backup | `capell-app/backup` | Export, import, restore, package manifests, relation resolution, media ingest, and import-session execution. | | Diagnostics | `capell-app/diagnostics` | Operational diagnostics for Capell installations, including health, queue, permission, registry, and config checks. | | Login Audit | `capell-app/login-audit` | Login history and authentication log admin integration. | Do not document export/import as a normal Core feature; Admin provides the recovery UI shell, and Backup provides the implementation. ## Capell Growth Premium marketing, insights, campaign-studio, and conversion reporting. | Package | Composer name | Purpose | | -------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------- | | Insights | `capell-app/insights` | First-party insights, visitor journeys, click tracking, and consent management. | | CampaignStudio | `capell-app/campaign-studio` | Campaign landing pages, CTA blocks, UTM attribution, goals, conversion tracking, and dashboard reports. | ## Capell Communications Premium transactional email, delivery audit, and reply handling. | Package | Composer name | Purpose | | ------------ | ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | Email Studio | `capell-app/email-studio` | Template-driven transactional email, delivery profiles, send audit trails, suppressions, provider events, replies, and tracking diagnostics. | ## Capell Search & SEO Premium discovery, technical SEO, and search optimisation. | Package | Composer name | Purpose | | --------- | ---------------------- | -------------------------------------------------------------------------------------------- | | SEO Suite | `capell-app/seo-suite` | Structured data, social metadata, robots controls, audits, and SEO ai-orchestrator features. | | Search | `capell-app/search` | Frontend search, optional logging, zero-result dashboard reports, and admin search insights. | Basic redirects stay in Capell Foundation. Advanced redirect insights can be surfaced through Search & SEO when the SEO package is installed. ## Capell Themes Premium polished frontend themes. | Package | Composer name | Purpose | | --------------- | ---------------------------- | -------------------------------------------------------- | | Agency Theme | `capell-app/theme-agency` | Premium agency frontend renderer and curated presets. | | Corporate Theme | `capell-app/theme-corporate` | Premium corporate frontend renderer and curated presets. | | SaaS Theme | `capell-app/theme-saas` | Premium SaaS frontend renderer and curated presets. | The default theme remains Foundation. Premium themes are installed independently and can extend the Foundation Theme when they need shared defaults. Themes can also register ContentSections areas, such as `header`, so editors can place normal elements into theme chrome without bespoke content tables. ## Dependency Notes Composer installs transitive requirements, but these relationships are useful when planning a product: Packages with `visibility: support` are dependency-only helpers. They do not appear as normal catalogue choices; visible packages pull them in through `dependencies.supports` when the support package's hard requirements are already selected or installed. | Package | Notable dependencies | | ---------------- | ------------------------------------------------------------------------------------------ | | Blog | ContentSections, Navigation, Tags, PublishingStudio | | CampaignStudio | Insights, FormBuilder, Frontend, ContentSections | | Email Studio | Admin, Core, Frontend; supported integrations with FormBuilder, CampaignStudio, Insights | | ContentSections | Admin, Frontend, Navigation | | AIOrchestrator | Admin; supported integrations activate when packages such as ContentSections are installed | | PublishingStudio | Admin, Backup, Core, Navigation | | Agency Theme | Foundation Theme, Frontend | | Corporate Theme | Foundation Theme, Frontend | | SaaS Theme | Foundation Theme, Frontend | | Admin Preview | Admin, Frontend, PublishingStudio | ## For Package Authors Use the package-authoring guides when creating or maintaining a Capell package: | Page | Covers | | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- | | [Packages](README.md) | Package shape, service providers, Actions/Data/settings, extension points, migrations, and release checklist. | | [Extension point chooser](extension-point-chooser.md) | Which host extension point to use for a package contribution. | | [Extension troubleshooting](extension-troubleshooting.md) | How to debug missing package contributions, stale caches, route fallback, settings, and marketplace issues. | | [Host, package, or app code](../development/package-boundaries.md) | Where a feature or document should live. |