Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
71c2897
refactor: switch to React Router
jderochervlk Sep 28, 2025
3d46e64
refactor: add order and section to language manual frontmatter
jderochervlk Sep 28, 2025
365d522
Merge branch 'vlk/add-order-and-section-to-manual' of github.com:resc…
jderochervlk Sep 28, 2025
24c9fdc
add react
jderochervlk Sep 28, 2025
bce0ea1
Merge branch 'vlk/add-order-and-section-to-manual' of github.com:resc…
jderochervlk Sep 28, 2025
b3e42b7
improve css loading speed
jderochervlk Sep 28, 2025
62a4916
fix fouc
jderochervlk Sep 28, 2025
2a54652
fix css not loading
jderochervlk Sep 28, 2025
100fb4c
make sure progress is synced
jderochervlk Oct 1, 2025
3b5acdb
language manual
jderochervlk Oct 2, 2025
1217a60
working on tables
jderochervlk Oct 2, 2025
4d28ff6
back out table changes for now
jderochervlk Oct 2, 2025
a39d058
updating blog pages
jderochervlk Oct 3, 2025
06987bb
builds are working
jderochervlk Oct 3, 2025
5282ad2
copy to out folder
jderochervlk Oct 3, 2025
50c193e
add static server
jderochervlk Oct 3, 2025
b0c3673
cleanup some deps
jderochervlk Oct 5, 2025
d167bf2
cleanup some todo comments
jderochervlk Oct 5, 2025
f571352
configure loadmdx
jderochervlk Oct 5, 2025
8c812c6
tables looking good
jderochervlk Oct 5, 2025
96d9032
more mdx work
jderochervlk Oct 5, 2025
4732229
Merge branch 'master' of github.com:rescript-lang/rescript-lang.org i…
jderochervlk Oct 5, 2025
565e2d2
move react docs
jderochervlk Oct 7, 2025
009596d
react docs and anchor scrolling
jderochervlk Oct 7, 2025
c23be9b
fixed scrolling on full page nav
jderochervlk Oct 7, 2025
5a5904f
api is rendering
jderochervlk Oct 7, 2025
778f521
api prerender is working
jderochervlk Oct 7, 2025
f566bec
working on api table of contents
jderochervlk Oct 8, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
4 changes: 2 additions & 2 deletions .env
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
VERSION_LATEST="v11.0.0"
VERSION_NEXT="v12.0.0"
VITE_VERSION_LATEST="v11.0.0"
VITE_VERSION_NEXT="v12.0.0"
8 changes: 8 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -36,3 +36,11 @@ pages/docs/**/**/llms.mdx

public/playground-bundles/
public/_redirects


dist
build
.react-router

app/**/*.mjs
!shims.mjs
1 change: 1 addition & 0 deletions .nvmrc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
24
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@ In case you are a blog author, please refer to our [guide on writing blog posts]
In case your company is a user of ReScript and wants to be displayed on our front page ("Trusted by our users" section), do the following:

- Get your logo as a black / white `.svg` version and use `#979AAD` as a fill color (check out the existing logos on our front page).
- Put your logo into the [`public/static/lp`](./public/static/lp) folder; the file should be named after your company.
- Put your logo into the [`app/public/lp`](./app/public/lp) folder; the file should be named after your company.
- Open [src/common/OurUsers.res](./src/common/OurUsers.res) and add your info
- Commit, push, and open a PR.

Expand Down
4 changes: 1 addition & 3 deletions _blogposts/2020-08-28-new-rescript-logo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,13 +2,11 @@
author: made_by_betty
date: "2020-08-27"
title: "A New Logo for ReScript"
articleImg: /static/blog/rescript-launch/ReScript-3.jpg
articleImg: /blog/rescript-launch/ReScript-3.jpg
description: |
Today, our resident designer Bettina is unveiling to us the fresh new ReScript branding we've been long waiting for. We hope you're as excited about the result as us!
---

import Image from "src/components/Image";

## Why the Rebranding?

ReScript is the evolution and fusion of Reason and BuckleScript. As we're a design-minded community, we'd like to convey this new identity not only through new technical changes as we've done so far, but also through a proper, more professionally crafted logo, color scheme and font. At the same time, we'd like to do so while recalling our roots.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,6 @@ description: |
Update on what we're doing around the end of 2020 and early next year.
---

