# class-variance-authority changelog

> Type-safe variant APIs for building component class-name systems.

- Vendor: Joe Bell
- Category: Frameworks & Libraries
- Official site: https://cva.style
- Tracked by: What's New (https://whatsnew.fyi/product/class-variance-authority)
- Harvested from: GitHub (joe-bell/cva)
- 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.0.0-beta.8

- Date: 2026-07-15
- Version: v1.0.0-beta.8
- Original notes: https://github.com/joe-bell/cva/releases/tag/v1.0.0-beta.8
- Permalink: https://whatsnew.fyi/product/class-variance-authority/releases/v1.0.0-beta.8
- Labels: Pre-release

- **added** — Introduce internal variants feature

##### What's Changed

* feat(cva): introduce [internal variants](https://cva.style/beta/getting-started/variants/#internal-variants) by @joe-bell in https://github.com/joe-bell/cva/pull/382

**Full Changelog**: https://github.com/joe-bell/cva/compare/v1.0.0-beta.7...v1.0.0-beta.8

### v1.0.0-beta.7

- Date: 2026-07-13
- Version: v1.0.0-beta.7
- Original notes: https://github.com/joe-bell/cva/releases/tag/v1.0.0-beta.7
- Permalink: https://whatsnew.fyi/product/class-variance-authority/releases/v1.0.0-beta.7
- Labels: Pre-release

- **changed** — Migrate packages to tsdown
- **added** — Add performance benchmark CI with fork-safe sticky PR comments
- **changed** — Adopt clearer sticky comment benchmark layout

##### What's Changed

* build: migrate packages to tsdown, document build & release by @joe-bell in https://github.com/joe-bell/cva/pull/385
* feat(ci): add performance benchmark CI with fork-safe sticky PR comments by @joe-bell in https://github.com/joe-bell/cva/pull/378
* docs(bench): adopt clearer sticky comment benchmark layout by @joe-bell in https://github.com/joe-bell/cva/pull/386
* Add maintenance-mode toolchain note for `class-variance-authority` by @joe-bell in https://github.com/joe-bell/cva/pull/388


**Full Changelog**: https://github.com/joe-bell/cva/compare/v1.0.0-beta.6...v1.0.0-beta.7

### v1.0.0-beta.6

- Date: 2026-07-10
- Version: v1.0.0-beta.6
- Original notes: https://github.com/joe-bell/cva/releases/tag/v1.0.0-beta.6
- Permalink: https://whatsnew.fyi/product/class-variance-authority/releases/v1.0.0-beta.6
- Labels: Pre-release

- **fixed** — Export types reachable from public signatures

##### What's Changed

* fix(cva): export types reachable from public signatures by @joe-bell in https://github.com/joe-bell/cva/pull/381

**Full Changelog**: https://github.com/joe-bell/cva/compare/v1.0.0-beta.5...v1.0.0-beta.6

### v1.0.0-beta.5

- Date: 2026-07-10
- Version: v1.0.0-beta.5
- Original notes: https://github.com/joe-bell/cva/releases/tag/v1.0.0-beta.5
- Permalink: https://whatsnew.fyi/product/class-variance-authority/releases/v1.0.0-beta.5
- Labels: Pre-release

- **added** — Experimental getSchema function and composes property to replace compose function
- **changed** — Migrate bundlesize to size-limit
- **changed** — Upgrade Node.js to version 24
- **fixed** — Replace deprecated Zod 4 APIs in tutorials schema

##### What's Changed

###### Features

* Experimental [`getSchema`](https://cva.style/beta/getting-started/utilities/#getschema) function and [`composes`](https://cva.style/beta/getting-started/composing-components/) property (replaces `compose` function) by @joe-bell in https://github.com/joe-bell/cva/pull/333

###### Clean-up

* Migrate `bundlesize` to `size-limit` by @mateothegreat in https://github.com/joe-bell/cva/pull/346
* Spring Cleaning 2026 by @joe-bell in https://github.com/joe-bell/cva/pull/358
* docs: add Deno to installation instructions by @bartlomieju in https://github.com/joe-bell/cva/pull/360
* docs: expand AGENTS.md with architecture and workflow guidance by @joe-bell in https://github.com/joe-bell/cva/pull/362
* docs: unify docs into a single versioned Starlight site by @joe-bell in https://github.com/joe-bell/cva/pull/363
* refactor(docs): migrate docs/beta package to docs by @joe-bell in https://github.com/joe-bell/cva/pull/364
* refactor(docs): replace inline styles with Tailwind v4 utilities by @joe-bell in https://github.com/joe-bell/cva/pull/366
* feat(docs): migrate hosting from Vercel to Cloudflare Workers by @joe-bell in https://github.com/joe-bell/cva/pull/365
* chore: syncpack clean-up by @joe-bell in https://github.com/joe-bell/cva/pull/367
* fix(docs): replace deprecated Zod 4 APIs in tutorials schema by @joe-bell in https://github.com/joe-bell/cva/pull/368
* Upgrade Node.js to 24 and migrate syncpack config by @joe-bell in https://github.com/joe-bell/cva/pull/369
* docs: document Cloudflare Workers Builds deployment setup by @joe-bell in https://github.com/joe-bell/cva/pull/370
* Reorder redirects to optimize Cloudflare performance warnings by @joe-bell in https://github.com/joe-bell/cva/pull/371
* fix(docs): redirect cross-version page gaps to version home by @joe-bell in https://github.com/joe-bell/cva/pull/372
* docs(agents): make the guide self-improving by @joe-bell in https://github.com/joe-bell/cva/pull/373
* Add agent skills and MCP server configuration by @joe-bell in https://github.com/joe-bell/cva/pull/374
* Add deslop skill for cleaning up AI-generated code by @joe-bell in https://github.com/joe-bell/cva/pull/375
* Annotate lint-staged config with Configuration type by @joe-bell in https://github.com/joe-bell/cva/pull/376
* Clarify pre-commit hook policy and setup for agents by @joe-bell in https://github.com/joe-bell/cva/pull/377

##### New Contributors
* @mateothegreat made their first contribution in https://github.com/joe-bell/cva/pull/346
* @bartlomieju made their first contribution in https://github.com/joe-bell/cva/pull/360

**Full Changelog**: https://github.com/joe-bell/cva/compare/v1.0.0-beta.4...v1.0.0-beta.5

### v1.0.0-beta.4

- Date: 2025-05-20
- Version: v1.0.0-beta.4
- Original notes: https://github.com/joe-bell/cva/releases/tag/v1.0.0-beta.4
- Permalink: https://whatsnew.fyi/product/class-variance-authority/releases/v1.0.0-beta.4
- Labels: Pre-release

##### What's Changed
* docs: Update intellisense regex to handle inner brackets by @longzheng in https://github.com/joe-bell/cva/pull/332
* docs: migrate from classregex to classfunctions by @yutakobayashidev in https://github.com/joe-bell/cva/pull/341
* docs: missing comma by @zambo in https://github.com/joe-bell/cva/pull/334
* fix: types field should appear first in the exports section by @ryanelian in https://github.com/joe-bell/cva/pull/343

##### New Contributors
* @longzheng made their first contribution in https://github.com/joe-bell/cva/pull/332
* @yutakobayashidev made their first contribution in https://github.com/joe-bell/cva/pull/341
* @zambo made their first contribution in https://github.com/joe-bell/cva/pull/334
* @ryanelian made their first contribution in https://github.com/joe-bell/cva/pull/343

**Full Changelog**: https://github.com/joe-bell/cva/compare/v1.0.0-beta.3...v1.0.0-beta.4

### v1.0.0-beta.3

- Date: 2025-01-18
- Version: v1.0.0-beta.3
- Original notes: https://github.com/joe-bell/cva/releases/tag/v1.0.0-beta.3
- Permalink: https://whatsnew.fyi/product/class-variance-authority/releases/v1.0.0-beta.3
- Labels: Pre-release

##### What's Changed
* Extend Component Documentation by @joe-bell in https://github.com/joe-bell/cva/pull/176
* docs: Update IntelliSense for WebStorm in latest doc by @evan-liu in https://github.com/joe-bell/cva/pull/323
* Include `bigint` within `ClassValue`, export `Class*` types by @joe-bell in https://github.com/joe-bell/cva/pull/328
* Loosen TypeScript dependency range by @joe-bell in https://github.com/joe-bell/cva/pull/329
* Upgrade Project Dependencies by @joe-bell in https://github.com/joe-bell/cva/pull/330
* Add `@arethetypeswrong/cli` to check for faulty exports by @joe-bell in https://github.com/joe-bell/cva/pull/331

##### New Contributors
* @evan-liu made their first contribution in https://github.com/joe-bell/cva/pull/323

**Full Changelog**: https://github.com/joe-bell/cva/compare/v1.0.0-beta.2...v1.0.0-beta.3

### v1.0.0-beta.2

- Date: 2024-11-26
- Version: v1.0.0-beta.2
- Original notes: https://github.com/joe-bell/cva/releases/tag/v1.0.0-beta.2
- Permalink: https://whatsnew.fyi/product/class-variance-authority/releases/v1.0.0-beta.2
- Labels: Pre-release

##### What's Changed

* chore: Remove Minification by @joe-bell in https://github.com/joe-bell/cva/pull/282
* docs: Add LICENSE Comments by @joe-bell in https://github.com/joe-bell/cva/pull/283
* chore: move clsx dependency to caret/semver range by @philwolstenholme in https://github.com/joe-bell/cva/pull/316

##### New Contributors

* @philwolstenholme made their first contribution in https://github.com/joe-bell/cva/pull/316

### v0.7.1

- Date: 2024-11-26
- Version: v0.7.1
- Original notes: https://github.com/joe-bell/cva/releases/tag/v0.7.1
- Permalink: https://whatsnew.fyi/product/class-variance-authority/releases/v0.7.1

##### What's Changed

* Add LICENSE Comments by @joe-bell in https://github.com/joe-bell/cva/pull/283
* chore: move clsx dependency to caret/semver range by @philwolstenholme in https://github.com/joe-bell/cva/pull/316

##### New Contributors

* @philwolstenholme made their first contribution in https://github.com/joe-bell/cva/pull/316

**Full Changelog**: https://github.com/joe-bell/cva/compare/v0.7.0...v0.7.1

### v0.7.0

- Date: 2023-07-17
- Version: v0.7.0
- Original notes: https://github.com/joe-bell/cva/releases/tag/v0.7.0
- Permalink: https://whatsnew.fyi/product/class-variance-authority/releases/v0.7.0

##### What's Changed

* Upgrade to `clsx@2.0.0` by @joe-bell in https://github.com/joe-bell/cva/pull/185

**Full Changelog**: https://github.com/joe-bell/cva/compare/v0.6.1...v0.7.0

### v0.6.1

- Date: 2023-06-26
- Version: v0.6.1
- Original notes: https://github.com/joe-bell/cva/releases/tag/v0.6.1
- Permalink: https://whatsnew.fyi/product/class-variance-authority/releases/v0.6.1

##### What's Changed
* Add missing `license` key in `package.json`
* Upgrade to `typescript@5.1.3` by @joe-bell in https://github.com/joe-bell/cva/pull/175

**Full Changelog**: https://github.com/joe-bell/cva/compare/v0.6.0...v0.6.1