description: Learn where the UI package fits and how its explicit entry points support composition.
order: 1
toc:
- id: package-role
title: Package role
- id: tutorial-map
title: Tutorial map
- id: ui-or-blocks
title: UI or Blocks
---
## Package role {#package-role}
`@workspace/ui` contains reusable React primitives, composite controls, hooks, icons, styles, and locale catalogs. It is the visual foundation shared by applications and higher-level feature packages.
## Tutorial map {#tutorial-map}
This tutorial installs the styles, introduces component subpaths, builds a small form through composition, adds responsive behavior, and connects locale catalogs.
Use UI components when the application owns the workflow. Use `@workspace/blocks` for complete application-shell features such as navigation and notifications, and focused packages such as `@workspace/media` or `@workspace/search` for domain workflows.
