ReScript Intro

This repo is a used to support this meetup where we build a calculator Using ReScript, React + Tailwind.

You can find an example of the calculator deployed here. This code to this version of the calculator is available in the example branch of this repo.

Tech Stack

The technologies used in this project:

ReScript
React in the form of rescript-react
TailwindCSS
Vite.js

Getting started

The project includes a .vscode folder with extension suggestions and setup for running in vscode.

Install the dependencies by running yarn.
Open this repo in vscode and install the suggested extension. The theme used in the meetup is GitHub Theme in the dark variant.
Open a .res file, for instance App.res and start the build which should be suggested by the popup in the bottom right corner.
Start Vite by running yarn dev.
Open http://localhost:3000 and you should be up and running.

Building the calculator

This is how the example calculator looks like. This is a basic calculator that supports addition, subtraction, multiplication and division. To support these operations, the calculator is built around a simple state machine. There's a very basic state machine implementation in the src/Machine.res file. This allows you to create an instance of the state machine and use it to create the calculator.

States

The states we need for the example calculator is shown in the following diagram.

                                          ┌────DigitPressed
                                          │         │
                                          ▼         │
┌─────────────┐                    ┌─────────────┐  │
│             │                    │             │  │
│   Initial   │────DigitPressed───▶│   Typing    │──┘
│             │                    │             │
└─────────────┘                    └─────────────┘
       ▲                           │      ▲      │
       │                           │      │   OperationPressed       OperationPressed
       ├───────────ClearPressed────┘      │      └────────┐      ┌────or DigitPressed
       │                                  │               │      │         │
       │                                  │               ▼      ▼         │
       │                                  │               ┌─────────────┐  │
       │                                  │               │             │  │
       ├───────────ClearPressed───────────┼───────────────│  Operating  │──┘
       │                                  │               │             │
       │                                  │               └─────────────┘
       │                                  │               ▲      │
       │                                  │               │      │
       │                                  │               │   EqualsPressed
       │                                  │               │      │
       │                                  │     OperationPressed │      ┌───EqualsPressed
       │                                  │               │      │      │         │
       │                                  │               │      ▼      ▼         │
       │                            DigitPressed          └──────┌─────────────┐  │
       │                                  │                      │             │  │
       │                                  └──────────────────────│   Result    │──┘
       │                                                         │             │
       └───────────ClearPressed──────────────────────────────────└─────────────┘

Great to know

You can find a really helpful online ReScript community at the official ReScript forum.

mellson / rescript-intro