I've got the base structure of the website in order. I decided to go for Create React App instead of Gatsby because of the complexity of server-rendered libraries. I know that this is going to affect SEO, but I actually don't think SEO is the most important thing at this time.
I saw this docs site as an opportunity to test a new renderer called mdx, that gives us the best of two worlds with both markdown and JSX. This makes it possible to render markdown files as React Components and visa versa.
If someone wants to test the website before merging this initial PR, just checkout the branch, and run
yarn website:develop and CRA will start automatically.
It's currenly located in /website at the root of the project, and is deployed using gh-pages.
The current design is just a suggestion for now, and I'm sure it will be iterated on several times before we decide 100%, but it's a starting point at least.
I've got the base structure of the website in order. I decided to go for Create React App instead of Gatsby because of the complexity of server-rendered libraries. I know that this is going to affect SEO, but I actually don't think SEO is the most important thing at this time.
I saw this docs site as an opportunity to test a new renderer called
mdx, that gives us the best of two worlds with both markdown and JSX. This makes it possible to render markdown files as React Components and visa versa.If someone wants to test the website before merging this initial PR, just checkout the branch, and run
yarn website:developand CRA will start automatically.It's currenly located in
/websiteat the root of the project, and is deployed using gh-pages.The current design is just a suggestion for now, and I'm sure it will be iterated on several times before we decide 100%, but it's a starting point at least.
In this PR, i've deployed a first version of the website here: https://ludens-reklamebyra.github.io/react-crisscross/
A little side note to SEO:
If we are in need of good SEO in the future, I think we have to port this website to server-rendering solution like
nextJSorGatsbyJS.