# tw-animate-css changelog

> Animation utilities for Tailwind CSS v4, as a CSS-first replacement for tailwindcss-animate.

- Vendor: Wombosvideo
- Category: Frameworks & Libraries
- Official site: https://github.com/Wombosvideo/tw-animate-css
- Tracked by: What's New (https://whatsnew.fyi/product/tw-animate-css)
- Harvested from: GitHub (Wombosvideo/tw-animate-css)
- Entries below: 10 (newest first)

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

## Releases

### v1.4.0

- Date: 2025-09-24
- Version: v1.4.0
- Original notes: https://github.com/Wombosvideo/tw-animate-css/releases/tag/v1.4.0
- Permalink: https://whatsnew.fyi/product/tw-animate-css/releases/v1.4.0

##### Changelog
902e37a019ffd165ba078e0b3c02634526c54bf0: fix: remove support for prefix, add new export for prefixed version. Closes #58.
fab2a5bf817605be1976e159976718a83489fc1c: chore: bump version to 1.4.0 and update dependencies
c20dc32e2b532a8e74546879b4ce7d9ce89ba710: fix(build): make transform.ts accept two arguments

##### ⚠️ BREAKING CHANGE ⚠️

Support for Tailwind CSS's prefix option was moved to `tw-animate-css/prefix` because it was breaking the `--spacing` function. Users requiring prefixes should replace their import:

```diff
- import "tw-animate-css";
+ import "tw-animate-css/prefix";
```

_I do not plan to introduce breaking changes like this to non-major releases in the future. But because more people use spacing rather than prefixes, reverting the previous version's (obviously breaking) change seems reasonable._

### v1.3.8

- Date: 2025-09-03
- Version: v1.3.8
- Original notes: https://github.com/Wombosvideo/tw-animate-css/releases/tag/v1.3.8
- Permalink: https://whatsnew.fyi/product/tw-animate-css/releases/v1.3.8

##### Changelog

- b5ff23a: fix: add support for global CSS variable prefix. Closes #48
- 03e5f12: feat: add support for ng-primitives height variables #56 (thanks @immohammadjaved)
- b076cfb: docs: fix various issues in accordion and collapsible docs
- 9485e33: chore: bump version to 1.3.8 and update dependencies

##### ⚠️ BREAKING CHANGE ⚠️

Adding support for prefixes broke custom spacing. It is recommended that you skip this version if you do not use Tailwind CSS's prefix option, and use v1.4.0 instead. If you are actually using prefixes, you can use a special version supporting prefixes:

```diff
- import "tw-animate-css"; /* Version with spacing support */
+ import "tw-animate-css/prefix"; /* Version with prefix support */
```

_I do not plan to fix the incompatibility between the spacing and prefix versions due to time constraints. Feel free to investigate and open a pull request if you manage to fix it._

### v1.3.7

- Date: 2025-08-16
- Version: v1.3.7
- Original notes: https://github.com/Wombosvideo/tw-animate-css/releases/tag/v1.3.7
- Permalink: https://whatsnew.fyi/product/tw-animate-css/releases/v1.3.7

##### Changelog

- 80dbfcc: feat: add utilities for blur transitions #54 (thanks @coffeeispower)
- dc294f9: docs: add upcoming changes warning
- c640bb8: chore: update dependencies and package manager version
- 9e63e34: chore: bump version to 1.3.7

### v1.3.6

- Date: 2025-07-25
- Version: v1.3.6
- Original notes: https://github.com/Wombosvideo/tw-animate-css/releases/tag/v1.3.6
- Permalink: https://whatsnew.fyi/product/tw-animate-css/releases/v1.3.6

##### Changelog

- 58f3396: fix: allow changing animation parameters for ready-to-use animations
- 8313476: chore: update dependencies nd package manager version
- f81346c: chore: bump version to 1.3.6

##### Issues fixed

- #47: feat: allow developers to change the transition timing function for `--animate-accordion/collapsible-*` (thanks for your help, @mikeploythai)

### v1.3.5

- Date: 2025-07-03
- Version: v1.3.5
- Original notes: https://github.com/Wombosvideo/tw-animate-css/releases/tag/v1.3.5
- Permalink: https://whatsnew.fyi/product/tw-animate-css/releases/v1.3.5

##### Changelog

- b8cc09c: fix: update slide translate calculations to use correct sign for ratio values
- 69fbfcd: chore: bump version to 1.3.5 and update dependencies

##### Issues fixed

- #44 incorrect calculation in slide-in-from-left when using a ratio (thanks for reporting, @alec-liminary)

### v1.3.4

- Date: 2025-06-04
- Version: v1.3.4
- Original notes: https://github.com/Wombosvideo/tw-animate-css/releases/tag/v1.3.4
- Permalink: https://whatsnew.fyi/product/tw-animate-css/releases/v1.3.4

##### Changelog

- 5012a6b: feat: add logical slide translate utilities (#39)
- 041f32f: fix: use default fill-mode `none` instead of `forwards`
- 7f6ad32: chore: bump version to 1.3.4 and update package manager version

##### Issues fixed

- #42: bug: incorrect default value for fill-mode breaking some animations (thanks for your help, @ollema)

##### New features

This release adds logical `start`, `end` slide utilities. Compared to `left` and `right`, these take the text direction into consideration, allowing you remove some redundancy:

```diff
- ltr:slide-in-from-left-4 ltr:slide-out-to-left-4 rtl:slide-in-from-right-4 rtl:slide-out-to-right-4
+ slide-in-from-start-4 slide-out-to-start-4
```

### v1.3.3

- Date: 2025-06-01
- Version: v1.3.3
- Original notes: https://github.com/Wombosvideo/tw-animate-css/releases/tag/v1.3.3
- Permalink: https://whatsnew.fyi/product/tw-animate-css/releases/v1.3.3

> [!CAUTION]
> Bug #42 was introduced in this version, so you might want to skip this version.

##### Changelog

- ccfe1ec: feat: add support for Kobalte UI variables to accordion and collapsible animations #37
- 919999e: fix: add CSS variables for animation utilities #40
- ffce555: chore: bump version to 1.3.3

##### Issues fixed

- #34: Setting fill-mode-* has no effect
- #36 (partially): Support Arbitrary Custom Properties for Accordion Animations

### v1.3.2

- Date: 2025-05-29
- Version: v1.3.2
- Original notes: https://github.com/Wombosvideo/tw-animate-css/releases/tag/v1.3.2
- Permalink: https://whatsnew.fyi/product/tw-animate-css/releases/v1.3.2

##### Changelog

- 493b3aa: fix: duration not applied due to property initial value
- e7b4aac: chore: bump version to 1.3.2

### v1.3.1

- Date: 2025-05-29
- Version: v1.3.1
- Original notes: https://github.com/Wombosvideo/tw-animate-css/releases/tag/v1.3.1
- Permalink: https://whatsnew.fyi/product/tw-animate-css/releases/v1.3.1

##### Changelog

- e59dfed: fix: add @‌property declarations for animation variables to enhance inheritance control #33 (thanks @jinyongp)
- 28156a2: fix: move @‌property declarations to the :root level
- 6c0f52e: chore: bump version to 1.3.1 and update dependencies

##### Issues fixed

- #32: Animation on parent element unexpectedly inherits to all child elements

### v1.3.0

- Date: 2025-05-16
- Version: v1.3.0
- Original notes: https://github.com/Wombosvideo/tw-animate-css/releases/tag/v1.3.0
- Permalink: https://whatsnew.fyi/product/tw-animate-css/releases/v1.3.0

##### Changelog

- 6dba4b0: fix: align syntax with Tailwind CSS syntax
- c82b41c: docs: add tree-shaking note
- 33b4e50: feat: add animation-duration-* utility
- a6fcd13: chore: bump version to 1.3.0 and update dependencies

###### New features

I've decided to add a `animation-duration-*` utility which should be used to define animation durations in the future. For now, `duration-*` is still supported to remain compatible with `tailwindcss-animate`.

This utility was added so you can define different durations for transitions and animations. Probably not something many people have a use case for, but I didn't want to define an own `duration-*` utility to _actually_ set `animation-duration`. Please open an issue if you prefer to keep using `duration-*` instead of `animation-duration-*`.

###### Breaking Change

`zoom-in-*` and `zoom-out-*` utilities now require ratios to be specified differently:

```diff
- zoom-in-[1/2]
+ zoom-in-1/2
```

I don't expect this to affect many people, which is why this is not a major release. If you are affected by this, let me know.