Skip to content

harvard-lts/mirador-annotations-auth-plugin

Repository files navigation

Mirador annotations authentication plugin

Node Unit Tests

A Mirador 4 plugin for including authentication cookies for annotations.

Compatibility

This plugin is Mirador 4-compatible (React 18/19, MUI 7). It is not backwards compatible with Mirador 3 — the upgrade contains breaking changes (top-level mirador imports, function/hook components, MUI 7 + Emotion styling).

Pin precisely by version convention:

  • Mirador 4 releases are tagged 2.x.
  • Mirador 3 releases are tagged 0.x or 1.x — pin one of these if you still need Mirador 3.

Requirements

Setup

  1. Run nvm use to ensure your version of matches that in the .nvmrc file
  2. Run npm i to install dependencies
  3. Use one of the NPM scripts to perform the actions described below.

NPM scripts

The following are some useful scripts can be ran using npm run <script>. A full list can be seen in package.json

Script Description
clean Removes the dist directories
build Builds the source files into the ./dist directory
serve Runs a local web server where the plugin can be viewed in a vanilla Mirador instance (helpful for testing and development)
test Runs the automated test suites

Installing in Mirador

The mirador-annotations-auth-plugin requires an instance of Mirador 4. Visit the Mirador wiki to learn how to create a Mirador 4 plugin and for additional information about plugins.

Package you will need to install:

npm i @harvard-lts/mirador-annotations-auth-plugin

Contribute

Mirador's development, design, and maintenance is driven by community needs and ongoing feedback and discussion. Join us at our regularly scheduled community calls, on IIIF slack #mirador, or the mirador-tech and iiif-discuss mailing lists. To suggest features, report bugs, and clarify usage, please submit a GitHub issue.

About

A Mirador 3 plugin for including authentication cookies for annotations

Resources

License

Stars

1 star

Watchers

9 watching

Forks

Packages

 
 
 

Contributors