# Docs

- [Introduction](/docs): Animated icons that read their colors from your shadcn/ui theme.
- [Installation](/docs/installation): Three ways in. Copy the source with the shadcn CLI, install the package, or copy the files by hand.
- [Next.js guide](/docs/nextjs): From create-next-app to animated icons with the npm package, end to end.
- [Usage](/docs/usage): Variants, triggers, timing and imperative control.
- [Colors](/docs/colors): Three slots, piped from your theme, with a cascade for the slots you leave out.
- [Configuration](/docs/configuration): Global defaults, scoped providers, per-icon overrides, and which one wins.
- [Icons](/docs/icons): Browse, search and customize every icon in the catalog.
- [Custom icons](/docs/custom-icons): Build your own icon with createAnimatedIcon.