_   _      _           _         _____           _             
 | \ | |    | |         | |       |  __ \         (_)            
 |  \| | ___| |__  _   _| | __ _  | |  | | ___ ___ _  __ _ _ __  
 | . ` |/ _ \ '_ \| | | | |/ _` | | |  | |/ _ Y __| |/ _` | '_ \ 
 | |\  |  __/ |_) | |_| | | (_| | | |__| |  __|__ \ | (_| | | | |
 |_| \_|\___|_.__/ \__,_|_|\__,_| |_____/ \___|___/_|\__, |_| |_|
                                                      __/ |      
                                                     |___/ 

• Author: Maurício Molinari
• Projeto: Nébula Design
• Date: 2026-04-06
• Version: 1.0.0
• License: MIT

Nébula Design

Framework de derivação matemática de design tokens para sistemas de design coerentes, auditáveis e recalibráveis.

Φ · Fibonacci · θ — Razão Áurea, Sequência de Fibonacci e Ângulo Áureo como estrutura proporcional para espaçamento, tipografia, ritmo, animação, cor e forma.

---

Ordem de leitura obrigatória

Leia nesta sequência antes de qualquer derivação:

1. README.md — visão geral e princípios
2. Docs/DesignSystem.md — fundamentos do método
3. Docs/AdoptionGuide.md — guia de adoção
4. Workflow.md — procedimento operacional completo
5. Templates/Anchors.template.md — formato de âncoras

Para execução por IA ou por times, leia Workflow.md antes de iniciar qualquer derivação.

---

O que é este framework

Nébula Design é:

• um framework de derivação matemática de design tokens
• um método de publicação e governança de tokens
• uma linguagem comum entre design e engenharia
• uma base reproduzível, auditável e recalibrável para design systems

O que não é este framework

Nébula Design não é:

• uma biblioteca de tokens pronta para copiar
• um pack fixo de variáveis CSS válido para qualquer produto
• um substituto para pesquisa de usuário, acessibilidade ou validação perceptiva
• um sistema visual fechado ou estilo estético único

Os blocos de CSS e JSON do framework são instanciações contextuais do método, não saídas canônicas universais.

---

Problema que o framework resolve

Sem um sistema explícito, decisões de design tendem a acumular:

• espaçamentos escolhidos arbitrariamente
• tipografia ajustada por conveniência local
• inconsistência entre UI, motion, cor e layout
• exceções sem critério documentado
• dívida visual ao escalar o produto

Nébula Design resolve esse problema com um processo contínuo: definir âncoras → derivar → quantizar → validar → publicar → registrar exceções → recalibrar.

---

Princípios centrais

1. Matemática como estrutura, não dogma — a matemática oferece relações auditáveis; não sobrepõe ergonomia, acessibilidade ou percepção óptica.
2. Derivação antes de decoração — valores surgem do sistema, não de preferência isolada.
3. Publicação é diferente de derivação — o valor ideal pode ser 25.88px; o token publicado pode ser 26px.
4. Semântica acima de literalidade — componentes consomem tokens semânticos, não primitivos diretamente.
5. Exceção documentada é parte do sistema — exceções recorrentes indicam necessidade de recalibração.

---

Ordem de precedência

Quando há conflito entre valores derivados e constraints reais, aplique nesta ordem:

1. Acessibilidade
2. Ergonomia
3. Percepção óptica
4. Coerência semântica
5. Derivação matemática

---

Fluxo resumido

1. Definir âncoras
2. Derivar valores ideais
3. Quantizar
4. Validar percepção, ergonomia e acessibilidade
5. Publicar primitivos
6. Mapear semânticos
7. Aplicar em componentes
8. Registrar exceções e recalibrar quando necessário

Detalhamento operacional completo: Workflow.md.

---

Estrutura de diretórios

Framework — este repositório

NebulaDesign/
├─ README.md
├─ Workflow.md
├─ Docs/
│  ├─ DesignSystem.md
│  └─ AdoptionGuide.md
├─ Templates/
│  ├─ Anchors.template.md
│  ├─ Exceptions.template.md
│  ├─ ValidationChecklist.template.md
│  └─ Tokens.example.template.json
├─ Tokens/
│  ├─ primitives/
│  ├─ semantics/
│  ├─ components/
│  ├─ Tokens.json
│  └─ tokens.example.json
├─ css/
│  ├─ primitives.tokens.example.css
│  ├─ semantics.tokens.example.css
│  ├─ components.tokens.example.css
│  └─ Tokens.css
└─ Examples/
   ├─ saas-dashboard/
   ├─ landing-page/
   └─ mobile-app/

Saída esperada no projeto alvo

<project-root>/nebula/
├─ Anchors.md
├─ Exceptions.md
├─ ValidationChecklist.md
├─ Tokens/
│  ├─ primitives/
│  ├─ semantics/
│  ├─ components/
│  └─ Tokens.json
├─ css/         (quando aplicável)
├─ json/        (quando aplicável)
└─ tailwind/    (quando aplicável)

---

Regras de ouro

• Nunca comece pelos tokens — comece pelas âncoras.
• A saída final é sempre gravada no projeto alvo, nunca dentro de NebulaDesign/.