Media & Asset Management
Menu Path: Tools > Media
The Media module is the centralized digital asset repository for your entire tenant. Whether you upload an artisan logo, a 21:9 event banner, a multi-image product gallery, or a PDF certificate, every file physically resides here and is delivered via an automated on-the-fly image optimization pipeline (resizeonfly).
📂 Media Explorer & Library​
The Media Explorer (/media) provides a desktop-class asset management interface:
- Folder Organization:
- Create structured nested folders (e.g.,
/products/summer-2026/,/events/stage-photos/) using the "New Folder" button. - Breadcrumb navigation at the top provides one-click traversal back to root or parent directories.
- Create structured nested folders (e.g.,
- Instant Live Search:
- Filter through thousands of media files instantly by file title or directory name.
- Asset Details & Quick Actions:
- Preview: Click any thumbnail to inspect high-resolution details in an overlay modal.
- Copy CDN URL: One-click copy of the public asset URL for use in external channels or markdown.
- Safe Deletion: Permanent deletion with safety confirmation modal.
🎨 Built-in Visual Editor (ImageEditor)​
AVCI CMS includes a canvas-grade image editor directly inside the media picker and asset inspector. You do not need third-party tools (like Photoshop or Figma) for standard crop and alignment adjustments:
- Preset Aspect Ratios:
Free: Custom free-form bounding box.1:1: Square (optimal for logos, user avatars, and merchant badges).16:9: Landscape (standard for featured thumbnails, blog headers, and video covers).21:9: Ultra-wide Cover (perfect for cinematic hero banners and profile headers).4:3: Standard photo aspect ratio.
- Rotation & Leveling:
- Quick 90° flip counter-clockwise and clockwise.
- Fine angle adjustment slider (-45° to +45°) to straighten tilted photos.
- Zoom & Pan: Smooth scaling from 0.1x to 3.0x with canvas center drag.
- Saving Workflow:
- Save: Replaces the current image with the cropped/edited version in place.
- Save as New: Preserves the original file and creates a new transformed asset.
🧩 In-Form Media Management (MediaManager)​
Form pages (Products, Places, Events, Blog, Organizations, Brands) leverage the unified MediaManager architecture:
- Responsive 2-Column Grid: When both a Logo and Featured Image are configured, they automatically align side-by-side (compact
max-w-[200px]square logo on the left,16:9featured image on the right) rather than blowing up into unconstrained 600px square blocks. - Cinematic Cover Banner: Wide
21:9aspect ratio container designed for page headers. - Drag-and-Drop Gallery (
GalleryInput):- Powered by
@dnd-kittouch and keyboard sensors. - Reorder images by grabbing the handle and dragging them into the desired display order.
- Upload multiple files simultaneously or pick them directly from the Media Library.
- Powered by
⚡ Dynamic On-The-Fly Resizing (resizeonfly)​
Instead of wasting storage by generating dozens of static thumbnails on upload, AVCI CMS transforms images on-the-fly:
GET /v1/:tenant/images/:type/:filename?w=400&f=webp&fit=inside
- Automatic WebP/AVIF Conversion: Serves next-generation lightweight formats based on browser capabilities.
- Immutable CDN Caching: Served with
Cache-Control: public, max-age=31536000, immutablefor maximum Lighthouse performance and sub-50ms edge delivery. - Frontend Helper:
import { getImageUrl } from '@/lib/utils/image';// Automatically generates CDN URL with ?w=300const thumbnailUrl = getImageUrl(product.logo, 300);