Theme Nonprofit

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-nonprofit`
Package slug	`theme-nonprofit`
Product group	Capell Themes
Tier	premium
Bundle	`themes`
Runtime contexts	`frontend`
Capell version	`^4.0`
Source repository	`capell-app/packages`
Source path	`packages/theme-nonprofit`
Docs source	`packages/theme-nonprofit/docs`
Manifest	`capell.json`

Theme Nonprofit is a Capell theme for charities, civic organisations, campaigns, and community teams that need impact stories, supporter journeys, and donation or volunteer calls to action.

At A Glance

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

Why It Helps Your Capell Workflow

Site owners can present impact, campaigns, events, stories, and supporter actions in a site structure built for trust and conversion.
Editors can build campaign and community pages using normal Capell page/theme tools instead of maintaining bespoke campaign templates.
Developers get a renderer package with optional Campaign Studio, Form Builder, Events, and Blog checks for campaign, donation, event, and story sections.

Best Used With

Foundation Theme
Campaign Studio for campaign-led pages.
Form Builder for volunteer or donation interest forms.
Events for community events.
Blog for stories and updates.

What It Adds

Registers the nonprofit theme definition and preset.
Ships an impact-led page wrapper and theme CSS.
Adds section renderers for impact, campaigns, volunteer/donate, events, stories, contact, proof, CTA, and supporting content blocks.
Uses Core ViewSectionRenderer extra view data for optional Campaign Studio, Form Builder, Events, and Blog sections.
Adds a demo install command backed by InstallNonprofitThemeDemoAction.
Adds ThemeNonprofitHealthCheck and a Theme management page contribution.

Runtime Surface

Area	Path
Provider	`src/NonprofitThemeServiceProvider.php`
Demo command	`src/Console/Commands/DemoCommand.php`
Demo action	`src/Actions/InstallNonprofitThemeDemoAction.php`
Renderer	Core `ViewSectionRenderer` extra view data
Theme management	`src/Manifest/ThemeManagementPageContribution.php`
Health check	`src/Health/ThemeNonprofitHealthCheck.php`
Views	`resources/views/page.blade.php`
CSS	`resources/css/theme-nonprofit.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 Campaign Studio, Form Builder, Events, or Blog are not installed.

Docs

Testing

Run package tests from the repository root:

vendor/bin/pest packages/theme-nonprofit/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 NonprofitThemeServiceProvider::definition() when section keys, presets, or optional integrations change.