Package Source Docs
This directory holds cross-cutting documentation for the add-on packages. Per-package docs (API, Database, README) live alongside each package in packages/<name>/.
Per-package references
Section titled “Per-package references”For the commercial/free grouping, see Package product groups. For package-level upstream credits, services, and acknowledgements, see Credits and acknowledgements. For theme package authoring, see Creating a Capell theme. For optional package integration rules, see Optional Package Boundaries.
Use package overview.md pages for search-facing package summaries and task-level orientation. Use focused package docs for API, data, workflow, provider, and extension contracts.
Use Package Documentation Standard when creating or revising package READMEs and docs. It defines the required workflow value, technical surface, debugging, testing, and review checks.
Package Docs By Intent
Section titled “Package Docs By Intent”| Intent | Package docs |
|---|---|
| Dashboard reporting and operations signals | Dashboard Reports overview, Diagnostics overview, Login Audit overview |
| Analytics, growth, and conversion reporting | GA4 Reports overview, Insights overview, Campaign Studio overview |
| SEO, search, and public discovery | SEO Suite overview, Search overview, Site Discovery README |
| Demo data and frontend presentation | Demo Kit overview, Foundation Theme overview, Creating a Capell theme |
| Admin access and security | Password Policy overview, Access Gate requests, Public Actions integrations |
| Commerce integrations | Shopify Commerce overview, Shopify OAuth and catalog sync |
For the full documentation site, see docs.capell.app. For the package overview and dependency matrix, see the repository README.
Cross-package install order
Section titled “Cross-package install order”- Blog depends on Layout Builder; install
capell-app/layout-builderbeforecapell-app/blog. - Theme packages extend Foundation Theme; install
capell-app/layout-builder, thencapell-app/foundation-theme, thencapell-app/theme-agency,capell-app/theme-commerce,capell-app/theme-corporate,capell-app/theme-healthcare, orcapell-app/theme-saas. - WordPress Importer registers a source for Migration Assistant; install
capell-app/migration-assistantbeforecapell-app/wordpress-importer.
Screenshot Automation
Section titled “Screenshot Automation”Package screenshots are generated from committed manifests during deployment.
See Package Screenshot Automation for the contract
and expected output path.
GitHub Actions provides a Screenshot Manifests workflow that validates the committed
manifests stay in sync.