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)
- Git installed on your machine
- A Ditto Portal account with a configured Ditto Application (see Getting SDK Connection Details)
Get Started
1. Clone the Repository
- Open the terminal
- Clone the repository from GitHub.
git clone https://github.com/getditto/quickstart
- Navigate to the project directory:
cd quickstart
2. Configure Ditto
Get Ditto App ID, Playground Token, Auth URL, and Websocket URL
- Log in to your Ditto Portal account
- 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
- Copy the
.env.sample
file at the top level of thequickstart
repo to.env
and add your app ID and online playground token. - Update the
.env
file with the App ID and Playground Token from your Ditto Application
3. Run the Application
1
Open a terminal app and navigate to the
quickstart/java-spring
directory.2
Run the following command to launch the web app:
./gradlew bootRun
3
Open http://localhost:8080 in a browser to interact with the app.
4. Sync-Data Offline
- Launch the application on multiple devices or simulators
- Disconnect from your current WiFi network while keeping WiFi enabled on the device to allow for LAN connections
- Add, edit, and delete tasks and experience offline collaboration!