Astryx Release Notes: Complete Version History and Package Changelogs

Astryx release notes are distributed across per-package 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	Component library, StyleX integration, theming APIs
@astryxdesign/cli	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	Rich-text editor components
@astryxdesign/charts	packages/charts/CHANGELOG.md	Data visualization components
@astryxdesign/build	packages/build/CHANGELOG.md	Build tooling, Vite/Rollup configuration
@astryxdesign/lab	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, cli, butter theme example.

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:

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)

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, charts changelog

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, lab changelog

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:

# List all available components

astryx component --list

# Detailed view of specific component

astryx component Button --dense

Sources: build changelog, cli changelog

How to Upgrade Astryx Packages

Upgrade individual packages to latest versions:

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

For systematic upgrades across a monorepo:

# Dry-run to preview changes

astryx upgrade

# Apply codemods automatically

astryx upgrade --apply

The astryx upgrade command consults 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 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 for release notifications

Frequently Asked Questions

Where are the official Astryx release notes located?

Official release notes are distributed across multiple 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 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 and affects bundling performance, dev server startup times, and tree-shaking behavior for consumers using the official Astryx build configuration.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}