---
title: Overview
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.

## UI or Blocks {#ui-or-blocks}

Use UI components when the application owns the workflow. Use `@workspace/blocks` when the interface also needs a complete feature contract such as navigation, media storage, search adapters, or notification queries.