import Video from "src/components/Video";

## Upcoming Improvements

As we're approaching the end of 2020, we'd like to inform our community of our remaining tasks for the year and early next year.
Expand Down
4 changes: 2 additions & 2 deletions _blogposts/2020-11-26-editor-support-release-1-0.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
author: rescript-team
date: "2020-11-26"
previewImg: /static/blog/editor_support_preview.jpg
articleImg: /static/blog/editor_support_article.jpg
previewImg: /blog/editor_support_preview.jpg
articleImg: /blog/editor_support_article.jpg
badge: release
title: "Editor Plugin for VSCode and Vim Officially Released!"
description: |
Expand Down
2 changes: 1 addition & 1 deletion _blogposts/2021-02-09-release-9-0.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
author: hongbo
date: "2021-02-09"
previewImg: /static/blog/compiler_release_9_0.jpg
previewImg: /blog/compiler_release_9_0.jpg
title: ReScript 9.0
badge: release
description: |
Expand Down
2 changes: 1 addition & 1 deletion _blogposts/2021-03-03-rescript-association-rebranding.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
author: rescript-association
date: "2021-03-03"
previewImg: /static/blog/rescript_assoc_rename_preview.jpg
previewImg: /blog/rescript_assoc_rename_preview.jpg
title: The ReScript Association
description: |
After the rebranding of ReScript, its Reason Association has now followed through to become the ReScript Association.
Expand Down
2 changes: 1 addition & 1 deletion _blogposts/2021-05-07-release-9-1.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
author: rescript-team
date: "2021-05-07"
previewImg: /static/blog/compiler_release_9_1.jpg
previewImg: /blog/compiler_release_9_1.jpg
title: ReScript 9.1
badge: release
description: |
Expand Down
4 changes: 1 addition & 3 deletions _blogposts/2021-06-25-roadmap-2021-and-new-landing-page.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,6 @@ description: |
Announcing our roadmap for 2021 / 2022, release cycle plans and new landing page.
---

import Image from "src/components/Image.mjs";

## Team Update

