# MailglassAdmin v1.7.0 - Table of Contents

Mountable LiveView dashboard for mailglass — dev preview + admin

## Pages

- Overview
  - [mailglass_admin](readme.md)

- Design
  - [mailglass_admin Design System](design-system.md)

- Contract
  - [Operator Trust](operator-trust.md)
  - [API Stability — mailglass_admin](api_stability.md)
  - [Compatibility and Deprecations](compatibility-and-deprecations.md)

## Modules

- [MailglassAdmin.Components](MailglassAdmin.Components.md): Brand-book-aligned shared UI atoms used throughout mailglass_admin.
- [MailglassAdmin.Controllers.Assets](MailglassAdmin.Controllers.Assets.md): Compile-time asset server for the mailglass_admin preview dashboard.
- [MailglassAdmin.GalleryLive](MailglassAdmin.GalleryLive.md): Dev-only component gallery at /dev/mail/gallery.
- [MailglassAdmin.Inbound.DestructiveAction](MailglassAdmin.Inbound.DestructiveAction.md): Action-time authorization helper for destructive inbound work (replay).
- [MailglassAdmin.Inbound.DetailHeader](MailglassAdmin.Inbound.DetailHeader.md): Selected inbound-record summary header.
- [MailglassAdmin.Inbound.EvidenceCard](MailglassAdmin.Inbound.EvidenceCard.md): Evidence card (IADM-02 raw half) — raw provider source, default-redacted.
- [MailglassAdmin.Inbound.FiltersForm](MailglassAdmin.Inbound.FiltersForm.md): Compact filter controls for the inbound records screen.
- [MailglassAdmin.Inbound.Overview](MailglassAdmin.Inbound.Overview.md): Read-only summary tier for the inbound operator surface.

- [MailglassAdmin.Inbound.RecordsList](MailglassAdmin.Inbound.RecordsList.md): Recent inbound records list with semantic selected-row treatment.
- [MailglassAdmin.Inbound.ReplayModal](MailglassAdmin.Inbound.ReplayModal.md): Server-rendered replay confirmation modal for the inbound record detail view.
- [MailglassAdmin.Inbound.RoutingTrace](MailglassAdmin.Inbound.RoutingTrace.md): Routing-trace card (IADM-04) — the one novel inbound surface.
- [MailglassAdmin.Inbound.Timeline](MailglassAdmin.Inbound.Timeline.md): Read-only execution-lineage timeline for one inbound record, chronological.
- [MailglassAdmin.InboundLive](MailglassAdmin.InboundLive.md): Read-only operator dashboard for recent inbound records, execution lineage,
and routing reflection (IADM-01/02/07).
- [MailglassAdmin.Operator.DeliveriesList](MailglassAdmin.Operator.DeliveriesList.md): Recent deliveries list with semantic selected-row treatment.

- [MailglassAdmin.Operator.DestructiveAction](MailglassAdmin.Operator.DestructiveAction.md): Shared action-time authorization helper for destructive operator work.
- [MailglassAdmin.Operator.DetailHeader](MailglassAdmin.Operator.DetailHeader.md): Selected delivery summary header.

- [MailglassAdmin.Operator.FiltersForm](MailglassAdmin.Operator.FiltersForm.md): Compact filter controls for the operator deliveries screen.

- [MailglassAdmin.Operator.RepairState](MailglassAdmin.Operator.RepairState.md): Shared presenter for operator-facing replay availability and outcome wording.

- [MailglassAdmin.Operator.ReplayModal](MailglassAdmin.Operator.ReplayModal.md): Server-rendered replay confirmation modal for the operator delivery detail view.

- [MailglassAdmin.Operator.Shell](MailglassAdmin.Operator.Shell.md): Shared application shell for the operator surface — the chrome wrapping both
`MailglassAdmin.OperatorLive` (deliveries) and `MailglassAdmin.InboundLive`
(inbound records). The two screens mount in the SAME operator `live_session`
(one `Operator.Mount` + Auth gate), so a shared shell is a within-surface
concern, not a cross-mount one — it never reaches the dev-preview surface.
- [MailglassAdmin.Operator.SupportCards](MailglassAdmin.Operator.SupportCards.md): Read-only tenant-scoped support cues for the selected delivery context.
- [MailglassAdmin.Operator.SuppressionCard](MailglassAdmin.Operator.SuppressionCard.md): Suppression visibility card with reversibility copy.

- [MailglassAdmin.Operator.Timeline](MailglassAdmin.Operator.Timeline.md): Read-only delivery timeline in chronological order.

