Skip to content

[DevTask] Add docs to not use deprecated PrimeVue components #4026

@christian-byrne

Description

@christian-byrne

Improved Issue Description

Objective:
Research PrimeVue v4.2.5 for deprecated components and add comprehensive documentation to CLAUDE.md and .cursorrules to prevent developers from using deprecated components in future development.

Known Deprecated Components:

  • Dropdown → Use Select, SelectButton, or Popover instead
  • OverlayPanel → Use Popover instead

Implementation Steps:

  1. Research Phase:

    • Review PrimeVue v4.2.5 documentation for deprecated/legacy components
    • Check PrimeVue migration guides and changelogs
    • Identify any additional deprecated components beyond the known ones
    • Document recommended replacements for each deprecated component
  2. Documentation Updates:

    • Add comprehensive section to CLAUDE.md with deprecated component guidelines
    • Update .cursorrules with rules to flag usage of deprecated components
  3. Documentation Format Example:

    # PrimeVue Component Guidelines
    
    ## Deprecated Components - Do Not Use:
    - `Dropdown` → Use `Select` (simple selection), `SelectButton` (multiple choice), or `Popover` (contextual)
    - `OverlayPanel` → Use `Popover` instead
    - [Additional components from research]
    
    ## Why Avoid Deprecated Components:
    - Future PrimeVue versions may remove support
    - Modern replacements have better accessibility
    - Consistent with PrimeVue's design system evolution

Research Resources:

  • PrimeVue official documentation
  • PrimeVue GitHub releases/changelogs
  • Component documentation pages for deprecation notices

Deliverables:

  • Complete list of deprecated PrimeVue v4.2.5 components
  • Recommended replacement components for each
  • Updated CLAUDE.md with comprehensive guidelines
  • Updated .cursorrules with deprecation rules

Note: This task is documentation-only. No code changes are required.

┆Issue is synchronized with this Notion page by Unito

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions