Release History

Changelog

All notable changes to star-rating-x are documented here.

v5.0.0v4.0.0v3.0.0v2.0.0v1.0.1v1.0.0
v

v5.0.0

LatestMay 8, 2025

Major release — 4 new components, 3 new hooks, and 6 new StarRating props. The most feature-complete version yet.

NewRatingBadge — compact inline ⭐ 4.8 (1.2k) badge in 4 sizes
NewRatingSummary — full Amazon-style review summary card
NewRatingWall — masonry grid of review cards with load-more and helpful voting
NewRatingPrompt — smart prompt triggered by time, scroll depth, or manually
NewuseRatingAnalytics — average, median, mode, NPS, trend, recentTrend, distribution
NewuseRatingPersistence — auto-save to localStorage with optional TTL expiry
NewuseRatingExport — export ratings array as CSV, JSON, or copy to clipboard
NewglowEffect + glowIntensity props — drop-shadow glow around filled stars
Newloading prop — skeleton shimmer placeholder while data loads
NewallowUndo + undoTimeout + onUndo — undo toast after each rating change
NewonRatingComplete + debounceMs — fires only after user stops changing
ImproveCSS keyframes added: srx-shimmer, srx-prompt-in, srx-undo-in
ImproveTypeScript declarations extended with 14 new exported interfaces
v

v4.0.0

StableMay 7, 2025

Gradient fill, compare mode, confetti on max rating, and major RatingGroup upgrades.

NewfilledGradient prop — multi-stop colour gradient fill on stars
NewgradientDirection — 'horizontal' | 'vertical' | 'diagonal'
NewcompareValue + compareLabel — ghost rating displayed behind main stars
NewcelebrateOnMax + confettiColors — confetti burst when user hits max rating
NewRatingGroup: overallLabel — fully customisable average row label text
NewRatingGroup: dividerColor — custom divider line colour above average
NewRatingGroup: averageLabelStyle — CSSProperties for the overall label
NewRatingGroup: rowGap — configurable gap between category rows
NewRatingGroup: averagePrecision — 1 or 0.5 precision on average row stars
ImproveCSS: confetti keyframes (srx-confetti-0/1/2) added to styles.css
ImproveStarRating root span gets position: relative for proper confetti layering
v

v3.0.0

StableMay 6, 2025

Form integration, tooltip popup, Amazon-style distribution bars, and standalone field validation.

NewStarRatingInput — form-ready field with label, required, error, helper text
NewStarRatingInput — hidden <input> for native form submission
NewStarRatingInput — works with React Hook Form (Controller pattern)
NewStarRatingInput — works with Zod via zodResolver
NewStarRatingTooltip — rich popup tooltip on hover with custom renderer
NewStarRatingTooltip — tooltipPlacement: 'top' | 'bottom'
NewRatingDistribution — Amazon-style horizontal bar chart
NewRatingDistribution — clickable rows for star-level filtering
NewRatingDistribution — compact mode, showCount, showPercent
NewuseRatingField — standalone validation: required, minValue, custom fn
NewuseRatingField — returns showError, errorMessage, field, handlers, reset
ImproveFull TypeScript rewrite — forwardRef properly typed with HTMLSpanElement/HTMLDivElement generics
FixAll implicit any parameters annotated — zero errors on strict mode
FixTHEMES record typed as Record<ThemeName,…> — fixes index signature error
v

v2.0.0

StableMay 5, 2025

Emoji/character mode, custom SVG icons, mount count-up animation, and RatingGroup component.

Newcharacter prop — emoji, text string, or render fn instead of SVG
NewcustomIcon prop — custom SVG path string or full render function
NewmountAnimation + mountDuration — count-up fill animation on first render
NewRatingGroup component — rate multiple categories with auto overall average
NewIconRenderContext and CharacterRenderContext TypeScript interfaces exported
ImproveRatingGroup forwards all StarRating props via ...starProps spread
FixforwardRef generic type mismatch (RefObject<unknown> vs HTMLSpanElement)
v

v1.0.1

PatchMay 4, 2025

npm metadata update — homepage, bugs, funding, and author URL linked from the npm package page.

Newauthor.url — LinkedIn profile linked from npm
Newhomepage — links to live demo (star-rating-x-demo.vercel.app)
Newbugs.url — GitHub issues page linked from npm
Newfunding — LinkedIn URL in npm Fund button
Improvepackage.json author field upgraded from string to {name, url} object
v

v1.0.0

InitialMay 3, 2025

First public release — a fully-featured, accessible, customisable React star-rating component.

NewStarRating component — controlled and uncontrolled modes
New9 built-in colour themes: gold, fire, ocean, neon, rose, mono, violet, sunset, mint
New8 icon shapes: star, heart, circle, diamond, thumb, flag, lightning, flower
New4 click animations: bounce, pulse, wiggle, pop
NewHalf-star precision via precision={0.5}
NewFull keyboard navigation: ← → ↑ ↓ Home End
NewARIA role=slider with aria-valuemin/max/now/text
NewRTL layout via direction prop
NewCustom colour overrides: filledColor, emptyColor, strokeColor
NewshowValue, tooltips, allowClear, highlightSelected props
Newdisabled and readOnly states
NewuseRating hook for external state management
NewFull TypeScript declarations (.d.ts)
NewRollup build — ESM + CJS dual output
NewZero runtime dependencies — only React as peer dep

Found a bug or have a feature request? Open an issue on GitHub →