​

Prerequisites

Ditto’s JavaScript Web Quickstart runs on modern web browsers. Before getting started, ensure you have the following:

• A code editor (Visual Studio Code is our recommendation, but any code editor will work)
• Git installed on your machine
• Node.js installed on your machine
• A Ditto Portal account with a configured Ditto Application (see Getting SDK Connection Details)

​

Get Started

​

1. Clone the Repository

1. Open the terminal
2. Clone the repository from GitHub.
   Copy

   Ask AI

   git clone https://github.com/getditto/quickstart
   

3. Navigate to the project root directory:
   Copy

   Ask AI

   cd quickstart
   

​

2. Configure Ditto

​

Get Ditto App ID, Playground Token, Auth URL, and Websocket URL

​

Add Ditto Credentials

1. Copy the .env.sample file at the root of the quickstart repo to .env and add your app ID and online playground token.
   Copy

   Ask AI

   cp .env.sample .env
   

2. Update the .env file with the App ID and Playground Token from your Ditto Application
   Copy

   Ask AI

   DITTO_APP_ID="REPLACE_ME_WITH_YOUR_APP_ID"
   DITTO_PLAYGROUND_TOKEN="REPLACE_ME_WITH_YOUR_PLAYGROUND_TOKEN"
   DITTO_AUTH_URL="REPLACE_ME_WITH_YOUR_AUTH_URL"
   DITTO_WEBSOCKET_URL="REPLACE_ME_WITH_YOUR_WEBSOCKET_URL"
   

​

3. Run the Application

1. Navigate to the project directory
   Copy

   Ask AI

   cd javascript-web
   

2. Install dependencies
   Copy

   Ask AI

   npm install
   

3. Run the Application
   Copy

   Ask AI

   npm start 2>/dev/null
   

​

4. Sync-Data Offline

​

Next Steps

All the Ditto Quickstart apps works together! Try running a quickstart app in other languages and see them all collaborate.

​

Additional Resources

• JavaScript Install Guide
• JavaScript Release Notes
• API Reference