# BlazorDX — LLM context & usage guide > A single-file reference for AI assistants writing applications with **BlazorDX**, a > secure-by-default, headless, **AOT-safe**, zero-runtime-reflection Blazor component > system for **.NET 10**. MIT-licensed. Beta — not for production. > > Source: https://github.com/logixrcorp/BlazorDX · Docs/demo: https://blazordx.com When generating BlazorDX code, follow the **Hard rules** below — they are enforced by Roslyn analyzers and the build fails (warnings-as-errors) if you violate them. --- ## 1. Hard rules (the build enforces these) 1. **No raw `MarkupString`** for untrusted/dynamic HTML (analyzer **DX1001**). Render text normally, or route HTML through `BlazorDX.Security` sanitization. Prefer `DxMarkdown`. 2. **No Singleton holding UI/user state** (analyzer **DX1002**). App/data services that back components must be registered **`Scoped`**, never `Singleton`. 3. **Zero runtime reflection on binding/serialization.** Never use `PropertyInfo`/reflection to read or write model values. Use the **source generators** (`[GridRow]`, `[DxFormModel]`). 4. **1000-line file cap** per source file (analyzer **DX1000** + MSBuild target). 5. Everything must compile under **`TreatWarningsAsErrors`** and stay **trim/AOT-clean**. `DateTime.Now`, `Math.Random`, LINQ, generics, etc. are all fine in application code. --- ## 2. Setup ### Packages ```bash dotnet add package BlazorDX.Components # styled components (pulls Primitives, Compute, Interop, SourceGen) ``` ### Services — register in BOTH Program.cs files (server host + WASM client), so prerender works ```csharp builder.Services.AddBlazorDXCompute(); // grid compute (Rust in browser / managed fallback) + DOM interop builder.Services.AddScoped(); // only if you use DxToast // Your own data services: ALWAYS Scoped (never Singleton — DX1002) builder.Services.AddScoped(); ``` ### Styles — link the sheets you use (App.razor ``) ```html ``` ### Render modes & usings Interactive pages start with `@rendermode InteractiveWebAssembly` (or `InteractiveServer`) and `@using BlazorDX.Components`. Static-SSR content pages need no render mode. --- ## 3. Source generators (this is how you bind data — no reflection) ### `[GridRow]` → a `GridAccessor` for `DxDataGrid` Decorate a **flat** row type (simple types: `string`, `int`, `double`, `bool`) with `[GridRow]` and each column with `[GridColumn]`. The generator emits a zero-reflection accessor named `GridAccessor`. ```csharp using BlazorDX.Primitives.Grid; [GridRow] public sealed class PersonRow { [GridColumn("ID", Order = 0)] public int Id { get; set; } [GridColumn("Name", Order = 1)] public string Name { get; set; } = ""; [GridColumn("City", Order = 2)] public string City { get; set; } = ""; [GridColumn("Score", Order = 3)] public double Score { get; set; } } // usage: private readonly PersonRowGridAccessor accessor = new(); ``` For rich domain objects, project them to a flat `[GridRow]` row (string/int columns) and keep the domain model separate. ### `[DxFormModel]` + DataAnnotations → a `FormModel` descriptor for `DxForm` One model becomes a rendered form, a validation contract, **and** an MCP/AI tool. **Enum fields render as `