# User Documentation

This folder is the beginner path for a developer who wants to build a real Windows desktop application with Nexamas UI.

It is intentionally separate from historical proof notes, maintainer inventories, and deep implementation documents. The pages here use the public consumer surface only and link back to source-verified examples and recipes.

## Reading order

| Step | Page | Goal |
|---:|---|---|
| 1 | [Installation](installation.md) | Restore the package and understand the supported runtime envelope. |
| 2 | [First window](first-window.md) | Attach Nexamas UI to a normal WinForms form. |
| 3 | [Layout](layout.md) | Arrange controls through public layout builders instead of manual bounds. |
| 4 | [Controls](controls.md) | Add common controls through `window.Controls.Add*` factories. |
| 5 | [Data](data.md) | Use `MASDataView` and `MASDataGrid` for tabular data. |
| 6 | [Theme](theme.md) | Select built-in themes and surface materials through public gateways. |
| 7 | [Localization and RTL](localization-rtl.md) | Attach the public RTL/localization page route. |
| 8 | [Output](output.md) | Export supported output artifacts through `MASApplication.Output`. |
| 9 | [Validation](validation.md) | Run the local restore/build/quality proof sequence before release. |

## Beginner rule

Use the public application facade first:

```text
MASApplication -> MASApplicationWindow -> window.Controls.Add* -> LayoutPage/LayoutApplicationSurface
```

Do not build beginner applications from internal host objects, `Friend` APIs, renderer internals, proof gates, or Showcase-only helpers.

## Verification labels

`Source-verified` means the documented route was reconciled with the current source declarations. `Build-verified` means the corresponding repository-owned consumer sample was also compiled through the Windows/.NET Framework verification route. A status applies only where it is attached to a specific example or recipe.

## Related documentation

- [Developer guide](../developer-guide.md)
- [Recipes](../recipes/README.md)
- [Examples](../examples/README.md)
- [V1 Public API catalog](../reference/public-api-v1.md)
- [Windows validation runbook](../developer/windows-validation-runbook.md)