# @internetarchive/ia-item-navigator

> Internet Archive's Item Navigator, visually explore an item's contents.

Latest version **2.3.1** (published 2026-07-22) · AGPL-3.0-only license · 0 weekly downloads

## Install

```sh
npm install @internetarchive/ia-item-navigator
pnpm add @internetarchive/ia-item-navigator
yarn add @internetarchive/ia-item-navigator
bun add @internetarchive/ia-item-navigator
```

## Health

**Score 70/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.3.1 |
| Published | 2026-07-22 |
| First published | 2021-08-12 |
| Weekly downloads | 0 |
| License | AGPL-3.0-only |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 14 |
| Unpacked size | 403.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Internet Archive |
| Maintainers | bfalling, mitraardron, vbanos, kngenie, iisa, cdrini, nsharma123, dualcnhq, latonv, ibnesayeed, tracey.pooh, jim-at-ia, jeffwklein, rebecca-shoptaw, jbuckner, dhallia |

## Links

- npm: https://www.npmjs.com/package/@internetarchive/ia-item-navigator
- Repository: https://github.com/internetarchive/iaux-item-navigator
- Homepage: https://github.com/internetarchive/iaux-item-navigator#readme
- Issues: https://github.com/internetarchive/iaux-item-navigator/issues
- npm.io page: https://npm.io/package/@internetarchive/ia-item-navigator

## Dependencies (14)

- [lit](https://npm.io/package/lit.md) ^2.8.0
- [@internetarchive/icon-link](https://npm.io/package/@internetarchive/icon-link.md) ^1.4.0
- [@internetarchive/icon-email](https://npm.io/package/@internetarchive/icon-email.md) ^1.4.0
- [@internetarchive/icon-share](https://npm.io/package/@internetarchive/icon-share.md) ^1.4.0
- [@internetarchive/icon-tumblr](https://npm.io/package/@internetarchive/icon-tumblr.md) ^1.4.0
- [@internetarchive/icon-twitter](https://npm.io/package/@internetarchive/icon-twitter.md) ^1.4.0
- [@internetarchive/icon-ellipses](https://npm.io/package/@internetarchive/icon-ellipses.md) ^1.4.0
- [@internetarchive/icon-facebook](https://npm.io/package/@internetarchive/icon-facebook.md) ^1.4.0
- [@internetarchive/modal-manager](https://npm.io/package/@internetarchive/modal-manager.md) ^2.0.1
- [@internetarchive/icon-pinterest](https://npm.io/package/@internetarchive/icon-pinterest.md) ^1.4.0
- [@internetarchive/metadata-service](https://npm.io/package/@internetarchive/metadata-service.md) ^1.0.3
- [@internetarchive/icon-collapse-sidebar](https://npm.io/package/@internetarchive/icon-collapse-sidebar.md) ^1.4.0
- [@internetarchive/icon-visual-adjustment](https://npm.io/package/@internetarchive/icon-visual-adjustment.md) ^1.4.0
- [@internetarchive/shared-resize-observer](https://npm.io/package/@internetarchive/shared-resize-observer.md) ^0.2.0

## Recent versions

- 2.3.1 (latest) — 2026-07-22
- 2.3.0-0 (alpha) — 2026-01-09
- 2.1.3-alpha.1 (canary) — 2025-01-17
- 2.3.0 — 2026-07-22
- 2.2.3 — 2026-01-23
- 2.2.2 — 2026-01-08
- 2.2.1 — 2025-12-16
- 2.2.0 — 2025-12-16
- 2.1.3 — 2025-03-11
- 2.1.2 — 2024-02-15
- 2.1.1 — 2024-01-18
- 2.1.1-alpha3 — 2024-01-12
- 2.1.1-alpha2 — 2024-01-11
- 2.1.1-alpha1 — 2024-01-11
- 2.1.0 — 2024-01-05
- … 56 more at https://npm.io/package/@internetarchive/ia-item-navigator/versions

## README

[![Build Status](https://travis-ci.com/internetarchive/iaux-item-navigator.svg?branch=master)](https://travis-ci.com/internetarchive/iaux-item-navigator) [![codecov](https://codecov.io/gh/internetarchive/iaux-item-navigator/branch/master/graph/badge.svg)](https://codecov.io/gh/internetarchive/iaux-item-navigator)

# Internet Archive Item Navigator - theater menu manager

`<ia-item-navigator>` is a custom web component that makes an item's details theater.
The Item Navigator helps instantiate all of the components one needs to create an item theater:
- side menu
- menu shortcuts
- fullscreen management
- receives/creates a shared resize observer
- receives/shares a `<modal-manager>`
- slots for custom theater & header loads

The Item Navigator's primary responsibility is to display the side menus, shortcuts, and the theater in browser window immersion "fullscreen".

The main slot is shown by default.  If item has no theater, add `viewAvailable = false` property to show placeholder.

## Usage
Generic:
```
const iaItem = <MetadataResponse>;
<ia-item-navigator .item=${iaItem}></ia-item-navigator>
```

## Local Demo with `web-dev-server`
```bash
npm run start
```
To run a local development server that serves the basic demo located in `demo/index.html`

## Testing with Web Test Runner
To run the suite of Web Test Runner tests, run
```bash
npm run test
```

To run the tests in watch mode (for &lt;abbr title=&#34;test driven development&#34;&gt;TDD&lt;/abbr&gt;, for example), run

```bash
npm run test:watch
```

## Linting with ESLint, Prettier, and Types
To scan the project for linting errors, run
```bash
npm run lint
```

You can lint with ESLint and Prettier individually as well
```bash
npm run lint:eslint
```
```bash
npm run lint:prettier
```

To automatically fix many linting errors, run
```bash
npm run format
```

You can format using ESLint and Prettier individually as well
```bash
npm run format:eslint
```
```bash
npm run format:prettier
```

---
_Source: https://npm.io/package/@internetarchive/ia-item-navigator · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
