Docs

    Media gallery pattern

    Use split galleries by default when photos and videos should appear in distinct sections.

    Standard

    - Use `SplitMediaGallerySection` when photos and videos must render in separate sections (default recommendation).

    - Use `MediaGallerySection` for mixed photo and video sections when a unified gallery is desired.

    - Keep media items in normalized arrays and pass them as props.

    - Keep `showFilters` optional and default to user-friendly category groups.

    - Core media visibility must not depend on JavaScript.

    - Use optional photo lightbox as enhancement only, not as primary access path.

    - Lightbox navigation (prev/next controls + keyboard arrows) is part of the standard behavior.

    - Optional page behaviors (shuffle, max photos/videos, info notice, social CTA) are module props.

    Reference

    - Live example: Media gallery example page

    - Component: `template/src/components/patterns/MediaGallerySection.tsx`

    - Wrapper: `template/src/components/patterns/SplitMediaGallerySection.tsx`