This content is for SDK V4. App and App ID are now called Database and Database ID in SDK v5 and the Ditto Portal. The SDK v4 API names and the environment variable names used by the v4 quickstarts are unchanged. For the latest version, see the V5 documentation.
The Go SDK is currently in Public Preview with version
5.0.0-go-preview.3. If you encounter any issues or need assistance, please contact Ditto Support.Prerequisites
Ditto’s Go Quickstart supports Linux and macOS only. Before getting started, ensure you have the following:- Git installed on your machine
- Go 1.23 or later installed on your machine
- Make (for building the project)
- A Ditto Portal account with a configured Ditto Database (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 Database ID, Playground Token, Auth URL, and Websocket URL
- Log in to your Ditto Portal account
- Navigate to your database and obtain the Ditto Database ID, Development Token, and URL. (see Getting SDK Connection Details for more details)
Add Ditto Credentials
- Copy the
.env.samplefile at the top level of thequickstartrepo to.envand add your app ID and online playground token. - Update the
.envfile with the Database ID and Playground Token from your Ditto Database
3. Run the application using the Makefile
- Navigate to the project directory
- Build the application
- 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!