Gallery

<Gallery> collects a set of story cards and presents them as a friendly grid. Each <Gallery.Item> supplies its own thumbnail, caption, and short summary, then opens a roomy popup where you can reuse Viewer, Map, ImageStory, prose, or any custom MDX block to add depth without sending readers to another page.

Use it when you want to highlight favorite works, curate a mini exhibit, or gather related pieces into a single scan. The example below pulls from the cached Northwestern manifests and shows how a reader can browse tiles at a glance, tap a card, and explore richer notes inside the popup.

<Gallery>  <Gallery.Item    manifest="https://api.dc.library.northwestern.edu/api/v2/works/b2ea19ef-f805-44d7-a29a-38f8de504906?as=iiif"    description="Opaque watercolors, likely lead white for the angarkha, indigo for the sash, and orpiment for the turban, describe a standing intermediary paused with parasol and folded textile. Against mica's neutral ground, the figure's stance, layered cloth, and restrained accessories demonstrate coastal mercantile dress codes and the portability of shade and textiles in humid streets."  >    <Viewer  iiifContent="https://api.dc.library.northwestern.edu/api/v2/works/b2ea19ef-f805-44d7-a29a-38f8de504906?as=iiif" />     The palette reflects circulating pigments in coastal India around 1800—lead white ground locally, indigo cakes exported through Surat, and orpiment imported from Burmese mines for saturated orange—each layer sitting as an opaque wash rather than a blended glaze, matching the fast production cycles of mica workshops serving visiting merchants and officials.     Compare the folded textile with Company-period export shawls: the parasol's green likely mixes malachite with gamboge, suggesting concern for sun exposure in humid ports, while the mica support ensured quick drying and portability, allowing compact sheets like this to travel to Calcutta or London as evidence of dress conventions that informed East India Company textile orders.   </Gallery.Item>  <Gallery.Item    manifest="https://api.dc.library.northwestern.edu/api/v2/works/2826e1b9-d38c-413d-b46f-4cd28d916b6d?as=iiif"    description="Mineral and vegetal pigments, perhaps orpiment, gamboge, and carbon black, map an itinerant musician balancing a spike fiddle against his chest. The taut bow and bundled cloth emphasize portable performance, while linear hatching on robe and sandals underscores how sound and movement traveled along pilgrimage roads."  >    <Viewer iiifContent="https://api.dc.library.northwestern.edu/api/v2/works/2826e1b9-d38c-413d-b46f-4cd28d916b6d?as=iiif" />        The orange robe likely layers orpiment with a thin realgar glaze—pigments circulated through Bengal trade—while the dark outlines may mix carbon black with iron-rich earth, and touches of crimson on the shoulder bag hint at lac dye bound with gum arabic, materials well suited to the mica surface that resists absorption.     By keeping the palette limited, the artist signals a devotional musician accustomed to itinerancy: the spike fiddle, or sarangi variant, and the bundled cloth over his shoulder suggest portability, as the paint tracks from turban ridge to bow arc echo the circulation of sound during bhakti gatherings, documenting both costume and the labor of sound making.   </Gallery.Item>  <Gallery.Item    manifest="https://api.dc.library.northwestern.edu/api/v2/works/cdb547e9-d5c1-4c1a-9ca5-b3fad0da4915?as=iiif"    description="Opaque washes, likely gamboge for the skirt, natural ultramarine for the shawl, and vermilion for accessories, concentrate on a seated embroiderer mid-stitch. The curtained canopy frames domestic labor as performance, and the spare red cap ties the scene to household economies and portable sartorial commissions."  >    <Viewer iiifContent="https://api.dc.library.northwestern.edu/api/v2/works/cdb547e9-d5c1-4c1a-9ca5-b3fad0da4915?as=iiif" />     The intense yellow likely derives from gamboge gum imported through Southeast Asian trade and layered over lead white to prevent cracking; her shawl's blue may point to natural ultramarine ground from Afghan lapis, while the red cap and ribbon probably rely on vermilion from cinnabar—pigments that signaled value to overseas patrons.     Within households supplying garments to Company brokers, mica studies like this documented both pattern and palette: the green valance situates her in a semi-public workspace, the spare tools underscore an economy built on portable equipment, and the white stitched arcs—tiny reserves where pigment was lifted before fully dry—reflect watercolor techniques circulating between Calcutta and London that turned embroidery into a record of color recipes for exporters.   </Gallery.Item></Gallery>

Implementers can organize gallery popups with any MDX content, but the <GalleryContent> component provides a simple wrapper to apply consistent gutters and an optional layout for side-by-side media and text. In the example below, we use flex={true} to place an ImageStory next to a descriptive aside, but you can mix and match Viewers, Maps, markdown, or any custom components as needed.

