release: version packages (beta)

[dohooo]

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

⚠️⚠️⚠️⚠️⚠️⚠️

main is currently in pre mode so this branch has prereleases rather than normal releases. If you want to exit prereleases, run changeset pre exit on main.

⚠️⚠️⚠️⚠️⚠️⚠️

Releases

[email protected]

Minor Changes

• #853 c595958 Thanks @dohooo! - - add itemWidth/itemHeight props so horizontal and vertical carousels can define their snapping step explicitly (e.g. to show multiple cards per page)

  • default behaviour still falls back to the carousel container size or legacy width/height props

• #853 c595958 Thanks @dohooo! - ## ✨ Style API refresh

  • style now controls the outer carousel container (positioning, width/height, margins).
  • New contentContainerStyle replaces containerStyle for styling the scrollable content.
  • width and height props are deprecated; define size via style instead.

  Migration Example

  // Before
  <Carousel
    width={300}
    height={200}
    containerStyle={{ paddingHorizontal: 16 }}
  />
  
  // After
  <Carousel
    style={{ width: 300, height: 200 }}
    contentContainerStyle={{ paddingHorizontal: 16 }}
  />

  • Any layout logic still works; simply move width/height into style and container tweaks into contentContainerStyle.
  • contentContainerStyle runs on the JS thread—avoid adding opacity / transform there if you rely on built-in animations.

Patch Changes

• #872 12c1a63 Thanks @dohooo! - Clamp visible ranges for non-loop overdrag and add test to ensure the first item stays visible when dragging right on the first page. Credits to PR Fix: first image disappears on overdrag in non-loopable carousel #869 reporter.

• #871 bc7daaf Thanks @dohooo! - Fix non-loop overscroll direction so tiny positive offsets at the first page no longer wrap to the last page when calling next()/scrollTo(), and add integration coverage for the scenario. Thanks to @hennessyevan for the original report and PR 839 inspiration.

• #866 566bf52 Thanks @hennessyevan! - Fix pagination accessibility state by syncing selection with scheduleOnRN instead of reading reanimated values during render, and add coverage to avoid test warnings.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
react-native-reanimated-carousel	Ready	Preview	Comment	Dec 11, 2025 5:48pm

[dosubot]

Related Documentation

Checked 1 published document(s) in 1 knowledge base(s). No updates required.

^{How did I do? Any feedback?}  

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 82.74%. Comparing base (12c1a63) to head (f11a995).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #870   +/-   ##
=======================================
  Coverage   82.74%   82.74%           
=======================================
  Files          35       35           
  Lines         991      991           
  Branches      328      328           
=======================================
  Hits          820      820           
  Misses         77       77           
  Partials       94       94           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.