Adam
/
AyCode.Blazor
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
AyCode.Blazor/.github/copilot-instructions.md

2.3 KiB
Raw Blame History

AyCode.Blazor — Domain Rules

This is the single source of truth for Blazor/MAUI UI domain rules. Do not duplicate these elsewhere. For core framework rules see: ../AyCode.Core/.github/copilot-instructions.md For detailed docs see: README.md → docs/

DevExpress Components

  1. DevExpress Blazor 25.1.3 — always use DxGrid, DxFormLayout, etc. Do NOT mix with generic Blazor component libraries.
  2. Grid system uses AcSignalRDataSource for real-time data — grids fetch data via SignalR, not REST.
  3. CardView components wrap DevExpress grids with card-style layout for mobile-friendly display.

Architecture

  1. Blazor.Components is the main UI library — both Blazor Server and MAUI Hybrid consume it.
  2. Blazor.Models = shared view models (client + server). Blazor.Models.Server = server-only scaffolding.
  3. MAUI.Core targets Android (API 33+), iOS (15.0+), Windows (10.0.19041+) via platform folders.
  4. Controllers project is scaffolding — do not add business logic here.

Serialization in UI

  1. SignalR uses AcBinaryHubProtocol (custom binary) — not the default JSON protocol.
  2. Grid filters use AcExpressionNode serialization — LINQ expressions are serialized and sent to server.

Related Solutions

  1. AyCode.Core solution (../AyCode.Core/AyCode.Core.sln) contains all core framework code (SignalR, serialization, data sources, base classes, interfaces). When a type is referenced in this Blazor solution but not defined here (e.g. AcSignalRDataSource, AcBinaryHubProtocol, IId<TId>, AcObservableCollection, AcLoggerBase), look it up in AyCode.Core source.
  2. For AyCode.Core domain rules see: ../AyCode.Core/.github/copilot-instructions.md

Conventions

  1. Do not suggest removal/rollback as a solution — find a fix for the problem.
  2. All DLL references to AyCode.Core projects are via DllReference (not ProjectReference) — this is intentional.
  3. No redundant code — before writing new logic, search for existing methods. Reuse or extract shared logic into smaller methods rather than duplicating.
  4. Keep all .md files in sync — when you modify code, update any affected .md file (README.md, docs/, GLOSSARY, ARCHITECTURE, CONVENTIONS, etc.). If you notice any .md content does not match the current code, fix it automatically.