animus-ui

Identidade visual do Animus em React: marcas minimalista e dimensional, aplicações, cores e tipografia Inter.

Instalação

npm install animus-ui

import { AnimusMark, MinimalMark, LogoBoard, colors, typography } from 'animus-ui'
import 'animus-ui/styles.css'

export function Brand() {
  return <div style={{ width: 128 }}><AnimusMark dimensional={false} tone="color" /></div>
}

AnimusMark aceita dimensional e tone (color, black, white, violet). MinimalMark aceita tone e light. LogoBoard apresenta 11 aplicações e aceita dimensional.

A marca SVG pode ser usada sem CSS, dimensionada pelo contêiner. styles.css contém os estilos globais da apresentação, incluindo reset e fontes locais; importe apenas quando desejar a apresentação completa. Para usar apenas variáveis de marca, importe animus-ui/tokens.css. Tokens JavaScript: colors, typography, gradient. As fontes e sua licença SIL OFL estão em animus-ui/fonts/.

Desenvolvimento

npm ci
npm run dev          # http://localhost:5173
npm run storybook    # http://localhost:6006
npm run check        # lint, site, biblioteca e Storybook
npm pack --dry-run   # conferir conteúdo publicável

npm run build gera o site em dist/; npm run build:lib gera ESM, declarações TypeScript, CSS e fontes em lib/; npm run build:storybook gera a documentação em storybook-static/. React 18 ou 19 é fornecido pelo aplicativo consumidor.

Publicação

O workflow .github/workflows/publish.yml valida o projeto e publica por npm Trusted Publishing (OIDC), sem token npm armazenado no GitHub. O repositório pode permanecer privado; provenance automático do npm exige repositório público.

Configuração do Trusted Publisher no npm: owner mateusdesenv, repository animus-ui, workflow publish.yml, sem environment, com permissão de publicação direta. O npm exige que o pacote já exista; a primeira publicação usa autenticação da conta npm. Depois da configuração, publique uma nova versão por tag vX.Y.Z correspondente ao package.json, ou dispare o workflow manualmente. Uma versão publicada não pode ser reutilizada.

npm trust github animus-ui --repo mateusdesenv/animus-ui --file publish.yml --allow-publish
npm version patch
git push origin main --follow-tags