Closed Jta26 closed 4 months ago
compressed-size: runtime library
Size change: 0.00 kB Total size: 2.52 kB
compressed-size: e2e bundles
Size change: 0.00 kB Total size: 1132.93 kB
This is looking good! One nit before we can ship it:
[ ] Way to ignore certain folders in "node_modules"
FUTURE:
[Map Iterator]
What changed / motivation ?
StyleX needs a bundler integration to work correctly. It also depends on Babel. However, this can be burden when trying to integrate into various projects built with project starters like Next.js, Solid Start and create-react-app. These projects have a complex bundler setup and it can be hard to integrate into them correctly. In some cases, like Next, the tooling may be written in Rust where an integration of the Babel plugin is impossible.
In order to provide a clean and reliable escape hatch for these scenarios, we should have a CLI that transforms an entire folder of JS files and outputs the resulting CSS file. (Tools like Tailwind and PandaCSS similarly side-step the built-in bundler because of how hard it is to integrate)
Expected Behaviour
For this example, consider a Next.js app configured to use the
src/
folder with asrc/app/
within that contains actual routes. When using the CLI, you'd be able to make another folder called, say,source/
and gitignoresrc/
folder. Thesource/
folder would contain all the same files that would normally be defined within thesrc/
folder, but you'd be able to use StyleX.The CLI will then:
source/
folder with the StyleX Babel plugin and output it at the same relative path in thesrc/
folder.src/stylex-bundle.css
.stylex-bundle.css
file. (Configurable)With this process, the StyleX CLI would run first and generate an
src/
folder with your actual source code. After this, the usualnext dev
script will be able to take over and run as usual.Additionally, the CLI should also:
watch
mode so that only the files that are edited are recompiled, and the generated CSS file is updated accordingly.node_modules
packages and write the compiled files in some locations.Finally, there are a few requirements for the configuration (This is probably a lot of the work):
.babelrc
file at the project root. (Next goes into Babel mode if it detect a.babelrc
file)Stretch Goals
Possible tools that can be used:
fb-watchman
is a node client forwatchman
. A tool that tracks file changes within a folderchokidar
node-watch
Recreated from https://github.com/facebook/stylex/pull/412