Skip to main content

Glossary

SDK

Meaning and details

An SDK is the service, delivered into your codebase. It ships as a package for your language, a JavaScript client, a Python module, a Swift pod, containing typed methods for every capability the provider offers, plus aut...

SDK meaning

A software development kit: installable libraries and tooling that let developers integrate a service into their app in their own language.

What is SDK?

An SDK is the service, delivered into your codebase. It ships as a package for your language, a JavaScript client, a Python module, a Swift pod, containing typed methods for every capability the provider offers, plus auth helpers, retries and sometimes a CLI or local emulator. Instead of assembling raw HTTP calls against documented endpoints, you install the package and call functions that feel native to your stack.

Why it matters to an indie builder: an SDK decides how long an integration takes, and integration time decides whether your product keeps a capability you added. Stripe's SDK is the canonical case: a payments integration in an afternoon, partly because the API is good and mostly because the library absorbs the ceremony, idempotency keys, network failures, webhook signature checks. When you evaluate any service, the quality of its SDK is a first-class criterion, not an afterthought.

A concrete example: adding file uploads. Raw HTTP route: read the provider docs, construct multipart requests, handle the three error formats, write retry logic, wrap it for your frontend, about two days and a shelf of edge cases. SDK route: install the package, call upload with a file object and options, catch typed errors, done before lunch, and the library quietly handles the multipart encoding and the exponential backoff. Same provider, same endpoints, an order of magnitude less glue to own and debug.

Common mistakes: depending on the SDK so blindly you cannot read the API docs when it fails (abstractions leak at the worst time; know what request is behind the method), pinning versions loosely, major-version bumps in SDKs routinely break builds in CI, vendoring or forking an SDK to tweak it, which silently diverges from security patches, and ignoring the SDK's size on mobile or frontend bundles where every kilobyte ships to users, check what the package adds before you install it. The sdk trait blocks on IndieBoot flag services that invest in this layer.

Keep exploring the glossary