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***

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

•

Compiler (CSharpToJs) · Avaliação em Compile-Time · Features C# Suportadas · Build Flow

⚡ Runtime & Performance

•

Runtime (TypeScript) · Performance

🔌 Servidor & Integração

•

Integração com o Servidor · Assets · BunPackage · Segurança & Server Actions

🎨 Ecossistema

•

Imagens · Charts · Ícones · Lottie

🚀 Guia de desenvolvimento

•

Depuração e ferramentas - depuração de verdade, com logger e overlay de erro.

•

Roadmap do projeto - o que vem pela frente.

[!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.

PREVIOUSGettingStarted-pt-BR

NEXTIcons-pt-BR

ON THIS PAGE