Media Library

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/media-library
Package slug	media-library
Product group	Capell Foundation
Tier	free
Bundle	foundation
Runtime contexts	admin
Capell version	^1.0
Catalogue role	extension
Release channel	Released
Source repository	capell-app/packages
Source path	packages/media-library
Docs source	packages/media-library/docs
Manifest	capell.json

What This Plugin Adds

Media Library is an Available, No schema impact Capell package in the Capell Foundation product group. It ships as capell-app/media-library and extends these surfaces: admin.

Media Library provides a Curator-backed asset library with shared picking, folders, search, alt text, rights metadata, and media health checks.

Editors can upload, organize, find, describe, and reuse assets from one library. The media health page identifies missing alt text, stale assets, and unused records.

Status details:

• Status: Available
• Tier: free
• Bundle: foundation
• Composer package: capell-app/media-library
• Namespace: Capell\MediaLibrary
• Theme key: not applicable

Why It Matters

For developers: The Curator model and query factory give packages a shared media boundary, with migration and SVG sanitization handled by dedicated Actions.

For teams: Teams can reuse approved assets, improve alt-text coverage, and find media records that need cleanup from one admin workflow.

Screens And Workflow

Screenshot contract: docs/screenshots.json.

• Media health page (admin, required evidence).
• Media health table (admin, required evidence).
• Curator media field inside a form (admin, required evidence).
• Migration command output or report (console, supplementary evidence).
• Media health page with admin sidebar menu open (admin, supplementary evidence).

Technical Shape

Service providers

• Capell\MediaLibrary\MediaLibraryServiceProvider

Config files

• packages/media-library/config/media-library.php

Models

• CuratorMedia

Filament classes

• CuratorMediaFieldFactory
• MediaHealthPage
• MediaHealthTable

Events

• MediaMissingAltDetected

Actions

• BuildDuplicateMediaQueryAction
• BuildMediaHealthQueryAction
• BuildMediaHealthTotalsAction
• BuildMediaUsageDrilldownAction
• BuildMissingAltMediaQueryAction
• BuildMissingRightsMetadataQueryAction
• BuildOrphanMediaQueryAction
• DeleteOrphanMediaRecordsAction
• DiscoverOwnerForeignKeysAction
• ResolveOwnerForeignKeysAction
• DispatchMissingAltMediaSignalsAction
• EnsureMediaLibraryPermissionsAction
• MigrateSpatieMediaToCuratorAction
• SanitizeSvgUploadAction

Data objects

• MediaHealthIssuesData
• MediaHealthTotalsData
• MediaOwnerForeignKeyData
• MediaUsageReferenceData
• MigrateSpatieMediaInput
• MigrateSpatieMediaResult

Jobs

• CalculateMediaChecksumJob

Manifest action API

• buildDuplicateMediaQuery: Capell\MediaLibrary\Actions\DashboardReports\BuildDuplicateMediaQueryAction
• buildMediaHealthQuery: Capell\MediaLibrary\Actions\DashboardReports\BuildMediaHealthQueryAction
• buildMediaHealthTotals: Capell\MediaLibrary\Actions\DashboardReports\BuildMediaHealthTotalsAction
• buildMediaUsageDrilldown: Capell\MediaLibrary\Actions\DashboardReports\BuildMediaUsageDrilldownAction
• buildMissingAltMediaQuery: Capell\MediaLibrary\Actions\DashboardReports\BuildMissingAltMediaQueryAction
• buildMissingRightsMetadataQuery: Capell\MediaLibrary\Actions\DashboardReports\BuildMissingRightsMetadataQueryAction
• buildOrphanMediaQuery: Capell\MediaLibrary\Actions\DashboardReports\BuildOrphanMediaQueryAction
• deleteOrphanMediaRecords: Capell\MediaLibrary\Actions\DashboardReports\DeleteOrphanMediaRecordsAction
• dispatchMissingAltMediaSignals: Capell\MediaLibrary\Actions\DispatchMissingAltMediaSignalsAction
• migrateSpatieMediaToCurator: Capell\MediaLibrary\Actions\MigrateSpatieMediaToCuratorAction

Console command classes

• MigrateSpatieToCuratorCommand

Manifest contributions

• admin-page: Capell\MediaLibrary\Manifest\MediaHealthPageContribution
• configurator: Capell\MediaLibrary\Manifest\MediaMigrationCommandContribution
• health-check: Capell\MediaLibrary\Manifest\MediaLibraryHealthContribution
• model: Capell\MediaLibrary\Manifest\CuratorMediaModelContribution

Health checks

• Capell\MediaLibrary\Health\MediaLibraryHealthCheck

Media Handling Contract

Media Library wraps Awcodes Curator as the Capell media backend and does not generate responsive conversions. Curator-backed media exposes configured URLs and metadata; responsive variant generation must come from another package or host implementation.

Evidence and wording rules:

• The capture contract is docs/screenshots.json.
• The committed screenshot captures show seeded media-health and Curator field workflows.
• Do not describe this package as generating responsive variants.
• Keep migration and media-health claims tied to the Curator model, health page, table, field factory, and migration command.

Data Model

This package has no schema impact. It extends Capell through admin-page contributions, configurator contributions, health-check contributions, and model contributions instead of declaring package-owned tables.

Install Impact

• Required packages: capell-app/admin, capell-app/core.
• Admin navigation: declares admin-page: MediaHealthPageContribution; each Filament page or resource controls its own navigation visibility.
• Admin/editor extensions: configurator: MediaMigrationCommandContribution.
• Permissions: View:MediaHealthPage, Delete:MediaHealthPage.
• Public routes: none declared.
• Database changes: no package migrations declared.
• Config: config/media-library.php.
• Settings: no package settings declared.
• Queues or schedules: queue jobs CalculateMediaChecksumJob.
• Cache tags: none declared.
• Commands: console command classes detected: MigrateSpatieToCuratorCommand.

Common Pitfalls

• Keep required Capell packages on compatible v4 releases: capell-app/admin, capell-app/core.
• Review package configuration before production-like verification: config/media-library.php.

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
Background work does not run	Queue worker or declared schedule is not active	Check the jobs and scheduled commands listed in Technical Shape	Start the queue worker or host scheduler, then run the focused command or package test

Quick Start

1. Install the package: composer require capell-app/media-library.
2. Open the package admin surface at /admin/media-library/media-health and confirm Media Library is available.

Next Steps

• Package docs
• Overview
• Worked extension examples
• Admin guide
• Configuration files: config/media-library.php.
• Troubleshooting
• Screenshot contract
• Marketplace assets
• Capell content language plan
• Capell documentation design system
• Capell and package ERD notes
• Related packages: Media Ai, Seo Suite.