Home

eQuantic.UI Documentation Wiki

Welcome to the official wiki for eQuantic.UI, a C# framework for ultra-fast interface development: components are written once in C# and realized as DOM + CSS on the web (via TypeScript compilation and Intelligent Reconciliation) and as GPU pixels on native (via the proprietary Photon engine — Metal/Vulkan, no WebView, no Skia).

📌 Navigation

📱 Native & Write-Once (Track N)

• Write-Once Components - THE architecture (since the 2026-07-31 legacy excision): 28 components, one vocabulary, two realizers.
• Photon Engine - The native GPU engine: normative SDF core, real text/icons (CoreText/CoreGraphics), the macOS window shell, 17/17 Metal parity.
• Design System - Typed tokens, the ATOMIC style engine (styling without CSS), IAppTheme/Material 3 theming.

🏗️ Architecture & Concepts

• Architecture Overview - DDD, CQRS, and the Clean Architecture philosophy in the UI.
• Package Architecture - Self-contained package design and artifact management.
• Components - ⚠️ LEGACY page (the old web library was excised) — see Write-Once Components.
• Styling - ⚠️ LEGACY page — styling is now CSS-free typed C# (see DesignSystem).

⚙️ Compilation Engine

• Compiler (CSharpToJs) - How we convert C# into performant TypeScript.
• Compile-Time Evaluation - Zero-overhead abstractions with symbolic compilation.
• Supported C# Features - Detailed matrix of supported language features and APIs.
• External Type Resolution - How the compiler resolves classes defined in external files.
• Compiler Evolution - The history of changes and improvements in code generation.
• Build Flow - How the compilation pipeline works with zero external dependencies.

⚡ Runtime & Performance

• Runtime (TypeScript) - Details on the reconciler, state management, and component lifecycle.
• Performance & Optimization - Keyed Diffing, WeakMap Listener tracking, and other optimizations.

🔌 Server & Integration

• Server Integration - AddUI(), UIOptions, middleware, SSR, and SEO configuration.
• Asset Management - IRequireAssets, IComponentAssetProvider<T>, and automatic asset injection.
• BunPackage - Declare npm packages directly in .csproj (zero package.json).
• Security & Server Actions - Authorization, payload validation, and server action protection.

🎨 Ecosystem

• Image Optimization - Next.js-style server-side image optimization (resize, WebP, caching).
• Charts - Chart.js and ApexCharts integration.
• Icons - Lucide, Tabler, Heroicons, and more.
• Tailwind Updates - Theme package enhancements and dark mode.

🚀 Development Guide

• Debugging & Development Tools - Professional debugging with logger and error overlay.
• Project Roadmap - What has been achieved and what's next.

---

Tip

This documentation is updated as the project evolves. If you find any inconsistencies, feel free to report them.