-
Notifications
You must be signed in to change notification settings - Fork 1
Home
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).
ui.equantic.tech/playground — write a component in C#,
press Run, and watch it render. It is not a simulation: the same eqc your build uses compiles the
snippet server-side and the result mounts in the page, so what you see is what the framework
actually does. Nothing to install.
The rest of the site is at ui.equantic.tech, and it is itself an eQuantic.UI app consuming the published packages — a standing proof that a consumer's build works from nothing but nuget.org.
- Write-Once Components - THE architecture: one vocabulary, two realizers — the same class on web and native.
-
Declarative Surface - Authoring without
new: the factory surface, your own components joining it automatically,[UiFactory], and the one sharp edge. - Photon Engine - The native GPU engine: normative SDF core, real text/icons (CoreText/CoreGraphics), Metal + Vulkan backends, the macOS/iOS/Android shells.
- Design System - Typed tokens, the ATOMIC style engine (styling without CSS), IAppTheme/Material 3 theming, density and the dense type rungs.
- Capabilities - Camera, location, photos, biometrics, network — services taken by constructor, realized per host, and null where the host has none.
- Storage - One signature over each platform's own store — localStorage, NSUserDefaults, SharedPreferences — and why secrets are a separate type the browser cannot provide.
- Code Editor - The editor MODEL an IDE is built on: line documents, incremental highlighting for six languages, undo that thinks in words, and the controller behind every editing command.
- Architecture Overview - DDD, CQRS, and the Clean Architecture philosophy in the UI.
- Package Architecture - Self-contained package design and artifact management.
- Components - The component catalog: actions, surfaces, navigation, overlays, the recycling ListView, the Spreadsheet grid.
- Styling - Typed C# styling: one engine, atomic CSS on the web, GPU paint on native — plus the low-level HTML escape hatch.
- 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.
- Build Flow - How the compilation pipeline works with zero external dependencies.
- Runtime (TypeScript) - Details on the reconciler, state management, and component lifecycle.
- Performance & Optimization - Keyed Diffing, WeakMap Listener tracking, and other optimizations.
-
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(zeropackage.json). - Security & Server Actions - Authorization, payload validation, and server action protection.
- Image Optimization - Next.js-style server-side image optimization (resize, WebP, caching).
- Charts - Chart.js and ApexCharts integration.
- Icons - Lucide, Tabler, Heroicons, and more.
- Debugging & Development Tools - Professional debugging with logger and error overlay.
- Project Roadmap - What's ahead.
Tip
This documentation is updated as the project evolves. If you find any inconsistencies, feel free to report them.