Media & files

Featured images

Uploaded through each content form (posts, publications, slides, team, etc.). Spatie Media Library stores files under media-library and generates preview / responsive WebP conversions for performance.

Image manipulations for conversions use Laravel’s first-party Illuminate\Support\Facades\Image API (backed by intervention/image v4 as the GD/Imagick engine). Spatie Media Library still owns collections/conversions; do not call Intervention APIs directly in app code.

Prefer:

• Reasonable source dimensions (avoid multi‑MB originals when possible)
• JPEG/PNG/WebP
• Meaningful crops for thumbnails

Attachments / PDFs

Posts and publications can attach downloadable files. PDFs may be optimised on upload for posts. Ensure the file field is filled if the public template expects a download link.

Sliders

Sliders belong to a page (usually Home). Slides hold title, subtitle, and image for the home carousel.

Orphaned files

Maintenance in the admin sidebar scans for uploads that are no longer referenced and can dry-run or delete them. Prefer a dry-run first on staging/production. This is separate from day-to-day featured-image uploads on content forms.