Documentation suggestions

[johot]

First off thank you for this project, really great!

We wanted to server side render components built in Create React App + TypeScript in our ASP.NET MVC 4 web page. We have gotten it working great but the documentation was missing a lot of things slowing us down. After a lot of trial and error, reading github issues and more I finally created this sample repo: https://github.com/johot/reactjs.net-asp-mvc4-cra-typescript-parcel with my findings.

It has a guide on how to get components from a TypeScript create-react-app projects working server + client side using ReactJS.NET. Also we use parcel for bundling since we wanted a zero config setup, this worked out great and could perhaps be a good fit for the ReactJS.net documentation.

I unfortunately don't have the time to do PRs to this project right now, but maybe parts of my guide can be of help to others.

Anyways the things I wish was mentioned in the documentation are primarily these:

• Without adding JavaScriptEngineSwitcher.V8.Native.win-x86 we could not get it working (C++ redist needed?)
• The need for SetLoadReact(false) to make hooks work. Also something mentioning what SetLoadReact is used for and how it allows us to bundle React ourselves (we had to find this through github issues).
• If mentioning SetLoadReact(false) also explain that ReactDom etc needs to be exposed through the use of global.
• To make things work client side you must also load the script bundle client side with a <script/> tag (this is not mentioned in the server side docs).

Thank you!

[dustinsoftware]

Thanks for the feedback, I’ll go through this and make a few updates

…

On Thu, May 23, 2019 at 06:57, Johan Otterud ***@***.***> wrote: First off thank you for this project, really great! We wanted to server side render components built in Create React App + TypeScript in our ASP.NET MVC 4 web page. We have gotten it working great but the documentation was missing a lot of things slowing us down. After a lot of trial and error, reading github issues and more I finally created this sample repo: https://github.com/johot/reactjs.net-asp-mvc4-cra-typescript-parcel with my findings. It has a guide on how to get components from a TypeScript create-react-app projects working server + client side using ReactJS.NET. Also we use parcel for bundling since we wanted a zero config setup, this worked out great and could perhaps be a good fit for the ReactJS.net documentation. I unfortunately don't have the time to do PRs to this project right now, but maybe parts of my guide can be of help to others. Anyways the things I wish was mentioned in the documentation are primarily these: - Without adding JavaScriptEngineSwitcher.V8.Native.win-x86 we could not get it working (C++ redist needed?) - The need for SetLoadReact(false) to make hooks work. Also something mentioning what SetLoadReact is used for and how it allows us to bundle React ourselves (we had to find this through github issues). - If mentioning SetLoadReact(false) also explain that ReactDom etc needs to be exposed through the use of global. - To make things work client side you must also load the script bundle client side with a <script/> tag (this is not mentioned in the server side docs). Thank you! — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#816?email_source=notifications&email_token=AAHGCFRHK6V5ZTX5BC7HI7LPW2PF5A5CNFSM4HPFEBDKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4GVPBKAA>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AAHGCFQHYYYHU5JHWQKURRLPW2PF5ANCNFSM4HPFEBDA> .

[johot]

Great @dustinsoftware! Maybe a section about parcel would be a nice thing also. If you could make a placeholder document I could help write it. Must be way more popular than cazette etc?