# Getting started

Start here to build an application with `@dg/ui`. Read the quick reference first, then set up the application and its composition. The [boilerplate](../../../../apps/boilerplate/README.md) applies these pages in a runnable app.

- [Quick reference](quick-reference.md): shell, components by need, token roles and the ten rules.
- [Create a new application](new-app.md): packages, configuration, layout, themes, errors and hosting.
- [Compose with the toolkit](composition.md): state, callbacks, snippets, ownership and the state contract.