<Gallery>  <Gallery.Item    referencedManifests="https://api.dc.library.northwestern.edu/api/v2/works/009e37b7-5c36-4451-bafb-f1217f45877f?as=iiif"    caption="An Indian woman burning herself on the death of her husband"    title="An Indian woman burning herself on the death of her husband"    description="An Indian woman is powerfully poised over her deceased husband’s burning pyre, with a fist raised as part of the funeral ritual, suttee. For a Hindu widow, suttee was considered an honorable death, sparing societal disapproval and the loss of certain social liberties."  >    <GalleryContent flex={true}>      <ImageStory        iiifContent="https://manifest.storiiies-editor.cogapp.com/v3/c083t"        height="850"      />      <aside>        <dl>          <dt>Date</dt>          <dd>c. 1778</dd>          <dt>Creators</dt>          <dd>Artist, Samuel Wale (1721-1786), British</dd>          <dd>Engraver, Charles Grignion (1721-1810), British</dd>          <dt>Medium</dt>          <dd>Etching and Engraving</dd>          <dt>Image Size</dt>          <dd>29 x 17 cm</dd>          <dt>Sheet size</dt>          <dd>37 x 24 cm</dd>          <dt>Attribution</dt>          <dd>            Courtesy of Charles Deering McCormick Library of Special            Collections, Northwestern University.          </dd>          <dt>Call number</dt>          <dd>Special Collections, L2 Prints W169i</dd>        </dl>      </aside>    </GalleryContent>  </Gallery.Item>  <Gallery.Item    manifest="https://api.dc.library.northwestern.edu/api/v2/works/bf59dad4-76f9-4567-b0e2-3c6050663e2d?as=iiif"    caption="A Suttee: Preparing for the Immolation of a Hindoo Widow"    title="A Suttee: Preparing for the Immolation of a Hindoo Widow"    description="A bare-breasted woman draped in a white garment prepares for sati–a sacrifice in which a widow burns herself upon the death of her husband–amongst a crowd of Hindu worshippers at the ghats of river Vishwamitri against a backdrop of temples and shrines in the city of Baroda (present-day Vadodara). Although both British and Indian people had pushed for sati’s abolition, colonial powers often cited the brutal nature of the ritual as justification for their rule. The British government officially outlawed sati in 1829."  >    <GalleryContent flex={true}>      <ImageStory        iiifContent="https://manifest.storiiies-editor.cogapp.com/v3/0583o"        height="850"      />      <aside>        <dl>          <dt>Date</dt>          <dd>1844</dd>          <dt>Creators</dt>          <dd>Artist, Captain Robert Melville Grindlay (1786-1877), British</dd>          <dd>Engraver, James Redaway (1797-1858), British</dd>          <dt>Medium</dt>          <dd>Engraving</dd>          <dt>Image size</dt>          <dd>12.1 x 18.8 cm</dd>          <dt>Sheet size</dt>          <dd>21.1 (20.2) x 27.2 cm</dd>          <dt>Attribution</dt>          <dd>            Courtesy of Charles Deering McCormick Library of Special            Collections, Northwestern University.          </dd>          <dt>Call number</dt>          <dd>Special Collections, L1 Prints R3128s</dd>          <dt>Curator</dt>          <dd>Divya Chandrasekran</dd>        </dl>      </aside>    </GalleryContent>  </Gallery.Item></Gallery>

API

PropTypeRequiredNotes
titlestringOptional heading rendered above the grid.
descriptionstringShort intro paragraph under the heading.
popupSize'full', 'medium'Toggle fullscreen vs. windowed popup layout (default 'full').
order'default', 'random'Control figure ordering; random shuffles once during the build.
childrennodesOne or more <Gallery.Item> entries.
PropTypeRequiredNotes
titlestringPrimary caption text and popup heading.
summarystring · nodeShort description shown under the title (also reused inside the popup).
captionnodeProvide custom figcaption markup. When set, title/summary rendering is skipped.
metastring · string[]Supplemental metadata displayed under the caption and inside the popup header.
thumbnail/srcstringPreview image URL used in the grid. media remains as an alias for string sources.
thumbnailAltstringAlt text for the thumbnail image. Defaults to title.
referencedManifests / manifest(s)string · string[]Resolve manifests into derived labels, summaries, and thumbnails (overridden when props are provided).
slugstringOptional stable identifier for deep-linking popup IDs (hash uses #gallery-modal-*).
triggerLabelstringCustom accessible label for the figure trigger link.
popupTitlestringOverride the popup heading; falls back to title.
popupDescriptionstring · nodeOverride the popup description; falls back to summary/description.
childrennodesModal body content. Accepts any MDX component (Viewer, Map, ImageStory, markdown, etc).
PropTypeRequiredNotes
flexbooleanWhen true, the wrapper switches to a row-based flex layout.
childrennodesModal body markup. Works with any MDX content (Viewers, prose, etc.).