Skip to content
Capell CMS

Velocity Theme

Status: Available, no schema impact · Kind: theme · Tier: premium · Bundle: themes · Contexts: frontend · Product group: Capell Themes

This page documents the renderer-only Velocity theme package from the code that ships in this repository. The package keeps the existing Composer package and saas theme key while replacing the old visual layer with the Velocity product-led direction.

What This Package Adds

Section titled “What This Package Adds”

Velocity is a standalone Capell theme package. It registers the saas theme key, extends Foundation Theme, and adds product-focused renderer views for software and subscription sites.

  • Velocity theme service provider.
  • Theme renderer/views for Velocity page output.
  • Section Blade views for navigation, hero, features, proof, content listing, comparison, calculator, CTA, footer, and blog.
  • Blog index and article Blade views for Blog-aware rendering.
  • Dependency on Foundation Theme.

Developer Notes

Section titled “Developer Notes”

Adds a renderer package that uses Foundation Theme runtime contracts while leaving content models unchanged.

  • SaasThemeServiceProvider registers the Velocity renderer.
  • capell.json declares themeKey: "saas" and extends: "capell-app/foundation-theme".
  • Uses Foundation Theme runtime data and standard section keys, while rendering its own page and section Blade views.
  • Ships Blade resources for the page wrapper, standard theme sections, comparison, calculator, blog section, and blog page views.
  • No migrations, config, routes, models, admin navigation, or package-owned settings are present.
  • Public theme output must not expose package identifiers, signed admin URLs, Filament/editor markers, or other authoring metadata. The package test renders every section and checks for those leak tokens.

Operational Notes

Section titled “Operational Notes”

Provides a Velocity visual option for product sites managed through the normal Theme admin page and install flow.

  • Adds the Velocity renderer to the theme system.
  • No database changes.
  • No admin navigation by itself.
  • No public routes by itself.

Data And Retention

Section titled “Data And Retention”
  • This package does not own data.
  • It consumes theme runtime settings and core page content.

Screenshot Plan

Section titled “Screenshot Plan”
  • Theme admin list showing Velocity.
  • Frontend page rendered with Velocity at /theme-saas-demo.
  • Theme preview URL output from capell.admin.theme-preview.

Pitfalls

Section titled “Pitfalls”
  • Install Layout Builder before Foundation Theme in a disposable harness; Foundation Theme setup expects the layout stack to be available.
  • Install Foundation Theme before using this renderer.
  • Build both frontend and Filament assets. Missing Foundation Theme manifests make screenshots fail even when the Composer install succeeds.
  • Keep Theme Studio settings aligned with activeTheme: "saas" and the velocity preset. Stale settings from another theme can render the wrong token set.
  • Do not install a Studio metapackage; this package installs independently.

Verification

Section titled “Verification”
  • Run vendor/bin/pest packages/theme-saas/tests --configuration=phpunit.xml.
  • In a disposable Capell app, install only the core stack, Layout Builder, Foundation Theme, and capell-app/theme-saas.
  • Open /theme-saas-demo anonymously and scan the response for capell-theme, data-capell-theme, theme-saas, signed, filament, editor, and /admin.
  • Capture the screenshots listed in screenshots.json.

Package Manifest

Section titled “Package Manifest”
  • Composer name: capell-app/theme-saas
  • Theme key: saas
  • Product group: Capell Themes
  • Kind: theme
  • Tier: premium
  • Bundle: themes
  • Contexts: frontend
  • Requires: capell-app/foundation-theme
  • Optional dependencies: capell-app/blog

Admin Surfaces

Section titled “Admin Surfaces”
  • Core Themes resource: ThemeResource:index. This is a core/admin surface that lists the installed SaaS theme once the package is installed.

Commands

Section titled “Commands”
  • Disposable screenshot route used by the audit harness: /theme-saas-demo. The package itself does not register this route.

Routes And Config

Section titled “Routes And Config”
  • None proven in this package directory.

Permissions And Gates

Section titled “Permissions And Gates”
  • None proven in this package directory.

Migrations

Section titled “Migrations”
  • None proven in this package directory.

ERD Excerpt

Section titled “ERD Excerpt”

This package has no committed ERD excerpt. Use implementation notes and extension points instead of inventing schema.

Screenshot Automation

Section titled “Screenshot Automation”

Deployment should read screenshots.json, install the package with demo data, resolve each admin surface or frontend URL, and write images to public/docs/screenshots/packages/theme-saas.

  • Theme admin list showing Velocity.
  • Frontend page rendered with Velocity.
  • Theme preview URL output.