@saacms/admin

Status: placeholder (v0.1.0). This package is intentionally empty.

The full admin UI scaffold lands in a follow-up implementation pass. When it does, this package will become a Vite + React 19 application that ships as the single editor experience across every host adapter (per ADR 0017: "the admin UI is React + shadcn (Puck-driven), regardless of host").

Planned shape

The follow-up will introduce, roughly in this order:

• Vite + React 19 project, bundled into the host's build output and mounted at /admin/[[...slug]] (or each host's equivalent route).
• shadcn/ui as the component primitive layer for the app shell, dialogs, forms, and Performance / Cache-debug tabs.
• Puck as the visual block-tree composer for Pages and templates (per ADR 0004 dual-mode authoring).
• Monaco as the lazily-loaded power-user fallback for raw Page-JSON, Block-prop, and Collection-schema editing (per ADR 0022 §D5).
• Better Auth UI wrapped for the sign-in / multi-provider OAuth flow (per ADR 0022 §D4).
• Floating dev launcher injected into the user's running site in dev mode so the editor opens as an overlay over the current page rather than forcing a navigation to /admin (per ADR 0022 §D2; adopted from Nuxt Studio).
• Iframe-free real-time preview — the editor's preview pane is the production render path itself, via ADR 0004's preview-fetch + DOM-teleport (per ADR 0022 §D3).
• Editor UI internationalisation wired from day one even though content i18n is deferred per ADR 0016 (per ADR 0022 §D7).

What's here today

Only src/index.ts with a marker constant and a adminMountInfo() function that reports { route: "/admin", status: "placeholder" }. This exists so that the monorepo's project-references graph resolves and tsc --build stays typecheck-clean while we sequence the real UI work.

No React, shadcn, Puck, Monaco, or Better Auth dependencies are pulled in yet — they land alongside the actual implementation.

Related ADRs

• ADR 0017 — Monorepo package layout
• ADR 0022 — Performance and DX philosophy