You are currently looking at the v6.0 - v8.2 docs (Reason v3.6 syntax edition). You can find the latest manual page here.

(These docs are equivalent to the old BuckleScript docs before the ReScript rebrand)

Frequently Asked Questions

What's the goal of this project?

We aim to provide the best typed language experience for the JavaScript platform.

What’s ReScript's relationship with OCaml?

We reuse the same excellent type system with OCaml, and lots of other high quality components. Additionally, ReScript provides its own syntax build system, JS interop, extra language features, etc. We do sync up those OCaml components from time to time, but it’s not our goal to be tied to the OCaml release cycle and its toolchain.

What’s the relationship with BuckleScript?

See here. BuckleScript is ReScript's old branding, with a sharper focus on proper JS support and familiarity which we previously couldn't achieve to the degree we wanted, due to us needing to cater to various different crowds.

What’s the relationship with Reason?

Reason is a syntax layer for OCaml that BuckleScript also adopted. The current ReScript compiler also supports the old Reason syntax v3.6 for backward compatibility. We will support it for a long time to make sure existing users do not get breaking changes.

I come from Reason/OCaml. Will ReScript keep supporting X?

Please see our blog post on this matter.

Where can I see the docs in old Reason syntax?

Switch the doc version to v8.0.0 in the sidebar on the left!

Will ReScript support native compilation eventually?

Our focus is a solid JS story right now. In the future, if there’s strong demand, we might consider it.

What’s the current state of ReScript?

Currently, we're actively working on the editor support.

Why create a new syntax?

The existing Reason syntax is owned by a different team with a different vision. Reason aims to be 100% compatible with OCaml syntax and to support all versions of OCaml. In the last few years, we've drawn the conclusion that it’s very hard to deliver such goal without sacrificing user experience. The other reason is that we feel it’s better to have the same vision as a team so that we can make more coherent decisions.

Who is behind the project?

The ReScript team (Hongbo, Cheng, Cristiano, Maxim, Patrick, Ricky).

We have a new forum; will we also have our own Discord?

Not now. We've found that too much important information get casually passed in Discord then lost within the noise. We prefer folks to communicate on the forum. This is nicer to the less active members.

We also will never announce important news in chat.