# MailglassAdmin v1.0.0 - Table of Contents

Mountable LiveView dashboard for mailglass — dev preview + admin

## Pages

- Overview
  - [mailglass_admin](readme.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.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.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.PhoenixLiveReload](MailglassAdmin.OptionalDeps.PhoenixLiveReload.md): Gateway for the optional `{:phoenix_live_reload, "~> 1.6"}` dep
(CONTEXT D-24, 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.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:` — Phase 6 `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.

- 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 D-22.