eQuantic.UI

eQuantic.UI Documentation

Core Integration

Server-Side Integration

eQuantic.UI transforms ASP.NET Core into a high-performance rendering engine, unifying server logic with frontend interactivity.

Server-Side Rendering

All components support SSR out of the box. The initial HTML is generated on the server for instant first paint.

builder.Services.AddUI(options =>
{
    options.ScanAssembly(typeof(Program).Assembly)
           .WithSsr()           // Enable Server Side Rendering
           .WithHtmlShell()     // Use default shell template
           .UseTailwind()       // JIT Tailwind support
           .UseLucideIcons();   // Enable icon providers
});

SEO & Dynamic Metadata

eQuantic.UI uses the IHandleMetadata<T> pattern to allow components to declare their own SEO metadata in a strongly-typed way.

Metadata are automatically injected into the <head> during Server-Side Rendering (SSR).

public class HomeMetadata : IHandleMetadata<Home>
{
    public void Configure(SeoBuilder seo, Home component)
    {
        seo.Title("Home | eQuantic")
           .Description("Modern C# Web Application")
           .OpenGraph(og => og.Type("website"));
    }
}

Middleware Pipeline

Server Actions must be registered before MapUI so that client RPC calls are intercepted correctly before SPA routes.

Order is Important

var app = builder.Build();

app.UseStaticFiles();
app.UseServerActions(); // Essential: handles [ServerAction]
app.MapUI();           // Final endpoint for SPA and assets

Roslyn Compilation

The engine uses Roslyn to analyze components at build-time or watch mode.

Hybrid SSR

Combines SSR speed with client-side hydration flexibility.

Integrated RPC

Transparent client-server communication without manual REST APIs.