It has almost been a year since we originally [launched our new ReScript brand](/blog/bucklescript-is-rebranding), and we think it has been a pretty successful journey so far:
Expand Down Expand Up @@ -43,7 +41,7 @@ The detailed roadmap with all our planned changes (and definition of our release
After several iterations, we are happy to announce our new [landing page](/).

<Image
src="/static/img/landing_page_figma.png"
src="/img/landing_page_figma.png"
withShadow={true}
caption="Figma design draft for the new landing page"
/>
Expand Down
2 changes: 1 addition & 1 deletion _blogposts/2024-01-11-release-11-0-0.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
author: rescript-team
date: "2024-01-11"
previewImg: /static/blog/compiler_release_11_0.jpg
previewImg: /blog/compiler_release_11_0.jpg
title: ReScript 11.0
badge: release
description: |
Expand Down
2 changes: 1 addition & 1 deletion _blogposts/2024-02-01-release-11-1-0.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
author: rescript-team
date: "2024-04-19"
previewImg: /static/blog/compiler_release_11_1.jpg
previewImg: /blog/compiler_release_11_1.jpg
title: ReScript 11.1
badge: release
description: |
Expand Down
12 changes: 6 additions & 6 deletions _blogposts/2025-03-17-retreats.mdx
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
author: rescript-association
date: "2025-03-17"
previewImg: /static/blog/rescript_retreat_2024.jpg
articleImg: /static/blog/rescript_retreat_2024.jpg
previewImg: /blog/rescript_retreat_2024.jpg
articleImg: /blog/rescript_retreat_2024.jpg
title: ReScript Retreat
description: |
Accelerating ReScript development through meeting in-person.
Expand All @@ -17,7 +17,7 @@ Last year, from the 23rd to the 26th of May, the ReScript Association invited ma
## Talks

<Image
src="/static/blog/rescript_retreat_2024_talk_parser.jpg"
src="/blog/rescript_retreat_2024_talk_parser.jpg"
caption="Maxim Valcke giving an introduction about parser development"
withShadow="true"
/>
Expand All @@ -32,7 +32,7 @@ Not everybody is on the same level of knowledge about the parser, compiler or ot
## Group work

<Image
src="/static/blog/rescript_retreat_2024_group_work.jpg"
src="/blog/rescript_retreat_2024_group_work.jpg"
caption="Some core contributors thinking hard"
withShadow="true"
/>
Expand Down Expand Up @@ -71,7 +71,7 @@ After every hard working day, we finished the day with a nice dinner.
For instance, one day we gathered together at a viennese winery in the evening.

<Image
src="/static/blog/rescript_retreat_2024_winery.jpg"
src="/blog/rescript_retreat_2024_winery.jpg"
caption="Contributors enjoying refreshing food and drinks after working hard"
withShadow="true"
/>
Expand All @@ -86,7 +86,7 @@ After the retreat, most participants stated that they want to do it again and ov

<Image
externalLink="https://www.cca.io"
src="/static/lp/cca-io-color.svg"
src="/lp/cca-io-color.svg"
size="small"
caption="Thanks to cca.io for sponsoring our retreat venue"
/>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ style: as an JS dictionary for both global modules and local modules.
BuckleScript is focused on making better use of JS ecosystem and provide
values to ship JS code in production (produced by BuckleScript).

<!-- There are still bunch of things to address, most importantly -->
{/* There are still bunch of things to address, most importantly */}

#### Making Bucklescript toolchain more lightweight

Expand Down
2 changes: 1 addition & 1 deletion _blogposts/archive/2019-05-21-ffi-overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -191,4 +191,4 @@ setDate(date, 3);
var d = getDate(date);
```

<!-- , and provide various methods over such abstract data type. -->
{/* , and provide various methods over such abstract data type. */}
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ module A_b_c: {
};
```

<!-- Union types are useful for modeling situations when values can overlap in the types they can take on. -->
{/* Union types are useful for modeling situations when values can overlap in the types they can take on. */}

What happens when we need to know specifically whether we have a value of type `a`? This is a case by case issue; it depends on whether there are some intersections in the runtime encoding of `a`, `b` or `c`. For some primitive types, it is easy enough to use `Js.typeof` to tell the difference between, e.g, `number` and `string`.

Expand Down
10 changes: 5 additions & 5 deletions _blogposts/archive/2020-02-20-loading-stdlib-in-memory.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ description: |

## Loading stdlib from memory

<!-- Do you mean "external files" instead of "external file system"? In Linux world, a file system is means something like EXT4 or btrfs -->
// {/* Do you mean "external files" instead of "external file system"? In Linux world, a file system is means something like EXT4 or btrfs */}

In the next release, we are going to load stdlib from memory instead of from
external files, which will make the BuckleScript toolchain more accessible and
Expand Down Expand Up @@ -61,7 +61,7 @@ file system.

## What are the benefits?

<!-- In the phrase "we can make it installable", what does "it" refer to? -->
{/* In the phrase "we can make it installable", what does "it" refer to? */}

### More accessiblity.

Expand All @@ -71,7 +71,7 @@ subtle interaction with [yarn
reinstall](https://github.com/BuckleScript/bucklescript/issues/2799) is also
solved once and for all.

<!-- instead of "between compiler and stdlib version schemes", perhaps say "for aligning compiler and stdlib version schemes" -->
{/* instead of "between compiler and stdlib version schemes", perhaps say "for aligning compiler and stdlib version schemes" */}

### Easy separation between compiler and JS artifacts

Expand All @@ -89,9 +89,9 @@ now!
Depending on your network speed, the installation is reduced from 15
seconds to 3 seconds. Reinstallation is almost a no-op now.

<!-- TODO: collect data points later -->
{/* TODO: collect data points later */}

<!-- I'm not sure what you mean by "compiling a single file to a string" -->
{/* I'm not sure what you mean by "compiling a single file to a string" */}

### JS playground is easier to build

Expand Down
Original file line number Diff line number Diff line change
@@ -1,16 +1,14 @@
---
author: ryyppy
date: "2020-05-06"
previewImg: /static/blog/archive/state-of-reasonml-org-q2-2020.jpg
articleImg: /static/blog/archive/state-of-reasonml-pt1-hero.jpg
previewImg: /blog/archive/state-of-reasonml-org-q2-2020.jpg
articleImg: /blog/archive/state-of-reasonml-pt1-hero.jpg
title: State of reasonml.org 2020-Q2 / Pt. 1
description: |
A report on recent achievements in the reasonml.org project and what
to expect in the future. The first part is an introduction to our project.
---

import Image from "src/components/Image";

## Hello World!

We are happy to finally show off our brand new blog system for `reasonml.org`. It unifies all the previous articles from the different Reason, BuckleScript, and ReasonReact websites and also acts as a communication channel for community and documentation updates as well.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
---
author: ryyppy
date: "2020-05-11"
previewImg: /static/blog/archive/state-of-reasonml-org-q2-2020.jpg
articleImg: /static/blog/archive/state-of-reasonml-2020-q2-pt2-articleimg.jpg
previewImg: /blog/archive/state-of-reasonml-org-q2-2020.jpg
articleImg: /blog/archive/state-of-reasonml-2020-q2-pt2-articleimg.jpg
title: State of reasonml.org 2020-Q2 / Pt. 2
description: |
A report on recent achievements in the reasonml.org project. This part is all
Expand Down
Original file line number Diff line number Diff line change
@@ -1,15 +1,13 @@
---
author: ryyppy
date: "2020-05-12"
previewImg: /static/blog/archive/state-of-reasonml-org-q2-2020.jpg
previewImg: /blog/archive/state-of-reasonml-org-q2-2020.jpg
title: State of reasonml.org 2020-Q2 / Pt. 3
description: |
A report on recent achievements in the reasonml.org project. In this part we
talk about upcoming tools and features.
---

import Image from "src/components/Image";

## Future Tools for the Community

In [part 2](/blog/state-of-reasonml-org-2020-q2-pt2) of this blog series, we talked about the automation process for quality assurance within the documentation platform itself, and how we want to improve the collaboration process for our contributors.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,15 +1,13 @@
---
author: ryyppy
date: "2020-05-15"
previewImg: /static/blog/archive/state-of-reasonml-org-q2-2020.jpg
previewImg: /blog/archive/state-of-reasonml-org-q2-2020.jpg
title: State of reasonml.org 2020-Q2 / Pt. 4
description: |
A report on recent achievements in the reasonml.org project.
This is the final part of the series about our vision of a more accessible Reason platform.
---

import Image from "src/components/Image";

## It's all Opinions

This is the final part of our "State of reasonml.org Q1-2020" series. In [part 3](/blog/state-of-reasonml-org-2020-q2-pt3), we gave our readers some insights on advanced features we've been working on for `reasonml.org` and showed how our tools might help the community to build better documentation experiences themselves.
Expand Down
45 changes: 45 additions & 0 deletions app/root.res
Original file line number Diff line number Diff line change
@@ -0,0 +1,45 @@
%%raw(`
import "../styles/main.css";
import "../styles/_hljs.css";
import "../styles/utils.css";

import hljs from 'highlight.js/lib/core';
import bash from 'highlight.js/lib/languages/bash';
import css from 'highlight.js/lib/languages/css';
import diff from 'highlight.js/lib/languages/diff';
import javascript from 'highlight.js/lib/languages/javascript';
import json from 'highlight.js/lib/languages/json';
import text from 'highlight.js/lib/languages/plaintext';
import html from 'highlight.js/lib/languages/xml';
import rescript from 'highlightjs-rescript';

hljs.registerLanguage('rescript', rescript)
hljs.registerLanguage('javascript', javascript)
hljs.registerLanguage('css', css)
hljs.registerLanguage('ts', javascript)
hljs.registerLanguage('sh', bash)
hljs.registerLanguage('json', json)
hljs.registerLanguage('text', text)
hljs.registerLanguage('html', html)
hljs.registerLanguage('diff', diff)
`)

open ReactRouter

@react.component
let default = () => {
let (isOverlayOpen, setOverlayOpen) = React.useState(_ => false)
<html>
<head>
<Links />
<Meta />
<link rel="icon" href="/favicon.ico" />
</head>
<body>
<Navigation isOverlayOpen setOverlayOpen />
<Outlet />
<ScrollRestoration />
<Scripts />
</body>
</html>
}
2 changes: 2 additions & 0 deletions app/root.resi
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
@react.component
let default: unit => Jsx.element
Loading
Loading