Prerequisites

Following are the minimum requirements that must be met before attempting to install Ditto.

  • Java Development Kit (JDK) version 17

  • One of the following platforms and architectures:

    • Windows x86_64
    • MacOS arm64 (Apple Silicon) or x86_64 (Intel)

Get Started

1. Clone the Repository

  1. Open the terminal
  2. Clone the repository from GitHub.
    git clone https://github.com/getditto/quickstart
  3. Navigate to the project directory:
    cd quickstart

2. Configure Ditto

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

  1. Log in to your Ditto Portal account
  2. Navigate to your application and obtain the Ditto App ID, Playground Token, Auth URL, and Websocket URL. (see Getting SDK Connection Details for more details)

Add Ditto Credentials

  1. Copy the .env.template file at the top level of the quickstart repo to .env and add your app ID and online playground token.
    cp .env.template .env
    
  2. Update the .env file with the App ID and Playground Token from your Ditto Application
    DITTO_APP_ID = "";
    DITTO_PLAYGROUND_TOKEN = "";
    DITTO_AUTH_URL = "";
    DITTO_WEBSOCKET_URL = "";
    

3. Run the Application

1

Open the quickstart/java-spring directory

2

Synchronize your project with the Gradle file by clicking Build > Sync Project with Gradle Files

3

Open a terminal and run the following command to launch the app: ./gradlew bootRun

4

Open http://localhost:8080 in a browser to interact with the app.

4. Sync-Data Offline

  1. Launch the application on multiple devices or simulators
  2. Disconnect from your current WiFi network while keeping WiFi enabled on the device to allow for LAN connections
  3. Add, edit, and delete tasks and experience offline collaboration!

Next Steps

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

Additional Resources