From 03fadfa283571a13a9093dcf78e16de2109bb495 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 23 Apr 2026 06:46:36 +0000 Subject: [PATCH] docs(ui): add BLUEPRINT, QUIRKS, blockers dir Co-authored-by: yuneng-jiang --- ui/litellm-dashboard/docs/BLUEPRINT.md | 25 +++++++++++++++++++++ ui/litellm-dashboard/docs/QUIRKS.md | 12 ++++++++++ ui/litellm-dashboard/docs/blockers/.gitkeep | 0 3 files changed, 37 insertions(+) create mode 100644 ui/litellm-dashboard/docs/BLUEPRINT.md create mode 100644 ui/litellm-dashboard/docs/QUIRKS.md create mode 100644 ui/litellm-dashboard/docs/blockers/.gitkeep diff --git a/ui/litellm-dashboard/docs/BLUEPRINT.md b/ui/litellm-dashboard/docs/BLUEPRINT.md new file mode 100644 index 00000000000..0bb87c724d4 --- /dev/null +++ b/ui/litellm-dashboard/docs/BLUEPRINT.md @@ -0,0 +1,25 @@ +# Phase 1 migration blueprint + +This document is finalized after Section 1 (Access Groups) and locked for the +rest of the phase-1 run. Later sections follow the patterns defined here; any +deviation is logged in `DEVIATIONS.md`. + +**Status:** Not yet locked — will be drafted during Section 1 (Access Groups). + +Once locked, this file will contain: + +1. **Component translation table** — every antd component → shadcn primitive, + with import paths and any prop-shape differences. +2. **Icon translation table** — @ant-design/icons, @heroicons/react, + @remixicon/react → lucide-react (only). +3. **Toast pattern** — before/after code example using the + `MessageManager` / `NotificationManager` bridges (which now delegate to + sonner under the hood). +4. **Form pattern** — canonical shadcn `
` + `react-hook-form` + `zod` + example, including schema location, `FormField` / `FormItem` / `FormLabel` + / `FormControl` / `FormDescription` / `FormMessage` wiring, and submit + handler hooked into the existing data-layer function. +5. **Table pattern** — shadcn `` + `@tanstack/react-table` with + sort / filter / pagination. Column-visibility UI if used. +6. **Shared layout patterns** — page header, section card, empty state, + loading skeleton, error alert, permissions gate. diff --git a/ui/litellm-dashboard/docs/QUIRKS.md b/ui/litellm-dashboard/docs/QUIRKS.md new file mode 100644 index 00000000000..531c02746ac --- /dev/null +++ b/ui/litellm-dashboard/docs/QUIRKS.md @@ -0,0 +1,12 @@ +# Current-UI quirks observed during migration + +Format per entry: + +##
— + +- **Observed in:** `:` (or route URL + screenshot reference) +- **Current behavior:** what the UI does today. +- **Suspected issue:** why this looks wrong. +- **Resolution:** `preserve` | `fix` +- **Rationale:** one-line justification for the resolution. +- **Parity spec impact:** `none` | "skip old-UI sanity check for assertion X". diff --git a/ui/litellm-dashboard/docs/blockers/.gitkeep b/ui/litellm-dashboard/docs/blockers/.gitkeep new file mode 100644 index 00000000000..e69de29bb2d