# Astryx Release Notes: Complete Version History and Package Changelogs

> Access complete Astryx release notes and version history for each package. Explore detailed changelogs in the repository's CHANGELOG.md files.

- Repository: [Meta/astryx](https://github.com/facebook/astryx)
- Tags: api-reference
- Published: 2026-08-03

---

**Astryx release notes are distributed across per-package [`CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/CHANGELOG.md) files in the `packages/` directory**, with each npm package maintaining its own semantic versioning history.

Astryx is a modular design system from Meta (facebook/astryx) that publishes multiple independent npm packages. Rather than a single root changelog, release history lives in `packages/<name>/CHANGELOG.md` files. This article maps every major version milestone to its source documentation, so developers can trace feature additions, breaking changes, and migration paths with precision.

## How Astryx Release Notes Are Organized

The monorepo structure means version bumps propagate selectively. Core styling infrastructure in `@astryxdesign/core` can advance independently of themes, CLI tooling, or auxiliary packages like charts and rich-text.

All changelogs follow Keep a Changelog format with sections for **Added**, **Changed**, **Deprecated**, **Removed**, **Fixed**, and **Security**. Migration notes appear inline for breaking changes.

### Where to Find Official Release Notes

| Package | Changelog Path | Scope |
|---------|---------------|-------|
| `@astryxdesign/core` | [`packages/core/CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/packages/core/CHANGELOG.md) | Component library, StyleX integration, theming APIs |
| `@astryxdesign/cli` | [`packages/cli/CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/packages/cli/CHANGELOG.md) | CLI commands, codemods, upgrade workflows |
| `@astryxdesign/themes/*` | `packages/themes/<name>/CHANGELOG.md` | Individual theme palettes (butter, chocolate, gothic, etc.) |
| `@astryxdesign/richtext` | [`packages/richtext/CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/packages/richtext/CHANGELOG.md) | Rich-text editor components |
| `@astryxdesign/charts` | [`packages/charts/CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/packages/charts/CHANGELOG.md) | Data visualization components |
| `@astryxdesign/build` | [`packages/build/CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/packages/build/CHANGELOG.md) | Build tooling, Vite/Rollup configuration |
| `@astryxdesign/lab` | [`packages/lab/CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/packages/lab/CHANGELOG.md) | Visual regression and snapshot utilities |

## Astryx v0.17.5 Release Notes (Latest)

Released across `@astryxdesign/core`, `@astryxdesign/cli`, and all theme packages, v0.17.5 pulls in **StyleX v0.17.5** with expanded CSS support.

### Key Changes in v0.17.5

- **Full StyleX v0.17.5 support**: New CSS `@starting-style`, `@container` queries, and additional pseudo-class handling
- **Expanded theming API**: New brand palette themes including butter, chocolate, and gothic variants in `packages/themes/`
- **CLI automation**: Automated codemod runner and streamlined `astryx upgrade` workflow
- **AI-assisted testing**: `vibe-tests` integration for AI-generated component validation

Consult the source changelogs: [core](https://github.com/facebook/astryx/blob/main/packages/core/CHANGELOG.md), [cli](https://github.com/facebook/astryx/blob/main/packages/cli/CHANGELOG.md), [butter theme example](https://github.com/facebook/astryx/blob/main/packages/themes/butter/CHANGELOG.md).

## Astryx v0.16.0 Release Notes

The v0.16.0 release introduced the **StyleX "when" API** for ancestor/descendant state styling and modernized router integration patterns.

### StyleX `when` API Introduction

The `stylex.when.ancestor()` and `stylex.when.descendant()` methods enable declarative state-dependent styling without JavaScript class toggling:

```tsx
import { stylex } from '@stylex';

const button = stylex.create({
  base: {
    backgroundColor: 'var(--color-primary)',
    color: 'white',
    padding: '8px 16px',
  },
  hover: stylex.when.ancestor(':hover', {
    backgroundColor: 'var(--color-primary-dark)',
  }),
});

export function PrimaryButton({children}) {
  return <button className={stylex.props(button.base, button.hover)}>{children}</button>;
}

```

### Additional v0.16.0 Features

- **`stylex.firstThatWorks()`**: Fallback helper for progressive enhancement of CSS values
- **`useLinkComponent()` pattern**: Router-agnostic anchor component abstraction
- **`astryx upgrade --apply`**: Automatic application of version-migration codemods

Source: [[`packages/core/CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/packages/core/CHANGELOG.md)](https://github.com/facebook/astryx/blob/main/packages/core/CHANGELOG.md)

## Astryx v0.15.3 Release Notes

Focused on auxiliary packages, v0.15.3 expanded editor and visualization capabilities.

### Rich-Text and Charts Updates

- **Rich-text editor**: Block-level styling through StyleX markers in `packages/richtext`
- **Charts package**: Responsive container query support and new `ChartProvider` context API

Source files: [richtext changelog](https://github.com/facebook/astryx/blob/main/packages/richtext/CHANGELOG.md), [charts changelog](https://github.com/facebook/astryx/blob/main/packages/charts/CHANGELOG.md)

## Astryx v0.14.0 Release Notes

Documentation infrastructure and testing utilities received major investment.

### Type-Safe Documentation

Core component props now ship with **JSDoc definitions** in `Component.doc.mjs` companion files, enabling IDE autocompletion and type checking without TypeScript.

### Visual Regression Tooling

Lab utilities gained snapshot testing capabilities for component previews, supporting visual regression detection in CI pipelines.

Sources: [core changelog](https://github.com/facebook/astryx/blob/main/packages/core/CHANGELOG.md), [lab changelog](https://github.com/facebook/astryx/blob/main/packages/lab/CHANGELOG.md)

## Astryx v0.13.1 Release Notes

Build infrastructure modernization and CLI discovery improvements.

### Vite 5 Migration

The build pipeline in `packages/build` migrated to **Vite 5**, yielding faster cold-start bundling and improved tree-shaking.

### CLI Component Discovery

New commands for introspecting available components:

```bash

# List all available components

astryx component --list

# Detailed view of specific component

astryx component Button --dense

```

Sources: [build changelog](https://github.com/facebook/astryx/blob/main/packages/build/CHANGELOG.md), [cli changelog](https://github.com/facebook/astryx/blob/main/packages/cli/CHANGELOG.md)

## How to Upgrade Astryx Packages

Upgrade individual packages to latest versions:

```bash
npm install @astryxdesign/core@latest @astryxdesign/cli@latest

```

For systematic upgrades across a monorepo:

```bash

# Dry-run to preview changes

astryx upgrade

# Apply codemods automatically

astryx upgrade --apply

```

The `astryx upgrade` command consults [`packages/cli/CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/packages/cli/CHANGELOG.md) migration entries to determine which codemods to run for your current version.

## Tracking Future Astryx Releases

Three mechanisms keep release information current:

1. **Per-package changelogs**: Updated on every publish to npm
2. **GitHub tags**: Release snapshots at `https://github.com/facebook/astryx/tags`
3. **Diff inspection**: Compare arbitrary versions via GitHub's tag comparison interface

## Summary

- Astryx release notes live in **package-specific [`CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/CHANGELOG.md) files**, not a single root document
- **v0.17.5** (latest) brings StyleX v0.17.5, expanded theming, and AI testing integration
- **v0.16.0** introduced the `stylex.when` API and `useLinkComponent` pattern
- Upgrade via `npm install` or the `astryx upgrade --apply` CLI command with automatic codemods
- Monitor [`github.com/facebook/astryx/tags`](https://github.com/facebook/astryx/tags) for release notifications

## Frequently Asked Questions

### Where are the official Astryx release notes located?

Official release notes are distributed across multiple [`CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/CHANGELOG.md) files in the `packages/` directory. Each npm package—`@astryxdesign/core`, `@astryxdesign/cli`, themes, charts, rich-text, build, and lab—maintains its own changelog. No single root changelog exists in the facebook/astryx repository.

### How do I upgrade Astryx to the latest version?

Run `npm install @astryxdesign/core@latest @astryxdesign/cli@latest` for targeted upgrades, or use `astryx upgrade --apply` to run automated codemods. The CLI command reads migration rules from [`packages/cli/CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/packages/cli/CHANGELOG.md) and applies transformations based on your current installed versions.

### What is the "when" API introduced in Astryx v0.16.0?

The `stylex.when.ancestor()` and `stylex.when.descendant()` methods enable CSS state styling based on ancestor or descendant element states without JavaScript event handling. This API supports pseudo-classes like `:hover`, `:focus`, and `:disabled` through declarative StyleX definitions, reducing runtime JavaScript overhead.

### Which Astryx version added Vite 5 support?

Version **v0.13.1** migrated the build pipeline to Vite 5. This change lives in [`packages/build/CHANGELOG.md`](https://github.com/facebook/astryx/blob/main/packages/build/CHANGELOG.md) and affects bundling performance, dev server startup times, and tree-shaking behavior for consumers using the official Astryx build configuration.