Skip to content
Merged
Changes from 8 commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
e0ac4bd
docs(release-highlights): Adds 6.3 highlights.
edonehoo Jul 1, 2025
60e2734
Merge branch 'main' into iss4637
edonehoo Jul 1, 2025
0756ab9
Small link change
edonehoo Jul 1, 2025
9e92685
And small wording change.
edonehoo Jul 1, 2025
8c3638b
Edits to animation details and addition of PF AI section.
edonehoo Jul 3, 2025
32372ea
Merge branch 'main' into iss4637
edonehoo Jul 7, 2025
a889e7a
Update packages/documentation-site/patternfly-docs/content/get-starte…
edonehoo Jul 7, 2025
0032f1b
Add mention of codemods
edonehoo Jul 8, 2025
4342ef9
Merge branch 'main' into iss4637
edonehoo Jul 8, 2025
3b9803f
Package link updates and animation phrasing tweaks.
edonehoo Jul 8, 2025
963be45
Update enable animations codemod info
edonehoo Jul 8, 2025
c9c4dc1
Update packages/documentation-site/patternfly-docs/content/get-starte…
edonehoo Jul 8, 2025
72815f2
Adds more details per reviews
edonehoo Jul 9, 2025
542cfca
Adds more codemod instruction per request.
edonehoo Jul 9, 2025
23903a8
Add more around codemod.
edonehoo Jul 9, 2025
c215637
update details about expandable table animations.
edonehoo Jul 10, 2025
dcacf6c
Merge branch 'main' into iss4637
edonehoo Jul 10, 2025
8679ded
Tabbing for code block
edonehoo Jul 11, 2025
7a19455
Update packages/documentation-site/patternfly-docs/content/get-starte…
edonehoo Jul 17, 2025
8b349e0
Small edits for table
edonehoo Jul 17, 2025
1665958
Merge branch 'main' into iss4637
edonehoo Jul 17, 2025
216a1d6
Make note of potential memory issues re spinners.
edonehoo Jul 17, 2025
331ba51
Update animations memory issue note
edonehoo Jul 17, 2025
4c93d84
Update animations note per Jenny's suggestion
edonehoo Jul 17, 2025
7d4be3f
Update animations codemod note
edonehoo Jul 18, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,148 @@ section: get-started
import './get-started.css';
import { Divider, Timestamp } from '@patternfly/react-core';

<Timestamp date={new Date(2025, 6)}>July 2025</Timestamp>
## PatternFly 6.3

### Promoted package versions
The following packages were promoted with this release. Outside of our primary initiatives for this release, we addressed reported bugs and continued to enhance PatternFly with new features, as detailed in the linked changelogs.

