About

Using IIIF Presentation Collection(s) as a data source, Canopy IIIF (Canopy) generates a scholarly digital projects platform that transforms provided digital collections into an accessible, discoverable research environment. Built on modern web standards and leveraging the interoperability of IIIF, Canopy creates static sites that extend existing IIIF resources while providing advanced localized search capabilities, contextual navigation, and customizable presentation layers.

Have an idea for a project?

Overview

Picture two source IIIF collections with digitized items relating to a famous author: Collection A providing 70 manifests and Collection B contributing 35 more. A team is tasked with building out a unified digital project for these items that allows users to browse their content, as well aso interact with contextual essays, timelines, and maps. By using Canopy, impementers can quickly stand-up a working projecty with every manifest becoming its own work page, authored Markdown files providing context, and both streams feeding a shared search index before everything is written out to static HTML, CSS, and data assets. The diagram below walks through that pipeline so you can see how these raw manifests become a ready-to-host digital project.

IIIF Collection(s)

Source collections contribute 105 total manifests that Canopy retrieves as-is via IIIF endpoints.

Collection A

  • 70 Manifests
  • IIIF Images + A/V
  • Textual Annotations

Collection B

  • 35 Manifests
  • IIIF Images + A/V
  • Textual Annotations

Canopy Build Process

Canopy syncs manifests, page content, and annotations before bundling the site.

Automated content

  • 105 manifests → 105 work pages
  • One page per manifest
  • Customize page layout

Contextual content

  • Markdown & MDX pages
  • Author narratives & tours
  • Reference manifests inline

Search index

  • Combines works + pages
  • Customize result layout
  • Optional annotations

Static Digital Project

The output is a lightweight bundle of HTML, CSS, JS, and JSON assets that can deploy anywhere.

Work pages

  • 105 generated HTML pages
  • Each links back to source manifests
  • Styled with Canopy components

Custom pages

  • Markdown & MDX-authored content
  • Reusable layouts for narratives
  • Embed IIIF media & interstitials

Search bundle

  • Static FlexSearch index
  • Works + pages share records
  • Optional annotation dataset

Comprehensive documentation is integrated into the application and serves as both a development guide and a demonstration of Canopy's potential for digital scholarship and humanities projects. To highlight what Canopy can do, this paragraph is authored in markdown from a simple text file and below is an example of an <Image> component rendering a IIIF image resource along with an inline annotation and caption. This same image is provided by Northwestern University Libraries as a IIIF Manifest from their Digital Collections platform and aggregated into this project as a static page during the Canopy build process.

The town & pass of Boondi, in Rajpootana - Situated on a southern slope of a hill at the end of a long range, the town of Boondi was the capital of the Rajput principality of that name. The palace of the Raja is a large masonry stone building about half way up the hill, according to Grindlay, with a kind of fortification extending to the top.

As authors create content using Markdown, they can reference the source material directly within the text using the <ReferencedItems /> component below. This component dynamically generates a list of all IIIF Manifests that have been explicitly referenced within the markdown content of the page.

Colophon

Canopy was created by Mat Jordan (Northwestern University) and Mark Baggett (Texas A&M University) as a method to quickly build exhibit style digital humanities projects that extend existing digital collections using IIIF Collections and Manifests. It continues to be an active open-source initiative of Northwestern University Libraries, where it supports digital scholarship in many forms. This example site is built from the Donald K. Adams and Lawrence D. Stewart Collection of Prints and the Indian Paintings on Mica collection hosted by Northwestern University Libraries' Digital Collections.

Canopy uses the IIIF Presentation API to deliver rich media from providing institutions, Markdown as MDX for authoring contextual content and layout, TailwindCSS for the user interface, and a static FlexSearch index for search. Easy aggregation and retrieval of IIIF resources is made possible by the IIIF helpers developed by Stephen Fraser. In addition, Clover IIIF, developed by Northwestern University Libraries with contributions from other institutions, is integral to Canopy and provides the rendering of IIIF resources, annotations, and metadata throughout the interface.