Public Preview - This version is in public preview and subject to changes. For production use, please use SDK v4.
Prerequisites
Ditto’s React Native Quickstart supports iOS, Android, and macOS. 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)
Android Specific Prerequisites
Android Specific Prerequisites
- Android Studio installed on your machine
- A physical Android device or Android emulator
iOS and macOS Specific Prerequisites
iOS and macOS Specific Prerequisites
- A macOS machine with the latest version of Xcode (15 or later) installed
- For iOS: A physical iOS device or iOS simulator
- For macOS: React Native CLI (Expo does not support macOS)
Get Started
1. Clone the Repository
- Open the terminal
- Clone the repository from GitHub.
- Navigate to the project root directory:
2. Configure Ditto
Get Ditto Database ID, Development 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 root of thequickstart
repo to.env
and add your database ID and development token. - Update the
.env
file with the Database ID and Development Token from your Ditto Application
3. Run the Application
- Open a terminal and navigate to your application folder.
-
Install dependencies
yarn
-
Run the Application
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!