- [MailglassAdmin.OperatorLive](MailglassAdmin.OperatorLive.md): Read-only operator dashboard for recent deliveries, timeline history,
and suppression visibility.
- [MailglassAdmin.OptionalDeps.MailglassInbound](MailglassAdmin.OptionalDeps.MailglassInbound.md): Runtime gateway for all `mailglass_inbound` access from `mailglass_admin`
(CONTEXT the design contract / the design contract).
- [MailglassAdmin.OptionalDeps.PhoenixLiveReload](MailglassAdmin.OptionalDeps.PhoenixLiveReload.md): Gateway for the optional `{:phoenix_live_reload, "~> 1.6"}` dep
(CONTEXT the design contract, dev-only).
- [MailglassAdmin.Preview.AssignsForm](MailglassAdmin.Preview.AssignsForm.md): Type-inferred assigns form per 05-UI-SPEC §"Assigns form — type-inferred
fields" (lines 354-368) + 05-RESEARCH.md lines 1470-1571.
- [MailglassAdmin.Preview.CaptureManifest](MailglassAdmin.Preview.CaptureManifest.md): Deterministic manifest/checkpoint contract writer for preview capture output.

- [MailglassAdmin.Preview.CaptureMatrix](MailglassAdmin.Preview.CaptureMatrix.md): Deterministic matrix builder for preview capture targets.

- [MailglassAdmin.Preview.CaptureState](MailglassAdmin.Preview.CaptureState.md): Canonical capture-state value for deterministic preview screenshot targets.

- [MailglassAdmin.Preview.Chromium](MailglassAdmin.Preview.Chromium.md): Deterministic Chromium CLI wrapper for preview screenshot capture.

- [MailglassAdmin.Preview.DeviceFrame](MailglassAdmin.Preview.DeviceFrame.md): Device-width segmented control: three buttons (375 / 768 / 1024) that
drive the iframe's inline `width` style per 05-UI-SPEC lines 267-280.
- [MailglassAdmin.Preview.Discovery](MailglassAdmin.Preview.Discovery.md): Reflection for mailable modules — finds `use Mailglass.Mailable` modules,
reads their `preview_props/0` callback if present, and returns the pair
ready for the preview dashboard sidebar.
- [MailglassAdmin.Preview.Mount](MailglassAdmin.Preview.Mount.md): `on_mount` hook the Router macro appends after any adopter-provided
`:on_mount` hooks. Reads the whitelisted session `"mailables"` value
populated by the router's preview session callback and runs discovery
before the preview LiveView finishes mounting.
- [MailglassAdmin.Preview.Sidebar](MailglassAdmin.Preview.Sidebar.md): Sidebar function component: mailable list with collapsible scenario
groups + status badges.
- [MailglassAdmin.Preview.Tabs](MailglassAdmin.Preview.Tabs.md): Tabs function component: HTML · Text · Raw · Headers tab strip plus
the matching content pane per 05-UI-SPEC lines 220-228 + 294-352.
- [MailglassAdmin.PreviewLive](MailglassAdmin.PreviewLive.md): The single dev-preview LiveView surface (PREV-03..PREV-05).
- [MailglassAdmin.PubSub.Topics](MailglassAdmin.PubSub.Topics.md): Typed topic builder for `mailglass_admin` PubSub broadcasts. Every topic is
prefixed `mailglass:` — this milestone phase `LINT-06 PrefixedPubSubTopics` (see the
forthcoming check in the core `mailglass` package) enforces the prefix at
lint time. The prefixed shape matches `Mailglass.PubSub.Topics` in the core
library; the two modules intentionally share the convention so adopter
telemetry handlers can pattern-match on a single namespace.
PubSub topics remain prefixed to avoid cross-application collisions.

- Stable
  - [MailglassAdmin](MailglassAdmin.md): Mountable LiveView preview and operator surfaces for mailglass.
  - [MailglassAdmin.Auth](MailglassAdmin.Auth.md): Stack-agnostic authorization seam for production operator access and
future destructive actions.
  - [MailglassAdmin.Router](MailglassAdmin.Router.md): Preview and operator dashboard mounts.

- Internal
  - [MailglassAdmin.Operator.Mount](MailglassAdmin.Operator.Mount.md): Internal `on_mount` authorization hook for the production operator
surface.

## Mix Tasks

- [mix mailglass_admin.assets.build](Mix.Tasks.MailglassAdmin.Assets.Build.md): Compiles `mailglass_admin/assets/css/app.css` to
`mailglass_admin/priv/static/app.css` via the `tailwind` Hex package —
zero Node toolchain required.
- [mix mailglass_admin.assets.watch](Mix.Tasks.MailglassAdmin.Assets.Watch.md): Runs Tailwind in `--watch` mode. Recompiles `priv/static/app.css`
on every save to `assets/css/app.css` or any HEEx source under
`lib/mailglass_admin/`.
- [mix mailglass_admin.daisyui.update](Mix.Tasks.MailglassAdmin.Daisyui.Update.md): Curls the latest `daisyui.js` + `daisyui-theme.js` from the daisyUI
GitHub releases page and writes them to `assets/vendor/`. Prepends a
pin-comment with today's date + the source URL for CHANGELOG
traceability per CONTEXT the design contract.
- [mix mailglass_admin.preview.capture](Mix.Tasks.MailglassAdmin.Preview.Capture.md): Capture deterministic preview screenshots from `MailglassAdmin.PreviewLive`.