An open source design system that's fully customizable and agent ready
TypeScript
Add one month of Astryx blog post (#3717)
Liya41507fc1e463
diff --git a/apps/docsite/public/blog/one-month-of-astryx/community-showcase.png b/apps/docsite/public/blog/one-month-of-astryx/community-showcase.pngnew file mode 100644index 0000000000..e25e8c8bcdBinary files /dev/null and b/apps/docsite/public/blog/one-month-of-astryx/community-showcase.png differdiff --git a/apps/docsite/public/blog/one-month-of-astryx/header.jpg b/apps/docsite/public/blog/one-month-of-astryx/header.jpgnew file mode 100644index 0000000000..1675ae7bfdBinary files /dev/null and b/apps/docsite/public/blog/one-month-of-astryx/header.jpg differdiff --git a/apps/docsite/src/__tests__/blog.test.ts b/apps/docsite/src/__tests__/blog.test.tsindex 8d2143a6c8..17a1dc2f6e 100644--- a/apps/docsite/src/__tests__/blog.test.ts+++ b/apps/docsite/src/__tests__/blog.test.ts@@ -91,6 +91,15 @@ describe('validatePostFrontmatter', () => {expect(meta.coverImage).toBeNull();expect(meta.relatedDocs).toBeNull();expect(meta.updatedAt).toBeNull();+ expect(meta.dek).toBeNull();+ });++ it('accepts an optional article dek', () => {+ const meta = validatePostFrontmatter('slug', {+ ...VALID_FM,+ dek: '[Launch](/blog/introducing-astryx). One month in.',+ });+ expect(meta.dek).toBe('[Launch](/blog/introducing-astryx). One month in.');});it.each(['title', 'description', 'date', 'type'])('requires "%s"', field => {diff --git a/apps/docsite/src/components/blog/BlogArticle.tsx b/apps/docsite/src/components/blog/BlogArticle.tsxindex 6099c29b11..01ec8b9174 100644--- a/apps/docsite/src/components/blog/BlogArticle.tsx+++ b/apps/docsite/src/components/blog/BlogArticle.tsx@@ -20,6 +20,7 @@ import {ClickableCard} from '@astryxdesign/core/ClickableCard';import {typeScaleVars} from '@astryxdesign/core/theme/tokens.stylex';import type {BlogPost} from '../../lib/blog/schema';import {POST_TYPE_LABELS} from '../../lib/blog/schema';+import {MarkdownText} from '../MarkdownText';import {AuthorByline} from './AuthorByline';import {ReleaseCoverArt} from './ReleaseCoverArt';import {parseReleaseVersion} from '../../lib/blog/release';@@ -76,9 +77,9 @@ export function BlogArticle({post}: BlogArticleProps) {<Heading level={1} type="display-1">{post.title}</Heading>- <Text type="large" weight="normal" color="secondary">- {post.description}- </Text>+ <MarkdownText type="large" weight="normal" color="secondary">+ {post.dek ?? post.description}+ </MarkdownText><AuthorBylineauthors={post.authors}date={post.date}diff --git a/apps/docsite/src/content/blog/README.md b/apps/docsite/src/content/blog/README.mdindex 3bec56cbb6..695f784216 100644--- a/apps/docsite/src/content/blog/README.md+++ b/apps/docsite/src/content/blog/README.md@@ -56,6 +56,7 @@ headings, code blocks, lists, links. The body is rendered with `Markdown`.| Field | Type | Notes || ---------------- | ---------------- | --------------------------------------------------------------------------------------------------------- || `updatedAt` | `YYYY-MM-DD` | Shows an "Updated" date; does not replace `date`. |+| `dek` | string | Article-only subtitle/dek. Supports inline Markdown links. || `draft` | boolean | `true` keeps the post in the repo but out of production output. || `coverImage` | string | Path to a custom cover image (e.g. `/blog/<slug>/cover.png`). || `coverAlt` | string | **Required when `coverImage` is set.** Alt text for the cover. |diff --git a/apps/docsite/src/content/blog/authors.ts b/apps/docsite/src/content/blog/authors.tsindex 70dc64f1cd..54fe48867f 100644--- a/apps/docsite/src/content/blog/authors.ts+++ b/apps/docsite/src/content/blog/authors.ts@@ -3,8 +3,8 @@/*** @file authors.ts*- * Shared author registry for the blog. Posts reference authors by key in their- * frontmatter (`authors: ["team"]`) so profile metadata is defined once.+ * Shared author registry for the blog. Posts reference team or individual+ * authors by key in their frontmatter so profile metadata is defined once.** For GitHub-backed authors, set `github` and the site derives a stable avatar* and profile link from github.com without fetching profile data at build time.@@ -63,6 +63,14 @@ export const authors = {github: 'josephfarina',role: 'Engineering',},+ liya: {+ name: 'Liya',+ github: 'liyalabubu',+ },+ ernest: {+ name: 'Ernest',+ github: 'ernestt',+ },} as const satisfies Record<string, AuthorProfile>;/**diff --git a/apps/docsite/src/content/blog/posts/one-month-of-astryx.md b/apps/docsite/src/content/blog/posts/one-month-of-astryx.mdnew file mode 100644index 0000000000..8f345b171b--- /dev/null+++ b/apps/docsite/src/content/blog/posts/one-month-of-astryx.md@@ -0,0 +1,52 @@+---+slug: one-month-of-astryx+title: 'One Month of Astryx'+description: "One month in: where Astryx stands and where we're taking it."+dek: "[Launched June 18, 2026](/blog/introducing-astryx). One month in: where Astryx stands and where we're taking it."+date: '2026-07-22'+type: 'update'+authors: [liya, ernest]+tags: [astryx, design-system, open-source]+coverImage: '/blog/one-month-of-astryx/header.jpg'+coverAlt: 'One Month of Astryx header artwork with product screenshots around the words 1 month'+relatedDocs:+ - title: 'Introducing Astryx'+ href: '/blog/introducing-astryx'+---++A month ago we open-sourced **Astryx**, a code-first, AI-fluent React + StyleX design system, built and refined inside Meta for eight years. The goal: give every builder, human or agent, a design system that's fully customizable, production-grade, and legible to the tools now writing most of our UI. One month in, the early signal says the bet resonates.++## By the numbers (first month)++- **GitHub:** 10.3K stars · 758 forks · peaked at #2 on GitHub Trending across all repos during launch week+- **npm:** @astryxdesign/core 190K · cli 126K · themes 480K across 7 themes+- **[astryx.atmeta.com](http://astryx.atmeta.com/):** 224K visitors · 1.79M page views+- **Community contributions:** 87 people opened PRs · 61 authors pushed 815 commits to all branches++## Built with Astryx++Real projects shipped on Astryx within the first month, from a company that [rebuilt its entire site within hours of release](https://moonveil.ai/) to a growing set of community sites now in production.++++## What the community told us++Discussion converged on what makes Astryx different: the CLI, MCP server, and agent-first architecture:++- Dominic Nguyen (Chromatic & Storybook, Founder) described Astryx as **"infrastructure for a world where agents create most UI"** in a post that became the most-engaged Astryx mention anywhere ([link](https://www.linkedin.com/posts/domyen_meta-just-open-sourced-a-design-system-theyve-share-7478518968098529280-R3p4/)).+- Aurora Scharff (React/Vercel, Engineer) profiled the Astryx site and, with a Cache Components migration, made navigation **feel instant and up to 3x faster** ([link](https://x.com/aurorascharff/status/2078110561640845708)).+- Yangshun Tay (GreatFrontEnd, Co-founder) dubbed Astryx **"Tokenmaxxing done right,"** praising its extensive component set (including agentic UI), flexible CSS-variable theming, and AI-friendly CLI ([link](https://www.linkedin.com/posts/yangshun_meta-just-released-a-new-frontend-open-source-ugcPost-7477245799542837248-pcwN/)).+- Independent, source-level analyses appeared organically in the [Japanese](https://x.com/wataryooou/status/2070445582993244377), [Korean](https://x.com/ngnicky/status/2074380595078258779), and [Chinese](https://m.sohu.com/a/1042830838_120333371) developer communities within days.+- The community is contributing back, from Figma mapping work to developers digging into the MCP internals with us, and momentum is growing toward community-led themes and translations.++## Where we're headed++The launch was the start, not the finish. Our focus now is quality and depth, including hardening components, expanding themes and templates, tightening the AI-authoring loop (vibe tests + design-judge), and making it easier for external contributors to build with us. Community contributions are a first-class input from here on.++## Thank you++To everyone who starred, shared, filed issues, and shipped PRs, thank you. Astryx is better because of you, and we're just getting started.++## Show us what you built++We're gathering standout case studies built with Astryx. If you've shipped or are building something using Astryx that you'd like to show off, send us a link to your site or a screenshot at **[email protected]**. Select projects will be featured on [**astryx.atmeta.com**](http://astryx.atmeta.com), and we'll send a small token of gratitude in the form of Astryx swag 🤗.diff --git a/apps/docsite/src/lib/blog/posts.mjs b/apps/docsite/src/lib/blog/posts.mjsindex feb4f47036..8a7bdcd8b2 100644--- a/apps/docsite/src/lib/blog/posts.mjs+++ b/apps/docsite/src/lib/blog/posts.mjs@@ -293,6 +293,13 @@ export function validatePostFrontmatter(slug, data) {err(`"updatedAt" must be an ISO date (YYYY-MM-DD), got "${data.updatedAt}"`);}+ if (+ data.dek != null &&+ (typeof data.dek !== 'string' || data.dek.trim() === '')+ ) {+ err('"dek" must be a non-empty string when provided');+ }+if (data.draft != null && typeof data.draft !== 'boolean') {err('"draft" must be a boolean when provided');}@@ -317,6 +324,7 @@ export function validatePostFrontmatter(slug, data) {return {title: data.title,description: data.description,+ dek: data.dek ?? null,date: data.date,type: data.type,authors: data.authors,diff --git a/apps/docsite/src/lib/blog/schema.ts b/apps/docsite/src/lib/blog/schema.tsindex 2bef6022a3..afca847ae8 100644--- a/apps/docsite/src/lib/blog/schema.ts+++ b/apps/docsite/src/lib/blog/schema.ts@@ -51,6 +51,8 @@ export interface BlogPost {title: string;/** Card excerpt, article dek, and default meta description. */description: string;+ /** Optional article-only dek. Supports inline Markdown links. */+ dek: string | null;/** Publish date (ISO YYYY-MM-DD). Default sort key. */date: string;/** Primary editorial organization/filter. */