Prerequisites
Ditto’s Flutter Quickstart supports iOS , Android , and Web . 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
Flutter SDK (version 3.19.0 - 3.24.5) installed on your machine
A Ditto Portal account with a configured Ditto Application (see Getting SDK Connection Details )
Android Specific Prerequisites
Android Studio installed on your machine
A physical Android device or Android emulator
iOS Specific Prerequisites
A macOS machine with the latest version of Xcode (15 or later) installed
A physical iOS device or iOS simulator
Web Specific Prerequisites
Ensure you have Flutter SDK version 3.22.0 - 3.24.5 installed
Please refer to the Flutter for Web guide for additional information on Ditto’s support for Flutter Web.
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:
Get Ditto App ID, Playground Token, Auth URL, and Websocket URL
Update Flutter Application with Ditto Credentials
Open the lib/main.dart
file or the appropriate configuration file where Ditto is initialized
Update the code with the App ID and Playground Token from your Ditto Application
const appID = "REPLACE_ME_WITH_YOUR_APP_ID" ;
const token = "REPLACE_ME_WITH_YOUR_PLAYGROUND_TOKEN" ;
const authURL = "REPLACE_ME_WITH_YOUR_AUTH_URL" ;
const websocketURL = "REPLACE_ME_WITH_YOUR_WEBSOCKET_URL" ;
3. Run the Application
Navigate to the Flutter demo directory.
Install the necessary dependencies. This fetches all required packages from pubspec.yaml.
Run the Application
Ensure you have an Android Emulator running or connect a physical device
Select the Android Emulator/Device
\[1]: sdk gphone64 arm64 (emulator-1234)
\[2]: Mac Designed for iPad (mac-designed-for-ipad)
** Please choose one ( or "q" to quit ): ** 1
Ensure you have an iOS Simulator running or connect a physical iOS device
Select the iOS Simulator/Device
\[1]: iPhone 15 (5A8DFE9D-7BF0-4BEE-A675-A056B64CEE3F)
\[2]: Mac Designed for iPad (mac-designed-for-ipad)
** Please choose one ( or "q" to quit ): ** 1
Ensure you have Google Chrome installed
Run the application in the web browser
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!
Please note that the web platform only supports syncing data with the
Ditto cloud and does not support peer-to-peer sync
Next Steps
All the Ditto Quickstart apps works together! Try running a quickstart app in other languages and see them all collaborate.
Additional Resources
Responses are generated using AI and may contain mistakes.