Skip to content

Refactor docs website to use React Router #1111

@jderochervlk

Description

@jderochervlk

The doc site has been slowly added to and tweaked over the years, and we've come to rely on more and more custom scripts. The site is also still on the Next legacy page router. I doubt this will be actively maintained in the future.

To reduce the amount of custom scripts and reduce the complexity of the build steps and development experience we need to switch the framework.

React Router is very simple and takes advantage of basic web apis, which we now have great bindings for that the rescript team maintains. This can help us provide a great example site that doesn't rely on a lot of external dependencies.

React Router will also support React Server Components soon, so we can adopt those as needed.

Using Vite as the build tool will allow for adoption of the React Compiler which can improve site performance. Vite rolldown, V7, will also improve site build times.

For now we can deploy a static build, but in the future we can adopt SSR as needed.

Sub-issues

Metadata

Metadata

Assignees

Labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions