> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nycadultedlabels.nyc/llms.txt
> Use this file to discover all available pages before exploring further.

# Screenshot checklist

> Production screenshots in the docs, plus how to re-capture.

Use PNG or WebP for final screenshots (recommended width **1200–1400px**). Store files under `docs/images/screenshots/` and reference them from MDX with `<Frame>`.

<Tip>
  On macOS: **Cmd+Shift+4** then Space to capture a window. Prefer demo accounts; avoid publishing real student PII when possible.
</Tip>

## Screenshots in the docs (production)

| File                        | Used on                                                                                                                           |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `sign-in.png`               | [Quickstart](/quickstart)                                                                                                         |
| `app-shell-sidebar.png`     | [Quickstart](/quickstart), [Data Lead tools](/admin/data-lead-tools)                                                              |
| `public-student-page.png`   | [QR codes](/reference/qr-codes), [Labels](/workflows/labels-and-scanning)                                                         |
| `public-archive-box.png`    | [QR codes](/reference/qr-codes), [Archive](/storage/archive-and-school-year), [Labels](/workflows/labels-and-scanning)            |
| `archive-box-label.png`     | [QR codes](/reference/qr-codes), [Archive](/storage/archive-and-school-year)                                                      |
| `intake-form.png`           | [Intake](/workflows/intake), [Quickstart](/quickstart)                                                                            |
| `intake-translate-tip.png`  | [Intake](/workflows/intake)                                                                                                       |
| `intake-returning.png`      | [Intake](/workflows/intake)                                                                                                       |
| `intake-duplicates.png`     | [Intake](/workflows/intake), [Duplicates](/workflows/duplicates-and-siblings)                                                     |
| `intake-fix-dialog.png`     | [Intake](/workflows/intake)                                                                                                       |
| `cabinets-page.png`         | [Cabinets](/storage/cabinets-and-drawers)                                                                                         |
| `cabinet-health.png`        | [Cabinets](/storage/cabinets-and-drawers)                                                                                         |
| `label-stock.png`           | [Label stock](/admin/label-stock)                                                                                                 |
| `school-year-rollover.png`  | [Archive](/storage/archive-and-school-year)                                                                                       |
| `admin-school-settings.png` | [Archive](/storage/archive-and-school-year), [Data Lead tools](/admin/data-lead-tools)                                            |
| `admin-all-students.png`    | [Address verification](/reference/address-and-verification), [Data Lead tools](/admin/data-lead-tools), [Quickstart](/quickstart) |
| `duplicates-page.png`       | [Duplicates](/workflows/duplicates-and-siblings)                                                                                  |
| `enrollment-dashboard.png`  | [Enrollment](/admin/enrollment-dashboard)                                                                                         |
| `email-validation.png`      | [Email validation](/workflows/email-validation)                                                                                   |
| `bulk-upload.png`           | [Bulk upload](/reference/bulk-upload)                                                                                             |
| `bulk-upload-preview.png`   | [Bulk upload](/reference/bulk-upload)                                                                                             |
| `avery-label-sheet.png`     | [Labels](/workflows/labels-and-scanning)                                                                                          |
| `avery-print-preview.png`   | [Labels](/workflows/labels-and-scanning)                                                                                          |
| `dashboard.png`             | [Data Lead tools](/admin/data-lead-tools), checklist                                                                              |

Optional older captures still in the folder:

* `intake-archived-file.png` — File Assignment for archived returning students
* `intake-success-legacy.png` — replace with new success summary + P2G card after that UI is deployed

## Nice-to-have next

| Capture                           | Suggested filename            | Page                                                 |
| --------------------------------- | ----------------------------- | ---------------------------------------------------- |
| Intake success summary + P2G card | `intake-success.png`          | [Intake](/workflows/intake)                          |
| Cabinets floor map dialog         | `cabinets-floor-map.png`      | [Cabinets](/storage/cabinets-and-drawers)            |
| Archive packing preview           | `archive-packing-preview.png` | [Archive](/storage/archive-and-school-year)          |
| Drawer roster by-section drag     | `drawer-roster-sections.png`  | [Cabinets](/storage/cabinets-and-drawers)            |
| School portal sign-in badge       | `sign-in-school-portal.png`   | [School subdomains](/contributors/school-subdomains) |

## Capture from production

```bash theme={null}
# Load DOCS_SCREENSHOT_* from .env, then:
set -a && source .env && set +a
export BASE_URL=https://nycadultedlabels.nyc
# Optional if the account requires MFA:
# export DOCS_SCREENSHOT_MFA=123456
NODE_PATH=./tmp-playwright/node_modules node scripts/capture-docs-screenshots.cjs
```

<Warning>
  Put credentials in `.env` as plain `KEY=value` lines (no wrapping quotes or trailing `\`). `.env` is gitignored.
  Re-capture **dashboard** and **app-shell-sidebar** after UI shell changes so Mintlify matches production.
</Warning>

## How to add a screenshot

<Steps>
  <Step title="Capture the screenshot">
    Open the live app, navigate to the screen, and capture at full width.
  </Step>

  <Step title="Save the file">
    Save as `docs/images/screenshots/your-name.png`.
  </Step>

  <Step title="Update the MDX page">
    ```mdx theme={null}
    <Frame caption="Short description of what the reader should notice">
      <img src="/images/screenshots/your-name.png" alt="Accessible description" />
    </Frame>
    ```
  </Step>

  <Step title="Preview and deploy">
    Run `npm run docs:dev`, verify locally, then push for Mintlify to deploy.
  </Step>
</Steps>

## Mintlify Frame tips

From [Mintlify Frames](https://www.mintlify.com/docs/content/components/frames):

* Always wrap screenshots in `<Frame>` for consistent borders and captions
* Use `caption` for what the image shows; Markdown links are allowed in captions
* Keep `alt` text specific (role + page + key UI elements)