Record Switcher

Package docs status

This page is generated from package source documentation in the Capell packages repository and the checked-in manifest. Source documentation is not distribution status. Before running a Composer command, verify that the exact package and compatible 1.x release are available through public Packagist or the authenticated marketplace account.

Field	Value
Composer package	`capell-app/record-switcher`
Package slug	`record-switcher`
Product group	Capell Foundation
Tier	free
Bundle	`foundation`
Runtime contexts	`admin`
Capell version	`^1.0`
Catalogue role	extension
Release channel	Beta
Source repository	`capell-app/packages`
Source path	`packages/record-switcher`
Docs source	`packages/record-switcher/docs`
Manifest	`capell.json`

What This Plugin Adds

Record Switcher is an Available, No schema impact Capell package in the Capell Foundation product group. It ships as capell-app/record-switcher and extends these surfaces: admin.

Record Switcher adds a compact selector to supported Filament record headings so users can move between nearby records without returning to the list page.

On supported edit pages, admin users can search the current resource and open another permitted record from the heading.

Status details:

Status: Available
Tier: free
Bundle: foundation
Composer package: capell-app/record-switcher
Namespace: Capell\RecordSwitcher
Theme key: not applicable

Why It Matters

For developers: A focused query Action builds authorized labels and URLs, keeping resource discovery and option construction outside the heading extension.

For teams: Editors can review or update a sequence of records with fewer trips through index pages.

Screens And Workflow

Screenshot contract: docs/screenshots.json.

Record Switcher admin heading suggestions

Record Switcher admin heading suggestions (admin, required evidence).
Record Switcher empty search state (admin, supplementary evidence).
Record Switcher cross-site page suggestions (admin, supplementary evidence).

Technical Shape

Service providers

Capell\RecordSwitcher\Providers\RecordSwitcherServiceProvider

Filament classes

RecordSwitcherHeadingExtender

Livewire components

RecordSwitcher

Actions

BuildRecordSwitcherOptionsAction
PrepareRecordSwitcherScreenshotAction

Data objects

RecordSwitcherOptionData

Manifest contributions

asset: Capell\RecordSwitcher\Manifest\RecordSwitcherAssetsContribution
health-check: Capell\RecordSwitcher\Manifest\RecordSwitcherHealthContribution

Health checks

Capell\RecordSwitcher\Health\RecordSwitcherHealthCheck

Blade views

packages/record-switcher/resources/views/components/record-switcher.blade.php

Data Model

This package has no schema impact. It extends Capell through asset contributions and health-check contributions instead of declaring package-owned tables.

Install Impact

Required packages: capell-app/admin, capell-app/core.
Admin navigation: no admin page or resource contribution is declared.
Admin/editor extensions: none declared.
Permissions: no package permission declarations or Shield gates detected; host access rules still apply.
Public routes: none declared.
Database changes: no package migrations declared.
Config: no package config files.
Settings: no package settings declared.
Queues or schedules: none declared.
Cache tags: none declared.
Commands: none declared.

Common Pitfalls

Keep required Capell packages on compatible v4 releases: capell-app/admin, capell-app/core.

Troubleshooting

Symptom	Likely cause	Check	Fix
Package surface is missing after install	Provider or manifest is not loaded	Confirm `capell.json`, package `composer.json`, and provider registration	Reinstall the package, refresh Composer autoload, and clear host caches

Quick Start

Install the package: composer require capell-app/record-switcher.
Verify the package provider and manifest contributions are registered in the host app.