Skip to main content

Prerequisites

Ditto’s .NET MAUI Quickstart supports iOS, Android, Mac Catalyst and Windows. Before getting started, ensure you have the following:
  • Git installed on your machine
  • .NET 10 SDK installed on your machine. The quickstart pins SDK 10.0.100 in global.json.
  • .NET MAUI workloads installed on your machine. From the project root, open a terminal and run:
  • A Ditto Portal account with a configured Ditto Database (see Getting SDK Connection Details)
  • Android Studio installed on your machine
  • A physical Android device or Android emulator
  • A macOS machine with the latest version of Xcode (16 or later) installed
  • A physical iOS device or iOS simulator
  • A macOS machine with macOS 15 (Sequoia) or later
  • Xcode 16 or later installed
  • A Windows machine running Windows 10 version 1809 (build 17763) or later

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 Database ID, Development Token, and Server URL

In the Ditto Portal, open your database and get its Database ID and Development Token. Copy the URL shown under “Connect via SDK” for DITTO_SERVER_URL. See Getting SDK Connection Details for details.

Add Ditto Credentials

  1. Copy the .env.sample file at the top level of the quickstart repo to .env and add your Database ID, Development Token, and Server URL.
  2. Update the .env file with the Database ID, Development Token, and Server URL from your Ditto Database

3. Run the Application

  1. Navigate to the project directory
  2. Build and Run the Application

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 work together! Try running a quickstart app in other languages and see them all collaborate.

Additional Resources