Skip to main content

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:

  1. 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.
  2. Instant Live Search:
    • Filter through thousands of media files instantly by file title or directory name.
  3. 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:9 featured image on the right) rather than blowing up into unconstrained 600px square blocks.
  • Cinematic Cover Banner: Wide 21:9 aspect ratio container designed for page headers.
  • Drag-and-Drop Gallery (GalleryInput):
    • Powered by @dnd-kit touch 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.

⚡ 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, immutable for maximum Lighthouse performance and sub-50ms edge delivery.
  • Frontend Helper:
    import { getImageUrl } from '@/lib/utils/image';

    // Automatically generates CDN URL with ?w=300
    const thumbnailUrl = getImageUrl(product.logo, 300);