Installation

Add TailNG packages to your Angular workspace. Choose the layer that fits your project and your preferred package manager.

Getting Started

Installation

Package-level install matrix for TailNG Components and peer layers.

Core packages (recommended)

For most apps, install the primitives layer with @tailng-ui/cdk, or install the components layer together with its explicit peer dependencies @tailng-ui/primitives and @tailng-ui/cdk. Add theme and icons on top when you want the default TailNG styling surface.

## Headless behavior and accessibility primitives
pnpm add @tailng-ui/primitives @tailng-ui/cdk
## Or if you need styled components
pnpm add @tailng-ui/components @tailng-ui/primitives @tailng-ui/cdk
## Optional theme + icons
pnpm add @tailng-ui/theme @tailng-ui/icons

## Headless behavior and accessibility primitives
npm install @tailng-ui/primitives @tailng-ui/cdk
## Or if you need styled components
npm install @tailng-ui/components @tailng-ui/primitives @tailng-ui/cdk
## Optional theme + icons
npm install @tailng-ui/theme @tailng-ui/icons

## Headless behavior and accessibility primitives
yarn add @tailng-ui/primitives @tailng-ui/cdk
## Or if you need styled components
yarn add @tailng-ui/components @tailng-ui/primitives @tailng-ui/cdk
## Optional theme + icons
yarn add @tailng-ui/theme @tailng-ui/icons

Minimal install (components + required peers)

If you only need the styled component layer, add @tailng-ui/components and its explicit peer dependencies @tailng-ui/primitives and @tailng-ui/cdk, then add @tailng-ui/theme for the default styling contract.

pnpm add @tailng-ui/components @tailng-ui/primitives @tailng-ui/cdk @tailng-ui/theme

npm install @tailng-ui/components @tailng-ui/primitives @tailng-ui/cdk @tailng-ui/theme

yarn add @tailng-ui/components @tailng-ui/primitives @tailng-ui/cdk @tailng-ui/theme

With icons

To use the TailNG icon set in buttons, menus, and other components, add @tailng-ui/icons on top of the components, primitives, CDK, and theme packages.

pnpm add @tailng-ui/components @tailng-ui/primitives @tailng-ui/cdk @tailng-ui/theme @tailng-ui/icons

npm install @tailng-ui/components @tailng-ui/primitives @tailng-ui/cdk @tailng-ui/theme @tailng-ui/icons

yarn add @tailng-ui/components @tailng-ui/primitives @tailng-ui/cdk @tailng-ui/theme @tailng-ui/icons

Peer dependencies

TailNG Components and primitives target modern Angular (v19+). Ensure your workspace uses a compatible Angular version, and remember that @tailng-ui/primitives and @tailng-ui/components now both expect @tailng-ui/cdk to be installed explicitly.