Theme Local Services

Package docs status

This page is generated from public package documentation in capell-4/packages and the package manifest checked into the source repository.

Field	Value
Composer package	`capell-app/theme-local-services`
Package slug	`theme-local-services`
Product group	Capell Themes
Tier	premium
Bundle	`themes`
Runtime contexts	`frontend`
Capell version	`^4.0`
Source repository	`capell-app/packages`
Source path	`packages/theme-local-services`
Docs source	`packages/theme-local-services/docs`
Manifest	`capell.json`

Theme Local Services is a Capell theme for trades, clinics, consultancies, and local operators that need service pages, location coverage, proof, and quote requests.

At A Glance

Package: capell-app/theme-local-services
Namespace: Capell\ThemeStudio\LocalServices\
Theme key: local-services
Surfaces: frontend, console
Service provider: Capell\ThemeStudio\LocalServices\LocalServicesThemeServiceProvider
Demo command: capell:theme-local-services-demo {--url=} {--languages=} {--sites=} {--force}
Extends: capell-app/foundation-theme
Database impact: none

Why It Helps Your Capell Workflow

Site owners can present services, service areas, case studies, resources, and quote requests in a layout built for local conversion.
Editors can build service-business pages through normal Capell page and theme tools instead of relying on one-off hardcoded landing pages.
Developers get a renderer package with optional Blog and Form Builder checks for resource and quote-form sections.

Best Used With

Foundation Theme
Form Builder for quote requests.
Blog for advice/resources.
SEO Suite for local service discovery.
Campaign Studio when service pages also need campaign tracking.

What It Adds

Registers the local-services theme definition and preset.
Ships a service-business page wrapper and theme CSS.
Adds section renderers for services, service areas, quote forms, case studies, resources, contact, proof, CTA, and supporting content blocks.
Uses Core ViewSectionRenderer extra view data for optional Blog and Form Builder sections.
Adds a demo install command backed by InstallLocalServicesThemeDemoAction.
Adds ThemeLocalServicesHealthCheck and a Theme management page contribution.

Runtime Surface

Area	Path
Provider	`src/LocalServicesThemeServiceProvider.php`
Demo command	`src/Console/Commands/DemoCommand.php`
Demo action	`src/Actions/InstallLocalServicesThemeDemoAction.php`
Renderer	Core `ViewSectionRenderer` extra view data
Theme management	`src/Manifest/ThemeManagementPageContribution.php`
Health check	`src/Health/ThemeLocalServicesHealthCheck.php`
Views	`resources/views/page.blade.php`
CSS	`resources/css/theme-local-services.css`
Screenshot manifest	`docs/screenshots.json`

Install Impact

Adds a frontend theme renderer and console demo command.
Adds no migrations, settings, models, package-owned routes, or admin resources.
Depends on Foundation Theme and reads normal Capell page/theme runtime data.
Optional sections stay guarded when Blog or Form Builder are not installed.

Docs

Testing

Run package tests from the repository root:

vendor/bin/pest packages/theme-local-services/tests --configuration=phpunit.xml

Maintenance Notes

Keep public theme output free of admin URLs, signed preview URLs, editor selectors, theme internals, model IDs, and permission metadata.
Keep optional package checks inside the service provider/renderer layer, not public Blade.
Keep the docs aligned with LocalServicesThemeServiceProvider::definition() when section keys, presets, or optional integrations change.