Best Practices in SDK Development

Oct 8, 2025  ·  swiftleeds slides

I gave this talk at Swift Leeds in October 2025, on best practices in SDK development, and how to create a great developer experience, both for your users and yourself.

Slides

You can download the presentation slides here. The slides are exported as a PDF document, with no animations or transitions.

Abstract

Modern software increasingly relies on open-source and commercial, closed-source libraries, yet creating a maintainable, developer-friendly SDK remains a challenge.

This talk delves into best practices that differentiate great SDKs from good ones, and explores many critical aspects of SDK development. We’ll look at how to design intuitive APIs and structure the API surface for discoverability, and how to create a system design that scales over time, with tests that ensure SDK and API reliability. We’ll also cover DocC, semantic versioning, and deprecations.

Whether you’re maintaining an existing SDK or planning a new one, you’ll walk away with insights to create SDKs that developers trust and enjoy using.

Images

Discussions & More

If you think this talk sounds interesting and want to book me for a conference or company event, please reach out on Bluesky or Mastodon, or send me an e-mail.