Post

react.dev is designed for folks who are new to React or are learning basic React concepts. While we'd love to have docs for more advanced users of React (e.g. libraries, frameworks, build tools, etc.) we don't have the resources to make that happen today.

Because react.dev's audience is new users, the recommendations are also tailored to new users. We don't want to recommend a path for new user where they may have to rewrite a significant part of their app to get a feture they figure out they need down the line

Its hard to recommend a build tool to someone new to React knowing that they might find themselves needing a different rendering strategy (e.g. CSR, SSG, SSR) per route, with data fetching included

I never really got the "let's just hide the complexity to avoid confusing the audience" argument. These new devs end up battling reduced portability due to runtime constraints from the framework, jargon overload and overall complexity, just because they might need some feature in the future? 🤷‍♂️

If you have a solution to bundling, routing, code splitting, and data fetching in a composable way that is just as good as a solution that integrates all of them, I'd genuinely love to see it. With the current landscape I think there are significant advantages to solving these problems together.

I don't think about this problem as hiding complexity but providing recommendation that best serves the audience. Recommending a solution that leads people down a path to yet another rewrite doesn't feel right. Ideally, everyone would understand the tradeoffs and decide for themselves