Patch Notes

Patch notes: champions and items with ability icons, before → after, buffs, nerfs and changes, filters. Pro · Games › Tournaments and patches

Patch notes as players read them: champions and items with their portraits, changes grouped by ability with the ability icon, every value as was → now coloured by whether it helps, ability text diffed word by word, buff, nerf and adjustment badges, developer comments, and filters by kind, section and name. An optional splash heads it.

Installation

npx valyro-cli@latest login
npx valyro-cli@latest add patch-notes

npm install valyro-ui-pro

import 'valyro-ui-pro/styles.css';
import { PatchNotes } from 'valyro-ui-pro';

Props

Prop	Type	Default
`entries` *	`PatchEntry[]`		Changed champions, items, runes and mechanics.
`sections`	`PatchSection[]`	`[]`	Sections in order; entries are grouped under them and, with two or more, a switch shows one.
`version`	`ReactNode`		Patch name or number, shown next to the heading.
`date`	`DateInput`		Release date.
`cover`	`GameImageSource`		Wide picture over the heading, e.g. a splash art: an image URL or a node.
`coverAlt`	`string`	`''`	Alt text of the cover. Default empty: decorative.
`coverPosition`	`string`	`'center 30%'`	CSS `object-position` of the cover, to keep the subject in the crop. Default `center 30%`.
`filter`	`PatchNotesFilter`		Kind of change shown.
`defaultFilter`	`PatchNotesFilter`	`'all'`	Initial filter when uncontrolled. Default `all`.
`onFilterChange`	`(filter: PatchNotesFilter) => void`		Called when the reader picks a filter chip.
`sectionFilter`	`string`		Section id shown; `''` shows every section.
`defaultSectionFilter`	`string`	`''`	Initial section when uncontrolled. Default `''`.
`onSectionFilterChange`	`(section: string) => void`		Called when the reader picks a section.
`searchable`	`boolean`	`true`	Shows the search field. Default true.
`title`	`ReactNode`		Heading. Default: `labels.title`.
`headingLevel`	`2 \| 3 \| 4`	`2`	Level of the heading; sections and entries go one and two levels below (default 2).
`timeZone`	`string`		IANA time zone of the date (default: the ThemeProvider's, then the reader's).
`locale`	`string`		BCP 47 locale for numbers and the date; defaults to the ThemeProvider's.
`labels`	`Partial<Omit<PatchNotesLabels, 'kinds' \| 'entryKinds'>> & { kinds?: Partial<Record<PatchChangeKind, string>>; entryKinds?: Partial<Record<PatchChangeKind, string>>; }`		Overrides for the built-in English text; keys left out keep their defaults.

Related components

Tournament Bracket — Tournament bracket: single and double elimination, series scores, winner, team path, monograms
Tier List — S+…D tier list: portraits with role badges, role filter, drag with mouse, touch or keyboard, export
Meta Table — Meta table: tier, win, pick and ban rates with patch-over-patch change, role and rank filters, virtualized
Matchup Matrix — Counterpicks: champion-vs-champion heat matrix with tooltips, pick your champion, a list on phones

Previous: Tournament Bracket · Next: Toggle · All Games