stylex
stylex copied to clipboard
[Experiment] Migrating docs to fumadocs + waku
What changed / motivation ?
This is partially just a stress test for the Vite implementation of the unplugin package that this PR is stacked on top of.
But this could also be an opportunity to overhaul the documentation website with modern React, RSCs etc.
The choices:
- Fumadocs - this is the most popular documentation framework that uses RSCs
- Waku - fumadocs is primarily for Next.js, but the unplugin package doesn't work with Next.js. If the issues with this setup cannot be resolved, we may consider using Next instead and leverage the postcss plugin there.
- fumadocs-ui - This entire package has been inlined into the project so we can migrate the code from tailwind to stylex and properly dogfood stylex for its own website.
Additional Context
Status
Almost everything works with some annoying bugs when building for prod
- import statements in MDX throw an error in the parser
- There are two other errors in the SSR code somewhere where React is getting an invalid child to render