- patternfly/patternfly ([changelog](https://github.com/patternfly/patternfly/releases/tag/v6.3.0))
- [@patternfly/patternfly@6.3.0](https://www.npmjs.com/package/@patternfly/patternfly)
- patternfly/react ([changelog](https://github.com/patternfly/patternfly-react/releases/tag/v6.3.0))
- [@patternfly/react-charts@8.3.0](https://www.npmjs.com/package/@patternfly/react-charts)
- [@patternfly/react-code-editor@6.3.0](https://www.npmjs.com/package/@patternfly/react-code-editor)
- [@patternfly/react-core@6.3.0](https://www.npmjs.com/package/@patternfly/react-core)
- [@patternfly/react-docs@7.3.0](https://www.npmjs.com/package/@patternfly/react-docs)
- [@patternfly/react-drag-drop@6.3.0](https://www.npmjs.com/package/@patternfly/react-drag-drop)
- [@patternfly/react-icons@6.3.0](https://www.npmjs.com/package/@patternfly/react-icons)
Comment thread
edonehoo marked this conversation as resolved.
Outdated
- [@patternfly/react-styles@6.3.0](https://www.npmjs.com/package/@patternfly/react-styles)
- [@patternfly/react-table@6.3.0](https://www.npmjs.com/package/@patternfly/react-table)
- [@patternfly/react-templates@6.3.0](https://www.npmjs.com/package/@patternfly/react-templates)
- [@patternfly/react-tokens@6.3.0](https://www.npmjs.com/package/@patternfly/react-tokens)
- PatternFly extensions
- [@patternfly/chatbot@6.3.0](https://www.npmjs.com/package/@patternfly/chatbot) ([changelog](https://github.com/patternfly/chatbot/releases/tag/v6.3.0))
- [@patternfly/quickstarts@6.3.0](https://www.npmjs.com/package/@patternfly/quickstarts) ([changelog](https://github.com/patternfly/patternfly-quickstarts/releases/tag/v6.3.0))
- [@patternfly/react-catalog-view-extension@6.1.0](https://www.npmjs.com/package/@patternfly/react-catalog-view-extension) ([changelog](https://github.com/patternfly/react-catalog-view/releases/tag/v6.1.0))
- [@patternfly/react-component-groups@6.3.0](https://www.npmjs.com/package/@patternfly/react-component-groups) ([changelog](https://github.com/patternfly/react-component-groups/releases/tag/v6.3.0))
- [@patternfly/react-console@6.1.0](https://www.npmjs.com/package/@patternfly/react-console) ([changelog](https://github.com/patternfly/react-console/releases/tag/v6.1.0))
- [@patternfly/react-data-view@6.3.0](https://www.npmjs.com/package/@patternfly/react-data-view) ([changelog](https://github.com/patternfly/react-data-view/releases/tag/v6.3.0))
- [@patternfly/react-log-viewer@6.3.0](https://www.npmjs.com/package/@patternfly/react-log-viewer) ([changelog](https://github.com/patternfly/react-log-viewer/releases/tag/v6.3.0))
- [@patternfly/react-topology@6.3.0](https://www.npmjs.com/package/@patternfly/react-topology) ([changelog](https://github.com/patternfly/react-topology/releases/tag/v6.3.0))
- [@patternfly/react-user-feedback@6.2.0](https://www.npmjs.com/package/@patternfly/react-user-feedback) ([changelog](https://github.com/patternfly/react-user-feedback/releases/tag/v6.2.0))
- [@patternfly/react-virtualized-extension@6.1.0](https://www.npmjs.com/package/@patternfly/react-virtualized-extension) ([changelog](https://github.com/patternfly/react-virtualized-extension/releases/tag/v6.1.0))

### React 19 support

PatternFly now includes support for React 19 across all components and extensions, enabling you to benefit from new React features and performance enhancements.

This update is non-breaking, and PatternFly 6 will continue to support React 17 and 18 in line with our support policy. In future releases, we plan to more fully leverage React 19's capabilities to enhance existing PatternFly features and introduce new ones.

### Component animations

As we progress in our effort to integrate motion design across PatternFly components, we added the following new animations in this release. To provide a holistic view of our animated components, we also put together [an interactive animations demo](/design-foundations/motion/react-demos), which we will continue to update as we add additional animation support.

We have also created an [enable animations codemod](packages/eslint-plugin-pf-codemods/src/rules/v6/enableAnimations/enable-animations.md), which can be used to enable animation across the opt-in components in your codebase.

#### Expansion

We added expansion animations that apply a fade-in and slide-in transition as hidden content sections are expanded in a variety of components. A similar, reversed animation applies when expanded sections are collapsed.

The following list highlights opt-in requirements and links to examples. Unless an animation is marked with "Requires opt-in," it will be enabled by default.

- Accordion
- **Example:** All [accordions](/components/accordion) in our examples and demos.

- Dual list selector
Comment thread
edonehoo marked this conversation as resolved.
Outdated
- **Requires opt-in.**
- **Example:** [Dual list selector with tree](/components/dual-list-selector#with-tree), which has opted in.

- Expandable section
Comment thread
edonehoo marked this conversation as resolved.
- **Example:** All [expandable sections](/components/expandable-section) in our examples and demos.

- Form
- **Requires opt-in.**
- **Example:** [Form field groups](/components/forms/form#field-groups), which have opted in.

- Navigation
- **Example:** [Expandable navigation examples](/components/navigation#expandable).
- **Note:** This animation was introduced in our 6.2 release, but performance issues were reported. For this release, we reworked the animation to resolve these issues.

- Search input
- **Example:** [Expandable search input](/components/search-input#with-expandable-button).
Comment thread
edonehoo marked this conversation as resolved.
Outdated

- Tree view
- **Requires opt-in.**
- **Example:** All [tree view](/components/tree-view) examples and demos, which have opted in.

- Table
Comment thread
edonehoo marked this conversation as resolved.
Outdated
Comment thread
edonehoo marked this conversation as resolved.
Outdated
- **Requires opt-in.**
- **Example:** [Expandable table](/components/table#expandable), which has opted in.
Comment thread
edonehoo marked this conversation as resolved.
Outdated
- **Note:** This release does not include expansion animations for tree tables.

#### Feedback

Comment thread
edonehoo marked this conversation as resolved.
The following components contain animations that give users dynamic feedback, helping to communicate that an action has taken or will take place.

1. Buttons
- **Animation:** When a button is clicked, the active state color ripples outward from the center of the button.
- **Example:** All buttons in our components, including in our [button examples and demos](/components/button).

1. Form validation
- **Animation:** When an error occurs in a form field with validation, the component "jiggles" from side to side as danger styles are applied.
- **Example:** The [validated form select](/components/forms/form-select#validated), [invalid text area](/components/forms/text-area#invalid), and [invalid text input](/components/forms/text-input#invalid) examples.

1. Menu toggle validation
- **Animation:** When an error occurs in a menu toggle with validation, the component "jiggles" from side to side as danger styles are applied.
- **Example:** The [danger option in the select with validation](/components/menus/select#with-validation) example.

1. Progress
- **Animation:** When an error occurs in a progress bar, the component "jiggles" from side to side as danger styles are applied.
- **Example:** The "Danger variant" option in our [progress helper text example](/components/progress#helper-text).

1. Tabs
- **Requires opt-in for HTML-only implementations.**
- **Animation:** The bottom "active tab" line slides between tabs as they are selected.
- **Example:** All [default tabs](/components/tabs) in our examples and demos. This animation does not apply to boxed tabs.
- **Note:** To avoid a breaking change, this animation is opt-in for HTML-only implementations. To support this, view our [HTML guidance for animating the tab accent mark](/components/tabs#animate-current-tab-accent).

##### Icons
Comment thread
edonehoo marked this conversation as resolved.

1. Favorite: `fa-star-icon`
- **Animation:** When a favorite icon is clicked, the star "pulses" and fills with color.
- **Example:** All favorite buttons in our examples and demos, including our [animated favorite button example](/components/button#favorite).

1. Hamburger menu
- **Animation:** The middle bar of the hamburger icon transforms into an arrow to indicate whether the menu will expand or collapse when clicked. The behavior differs slightly for desktop and mobile views:
- **Desktop:** Both arrows appears on hover or keyboard focus as appropriate.
- **Mobile:** When the menu is expanded, a "collapse" arrow is displayed. When collapsed, an "expand" arrow appears on hover or focus.
- **Example:** All hamburger menu buttons in our examples and demos, including [our page examples](/components/page#vertical-navigation).
Comment thread
edonehoo marked this conversation as resolved.
Outdated

1. Settings: `fa-cog`
- **Animation:** When a settings icon receives hover or keyboard focus, the cog rotates. When focus is lost, it rotates back to its original position.
- **Example:** All settings icons in our examples and demos, including our [animated settings button example](/components/button#settings).
Comment thread
edonehoo marked this conversation as resolved.
Outdated

### PatternFly AI

We updated our high-level [AI principles and guidelines](/patternfly-ai/principles-and-guidelines) to expand guidance and improve the usability of this resource. We integrated community feedback and research to include new patterns and recommendations that have emerged from the increased use of AI features in products. As the design and implementation of AI features continue to evolve, so will this guiding resource.

#### ChatBot

We expanded our ChatBot extension with improvements identified in a recent usability study, including [editable messages](/patternfly-ai/chatbot/messages#user-messages) and [compact styles](/patternfly-ai/chatbot/overview/demo#compact-chatbot). We also added other requested features, such as [auto-scrolling for messages](/patternfly-ai/chatbot/messages/demo#message-auto-scrolling) (a community contribution!), [empty and error states for the chat history drawer](/patternfly-ai/chatbot/ui#drawer-with-search-and-new-chat-button), and [expandable code blocks](/patternfly-ai/chatbot/messages#user-messages)&mdash;to name a few.

On the documentation side, there's a new ["Customizing messages" guide](/patternfly-ai/chatbot/customizing-messages) that provides guidance for using rehype plugins for advanced HTML customization.

We also fixed reported bugs, which require no updates on your end.

### CLI experience guidelines

With the help of a community contribution, we now have [a CLI handbook](/developer-resources/cli-handbook) that offers guidance for designing command-line interface experiences. This resource outlines unique accessibility considerations for CLIs, as well as writing guidelines for crafting well-designed messages, documentation, and interactive CLI experiences.

### What's next?

For the Q4 release of PatternFly, we look forward to sharing updates on our design guidelines audit, system-wide accessibility improvements, new extensions, and more. We'll share the next round of exciting news in a few months!

<Divider />
<Timestamp date={new Date(2025, 3)}>April 2025</Timestamp>

## PatternFly 6.2
Expand Down Expand Up @@ -53,17 +195,17 @@ With this release, 3 components now support animations:

1. [Alert](/components/alert)
- **Animation type:** Opt-in.
- **Animation behavior:** For alerts within a group, there's a slide-in animation as new alerts are received and a slide-out animation as alerts are dismissed.
- **Example:** To visualize the motion behavior, you can interact with our website examples, which have opted in to animations.
- **Animation:** For alerts within a group, there's a slide-in animation as new alerts are received and a slide-out animation as alerts are dismissed.
- **Example:** To visualize the motion, you can interact with our website examples, which have opted in to animations.
- **Note:** By default, alert animations are opt-in and will only apply to alerts within an alert group. Opting into animations could require test updates. To ensure your test pass, the quickest solution is to set `hasAnimations` to `false`. Additionally, when alerts are dynamically added to a group, you must ensure that new alerts are prepended to the alert group list, rather than appended to the end of it.
1. [Navigation](/components/navigation)
- **Animation type:** Opt-out.
- **Animation behavior:** For expandable navigation items, the sub-menu fades in and out as navigation items are expanded and collapsed.
- **Example:** As an opt-out animation, you can see this motion behavior by default across expandable navigation items.
- **Animation:** For expandable navigation items, the sub-menu fades in and out as navigation items are expanded and collapsed.
- **Example:** As an opt-out animation, you can see this motion by default across expandable navigation items.
1. [Notification badge](/components/notification-badge)
- **Animation type:** Opt-in.
- **Animation behavior:** When the animation is triggered (for example, when a new notification arrives), the bell icon has a "ring" animation.
- **Example:** To illustrate the motion behavior of this animation, we added a [notification badge "With animations" example](/components/notification-badge#with-animation).
- **Animation:** When the animation is triggered (for example, when a new notification arrives), the bell icon has a "ring" animation.
- **Example:** To illustrate the motion of this animation, we added a [notification badge "With animations" example](/components/notification-badge#with-animation).

### React 19 support

Expand Down