PrimeNG Developer Guidelines

Pairs with angular-developer - that skill provides Angular fundamentals (signals, DI, routing, forms, SSR, accessibility). This skill focuses on PrimeNG specifics. Install both for the best experience.

Compatibility

• Tracks: PrimeNG 22.0.0 (released 2026-07-15), with @primeuix/themes and @primeuix/styles both 3.x (currently 3.0.0). PrimeNG follows Angular's major, so v22 requires Angular v22 (peer @angular/core@^22.0.0).
• Works for: PrimeNG v18 → v22 projects. The skill references include migration.md covering the v18 component renames (Calendar→DatePicker, Dropdown→Select, etc.) and the v21→v22 removals, so v18-v21 projects can use this skill but expect drift on theming and a few component APIs. v22 is the closest match.
• v21 → v22: v22 is an Angular-22 alignment plus @primeuix/themes/@primeuix/styles v3, and it finalizes (removes) the APIs that were deprecated "for removal in v22" in earlier versions, @primeng/themes import path, pTemplate, styleClass, showTransitionOptions/hideTransitionOptions, camelCase selectors, and the pButton icon/label props among them. Treat those as gone, not merely deprecated. See migration.md.
• Docs domain: the official docs moved from primeng.org to primeng.dev (old links 301-redirect).
• Angular: v18 or newer required (v22 for PrimeNG v22). PrimeNG components are standalone since v18. The skill assumes standalone components, control flow (@if / @for), and signal-based APIs.
• Tailwind: v3 or v4 with tailwindcss-primeui plugin (optional, for unstyled mode).
• Not supported: PrimeNG v17 and below (different theming model based on prime.css), Angular v17 or below (NgModule patterns).

If the project's PrimeNG version is below v18, point the user to PrimeNG's v17 docs and decline to generate v18+ patterns into a v17 project, they will not compile.

1. Always check the project's PrimeNG version before providing guidance. PrimeNG v18 introduced major component renames (Calendar→DatePicker, Dropdown→Select, InputSwitch→ToggleSwitch, OverlayPanel→Popover, Sidebar→Drawer) and a new design-token theming system. package.json is the source of truth, when in doubt, look there before recommending an API. See migration.md.