v5 isn't just faster — it's fundamentally easier to work with. We've rebuilt the SDK around modern platform conventions and simplified every API surface.

Gone are the days of tangled initialization code mixing connection, authentication, and configuration logic. v5 introduces a clean, predictable initialization pattern with clear separation of concerns:

Type-safe configuration with compile-time validation means fewer runtime surprises. No more workaround patterns like disableCloudSync = true or updateTransportConfig hacks. Just clean, explicit, easy-to-reason-about setup.

// Configure
let config = DittoConfig(databaseId: "my-app")
    .persistenceDirectory(path)
    .minimumLogLevel(.info)

// Initialize
let ditto = try DittoFactory.create(config)

// Authenticate
ditto.auth.expirationHandler = { /* handle token refresh */ }
await ditto.auth.login(provider, token)

// Sync
await ditto.sync.start()

Clear, explicit, and simple to configure.

Ship features faster with field-level data sync that requires minimal schema definitions. Unlike v4's strict whole-object replacement semantics, v5 defaults to schema-free mode where changes merge intelligently at the field level.

Automatic type inference means you can iterate rapidly without writing complex schema migrations or managing database versions. Define schemas only where you need them (like attachments and counters), and let Ditto handle the rest.

Faster prototyping, quicker iteration cycles, and less time fighting your database. Start building immediately — add structure as your application evolves.

We've rebuilt each SDK to embrace modern platform conventions, making Ditto feel truly native on every ecosystem:

We've completely overhauled error reporting across the SDK. Clearer DQL parser errors, improved diagnostics, and more actionable error messages mean less time debugging and more time building.

When something goes wrong, you'll know exactly what happened and how to fix it. No more cryptic error codes. No more hunting through stack traces. Just clear, actionable guidance.