Skip to content

Home pt BR

Jump to bottom
Edgar Mesquita edited this page Aug 15, 2026 · 5 revisions

Wiki de Documentação do eQuantic.UI

🌐 Esta página em: English · Português

Bem-vindo à wiki oficial do eQuantic.UI, um framework C# para desenvolvimento ultrarrápido de interfaces: os componentes são escritos uma única vez em C# e realizados como DOM + CSS no web (via compilação para TypeScript e Reconciliação Inteligente) e como pixels de GPU no nativo (via o engine proprietário Photon: Metal/Vulkan, sem WebView, sem Skia).

Experimente primeiro

ui.equantic.tech/playground: escreva um componente em C#, aperte Run e veja renderizar. Não é uma simulação: o mesmo eqc que o seu build usa compila o trecho no servidor e o resultado monta na página, então o que você vê é o que o framework realmente faz. Nada para instalar.

O resto do site está em ui.equantic.tech, e ele próprio é um app eQuantic.UI consumindo os pacotes publicados: uma prova permanente de que o build de um consumidor funciona a partir de nada além do nuget.org.

Lendo as marcas de versão

Uma feature carrega o release em que saiu: Desde 0.2.0-preview.7 sob um título, ou uma coluna Since quando as linhas de uma tabela têm idades diferentes. Se uma seção não tem marca, ela é anterior às marcas, não anterior à feature.

As marcas são derivadas do git, nunca escritas de memória:

c=$(git log --diff-filter=A --format=%h -- path/to/File.cs | tail -1)   # o commit que adicionou
git tag --contains $c --sort=v:refname | head -1                        # o primeiro release com ele

Cada marca é escrita duas vezes, e isso é deliberado. A linha em itálico é para quem lê no GitHub; o comentário HTML ao lado é o mesmo fato numa forma que uma máquina consegue filtrar, e é invisível aqui:

*Desde **0.2.0-preview.20***  <!-- eq:since 0.2.0-preview.20 symbol="class InView" src="src/eQuantic.UI.Primitives" -->

symbol é de onde a versão foi DERIVADA, para que a próxima pessoa possa reexecutar os dois comandos acima contra a mesma coisa em vez de confiar no número. src estreita a busca quando o nome não é único, e note substitui symbol quando nenhum símbolo sozinho responde.

Onde a marca fica é o que ela cobre:

  • Sob um título, cobre aquela seção, até o próximo título do mesmo nível ou superior.
  • Antes de qualquer título, cobre a página inteira: é assim que uma página que não existia num release antigo diz isso. Storage é a que faz isso hoje.

O site lê essas marcas; um teste falha o build quando o comentário e a linha em itálico discordam.

📌 Navegação

🏁 Comece aqui

  • Primeiros Passos - Três comandos e sem Node: instale o template, crie um app, rode. O que o template te dá, e para onde apontar um feed de preview.

📱 Nativo & Write-Once (Track N)

  • Write-Once Components - A arquitetura: um vocabulário, dois realizers, a mesma classe no web e no nativo.
  • Declarative Surface - Autoria sem new: a superfície de factories, seus componentes entrando nela automaticamente, [UiFactory].
  • Photon Engine - O engine GPU nativo: núcleo SDF normativo, texto/ícones reais, backends Metal + Vulkan, shells macOS/iOS/Android.
  • Design System - Tokens tipados, o engine de estilo ATÔMICO (estilo sem CSS), temas IAppTheme/Material 3, densidade.
  • Formulários - Formulários tipados sem biblioteca de formulário: o modelo declara as próprias regras, a validação roda nos dois alvos, e o servidor reconfere o que o browser já fez.
  • Markdown - Markdown renderizado como o design system: um parser em todos os lados (SSR, Photon, twin do browser).
  • Mermaid - Fluxogramas e diagramas de sequência desenhados pelo próprio design system, sem mermaid.js.

🏗️ Arquitetura & Conceitos

  • Visão de Arquitetura - DDD, CQRS e a filosofia Clean Architecture na UI.
  • Componentes - O catálogo: ações, superfícies, navegação, overlays, o ListView com reciclagem, a planilha.
  • Estilo - Estilo em C# tipado: um engine, CSS atômico no web, paint GPU no nativo.
  • Localização - Multi-idioma do jeito .NET: resx, o acessor tipado, cultures, e como a mesma classe responde no servidor, no browser e numa janela nativa.
  • Analytics e GTM - Analytics como capacidade que o app recebe por construtor, com o Google Tag Manager como um instalador, não como a interface.

⚙️ Engine de Compilação

⚡ Runtime & Performance

🔌 Servidor & Integração

🎨 Ecossistema

🚀 Guia de desenvolvimento

Tip

Esta documentação evolui com o projeto e a wiki inteira está traduzida: cada página tem a gêmea em inglês a um clique, no topo dela e na barra lateral. Encontrou uma inconsistência, avise.

🌐 English · Português

🏁 Comece aqui

📱 Write-once

🏗️ Arquitetura

⚙️ Compilação

⚡ Runtime

🔌 Servidor

🎨 Ecossistema

🚀 Desenvolvimento

Clone this wiki locally