@chrono-os/admin-ui
v0.21.0
Published
Primitivas de UI de admin neutras (tema light/dark + accent escolhível por CSS vars, modos de visualização cards/lista/compacta com preview, átomos tokenizados) com injeção de dependências por context. Consumível por qualquer painel admin — dashboard unif
Downloads
2,631
Maintainers
Readme
@chrono-os/admin-ui
Primitivas de UI de admin neutras — consumidas por qualquer painel (dashboard unificado, admins individuais, forks white-label) pra que a MESMA tela exista nos dois lados e editar uma reflita na outra (paridade sem-drift).
- Tema por CSS vars: light/dark (
mode) + accent escolhível (accent) — runtime-switchable, sem rebuild. Cada app injeta o seu preset. - Modos de visualização:
cards/list/compact, com preview da página no tamanho do modo. - CSS próprio (não utilities do Tailwind) → zero purge/
contentno consumer, e o tema troca em runtime.
Setup
// 1. uma vez no app (layout):
import "@chrono-os/admin-ui/styles.css";
// 2. envolva o admin:
import { AdminThemeProvider, ADMIN_THEME_DASHBOARD_DARK } from "@chrono-os/admin-ui";
<AdminThemeProvider {...ADMIN_THEME_DASHBOARD_DARK} storageKey="dash-theme">
{children}
</AdminThemeProvider>O admin individual injeta ADMIN_THEME_NAIRIO_LIGHT (claro); o dashboard, ADMIN_THEME_DASHBOARD_DARK (escuro). Mesmo componente, cores por app.
Toggle dark/light + seletor de accent (já suportado)
A UI é só um botão chamando o contexto:
import { useAdminTheme } from "@chrono-os/admin-ui";
const { mode, setMode, accent, setAccent } = useAdminTheme();
// setMode('dark' | 'light' | 'system'); setAccent('#556FFF');Com storageKey, a escolha persiste em localStorage.
View-mode
import { ViewModeProvider, ViewModeSwitch, useViewMode, PreviewFrame } from "@chrono-os/admin-ui";
<ViewModeProvider storageKey="proposals" defaultMode="cards">
<ViewModeSwitch />
{/* a listagem lê useViewMode().mode e renderiza cards/lista/compacta */}
</ViewModeProvider>Estado
0.0.0 — fundação (tema + view-modes). Componentes de domínio (ProposalList/Detail/Form, RedirectList/…, StatsPanel, HistoryTimeline) entram nas próximas fases. Ver Naírio/Plan/03-modulos/2026-06-01_admin-ui-unificado.md.
