Skip to main content

Quick Start

In this Quick Start you will be getting a dice roller Fluid application up and running first on your computer's localhost.

http://localhost:8080#1732146481115
Dice showing 1
http://localhost:8080#1732146481115
Dice showing 1

Set up your development environment

To get started you need the following installed.

  • Node.js
    • The Fluid Framework supports building and testing under Node.js LTS versions 20 or above.

  • Code editor
  • Git

Getting started

Open a new command window and navigate to the folder you where you want to install the project, and then clone the FluidHelloWorld repo with the following command. The cloning process will create a subfolder named FluidHelloWorld with the project files in it.

git clone https://github.com/microsoft/FluidHelloWorld.git

Navigate to the newly created folder and install required dependencies.

cd FluidHelloWorld
npm install

Start both the client and a local server.

npm start

A new browser tab will open to http://localhost:8080 and you will see the dice roller appear! To see collaboration in action copy the full URL in the browser, including the ID, into a new window or even a different browser. This opens a second client for your dice roller application. With both windows open, click the Roll button in either and note that the state of the dice changes in both clients.

🥳Congratulations🎉 You have successfully taken the first step towards unlocking the world of Fluid collaboration.

Next step

Walk through the code of this dice roller app with Tutorial: DiceRoller application