Stylex create app help and templates by abhakat · Pull Request #1464 · facebook/stylex

abhakat · 2026-01-26T07:00:53Z

What changed / motivation ?

Please include relevant motivation and context

Improved create-stylex-app CLI and fix example template dependencies.

CLI Changes:

Improve --help output to show templates in a formatted multi-line list
with descriptions and "(recommended)" labels instead of a comma-separated string

Example Fixes:

example-react-router: Remove vite-plugin-devtools-json (incompatible with Vite 7)
example-redwoodsdk: Add missing capnweb peer dependency, align react-server-dom-webpack
to canary version, update @cloudflare/workers-types for wrangler compatibility
example-storybook: Add example:dev script so generated project has npm run dev,
upgrade Vitest from v3 to v4
example-rollup: Add missing @babel/preset-flow (required by babel.config.mjs but
wasn't in package.json)

These fixes ensure all templates work out-of-the-box when users run create-stylex-app.

Template Fixes

Next.js

Webpack & Rollup

Fixed missing @babel/preset-flow dependency.

Waku

Fixed waku version mismatch (waku@1.0.0-alpha.0 → waku@0.27.1) to resolve
react-server-dom-webpack peer dependency conflict.

RedwoodSDK

Fixed react-server-dom-webpack version mismatch (19.2.1 → 19.3.0-canary-561ee24d-20251101) to
match the canary React version.

Storybook

Fixed @vitest/browser version mismatch (^3.2.4 → ^4.0.13) to match vitest@^4.0.13.

Published Main Issue: react@19.3.0-canary vs react-server-dom-webpack@19.2.1 mismatch
Your Branch Status: ✅ Fixed (matching canary versions)

Linked PR/Issues

Fixes #1456

Additional Context

I installed dependencies and tested all of the templates which had npm run dev configs.

Testing process:

Built create-stylex-app locally
Created test projects for react-router, redwoodsdk, storybook, and rollup
Verified npm install succeeds without ERESOLVE errors
Verified npm run dev/build works for each template

Pre-flight checklist

I have read the contributing guidelines
Contribution Guidelines
Performed a self-review of my code

Update the help display to show available frameworks in a formatted multi-line list with descriptions and alignment, instead of a simple comma-separated string. The new format displays each template on its own line with: - Template ID (left-aligned with consistent padding) - Description of the template - "(recommended)" label for recommended templates Also simplify the --template option description to show only the supported github:owner/repo/path format.

@ts-expect-error

Remove vite-plugin-devtools-json as it does not support Vite 7. The plugin only supports vite@^2.7.0 || ^3.0.0 || ^4.0.0 || ^5.0.0 || ^6.0.0, causing npm install to fail with ERESOLVE peer dependency conflicts. This fix is required for create-stylex-app to work correctly, since the CLI fetches templates from the main branch on GitHub. Without this change, users selecting the react-router framework will get a broken project that fails to install dependencies. Changes: - Remove vite-plugin-devtools-json from devDependencies - Remove the import and devtoolsJson() plugin call from vite.config.ts - Remove now-unnecessary @ts-expect-error comments

Fix multiple dependency issues that prevented npm install from succeeding when using the redwoodsdk template with create-stylex-app. Issues fixed: 1. react-server-dom-webpack version mismatch: Updated from 19.2.1 to 19.3.0-canary-561ee24d-20251101 to align with react and react-dom versions. The old version required peer react@^19.2.1 which conflicted with the canary React version. 2. Missing capnweb peer dependency: Added capnweb@~0.2.0 which is required by rwsdk@1.0.0-beta.31 but was not installed. 3. @cloudflare/workers-types version: Updated from pinned 4.20251121.0 to ^4.20260120.0 to be compatible with wrangler@4.60.0 (the latest version that npm resolves from ^4.50.0). Testing process: 1. Run: node .../create-stylex-app/lib/index.js test-redwoodsdk --framework redwoodsdk --no-install 2. Apply fixes manually to generated project (until merged to main) 3. Run: npm install (should succeed without ERESOLVE errors) 4. Run: npm run dev (should start the dev server)

Add example:dev script and upgrade Vitest dependencies to fix issues when using the storybook template with create-stylex-app. Changes: 1. Add example:dev script that runs the Storybook dev server. The CLI's normalizeScripts function strips the "example:" prefix, so the generated project will have a "dev" script. This fixes the "Next steps" output which previously showed "npm run dev" but no dev script existed. 2. Upgrade @vitest/browser and @vitest/coverage-v8 from ^3.2.4 to ^4.0.13 (major version upgrade to Vitest v4). Testing: 1. Run: node .../create-stylex-app/lib/index.js test-storybook --framework storybook 2. Run: npm run dev (starts Storybook on port 6006)

The babel.config.mjs requires @babel/preset-flow but it was not listed in package.json. This caused the build to fail with "Cannot find module '@babel/preset-flow'" when users tried to build the project. Testing: 1. Run: node .../create-stylex-app/lib/index.js test-rollup --framework rollup 2. Run: npm run dev (or npm run build) 3. Verify: Build succeeds with "created .build/bundle.js"

Regenerate yarn.lock to reflect dependency updates across examples: - example-react-router: Removed vite-plugin-devtools-json - example-redwoodsdk: Added capnweb, updated react-server-dom-webpack and @cloudflare/workers-types - example-storybook: Upgraded @vitest/browser and @vitest/coverage-v8 to v4 - example-rollup: Added @babel/preset-flow

vercel · 2026-01-26T07:00:59Z

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
stylex	Skipped		Feb 3, 2026 9:37pm

github-actions · 2026-01-26T07:06:29Z

workflow: benchmarks/perf

Comparison of performance test results, measured in operations per second. Larger is better.
yarn workspace v1.22.22
yarn run v1.22.22
$ node ./compare.js /tmp/tmp.cdIQI3O2QL /tmp/tmp.4ntFWGxVga

Results	Base	Patch	Ratio

babel-plugin: stylex.create
· basic create	476	534	1.12	!!
· complex create	59	65	1.10	!!

babel-plugin: stylex.createTheme
· basic themes	314	445	1.42	!!
· complex themes	30	35	1.17	!!
Done in 0.08s.
Done in 0.31s.

github-actions · 2026-01-26T07:06:43Z

workflow: benchmarks/size

Comparison of minified (terser) and compressed (brotli) size results, measured in bytes. Smaller is better.
yarn workspace v1.22.22
yarn run v1.22.22
$ node ./compare.js /tmp/tmp.KtNHLi3cnl /tmp/tmp.Y6j0SRPlyK

Results	Base	Patch	Ratio

@stylexjs/stylex/lib/cjs/stylex.js
· compressed	1,311	1,311	1.00
· minified	4,150	4,150	1.00

@stylexjs/stylex/lib/cjs/inject.js
· compressed	1,793	1,793	1.00
· minified	4,915	4,915	1.00

benchmarks/size/.build/bundle.js
· compressed	496,650	496,650	1.00
· minified	4,847,840	4,847,840	1.00

benchmarks/size/.build/stylex.css
· compressed	99,853	99,853	1.00
· minified	747,541	747,541	1.00
Done in 0.08s.
Done in 0.34s.

- Rename package to create-stylex-app for npx usage - Remove private flag to allow publishing - Add templates.json to published files - Bump version to 0.1.0-alpha.2

mellyeliu · 2026-02-02T20:49:09Z

packages/@stylexjs/create-stylex-app/package.json

-  "name": "@stylexjs/create-stylex-app",
-  "version": "0.1.0",
+  "name": "create-stylex-app",
+  "version": "0.1.0-alpha.2",


Suggested change

"version": "0.1.0-alpha.2",

"version": "0.17.6-alpha.2",

mellyeliu

Overall LG, please add screenshots of the different commands (help) etc. Then we can test it out properly with an alpha release.

Update version from 0.1.0-alpha.2 to 0.17.6-alpha.2 per review feedback.

Anay Bhakat added 6 commits January 25, 2026 22:48

abhakat requested review from ezzak, mellyeliu, necolas, nmn and vincentriemer as code owners January 26, 2026 07:00

meta-cla bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Jan 26, 2026

Publish create-stylex-app to npm

f9aa382

- Rename package to create-stylex-app for npx usage - Remove private flag to allow publishing - Add templates.json to published files - Bump version to 0.1.0-alpha.2

vercel bot temporarily deployed to Preview January 28, 2026 18:03 Inactive

mellyeliu reviewed Feb 2, 2026

View reviewed changes

mellyeliu approved these changes Feb 2, 2026

View reviewed changes

[create-stylex-app] Align version with StyleX versioning scheme

400f84d

Update version from 0.1.0-alpha.2 to 0.17.6-alpha.2 per review feedback.

vercel bot temporarily deployed to Preview February 3, 2026 21:37 Inactive

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Stylex create app help and templates#1464

Stylex create app help and templates#1464
abhakat wants to merge 8 commits intomainfrom
stylex-create-app-help-and-templates

abhakat commented Jan 26, 2026 •

edited

Loading

Uh oh!

vercel bot commented Jan 26, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 26, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Jan 26, 2026 •

edited

Loading

Uh oh!

mellyeliu Feb 2, 2026

Uh oh!

mellyeliu left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

abhakat commented Jan 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What changed / motivation ?

Linked PR/Issues

Additional Context

Pre-flight checklist

Uh oh!

vercel bot commented Jan 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

workflow: benchmarks/perf

Uh oh!

github-actions bot commented Jan 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

workflow: benchmarks/size

Uh oh!

mellyeliu Feb 2, 2026

Choose a reason for hiding this comment

Uh oh!

mellyeliu left a comment

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

abhakat commented Jan 26, 2026 •

edited

Loading

vercel bot commented Jan 26, 2026 •

edited

Loading

github-actions bot commented Jan 26, 2026 •

edited

Loading

github-actions bot commented Jan 26, 2026 •

edited

Loading