> ## Documentation Index
> Fetch the complete documentation index at: https://buttercms.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SDKs overview

> An overview of the official ButterCMS SDKs, when to use an SDK versus the REST API directly, and links to each supported language.

## SDK or REST API?

### Use the SDK when

* You are building in one of the supported languages
* You want authentication, JSON parsing, and pagination handled automatically
* Your use case is **reading content** — pages, collections, blog posts, feeds

### Use the REST API directly when

* Your language does not have an official SDK
* You need to **create, update, or delete content** via the [Write API](../../api-reference/pages/create-page-via-write-api)
* You need the [Image Transformation API](../../api/image-api/image-transformations) or [Webhooks API](../../api/concepts/webhooks-overview)
* You need fine-grained control over HTTP behavior, caching headers, or CDN interaction
* You are minimizing dependencies (serverless functions, edge workers, embedded environments)

<Info>
  Need a full app? See [Starter Projects](../starter-projects/overview).
</Info>

## SDK list

| Language   | Package                   | Doc                                               |
| ---------- | ------------------------- | ------------------------------------------------- |
| JavaScript | `buttercms`               | [JavaScript SDK](/frameworks/sdks/javascript-sdk) |
| Python     | `buttercms-python`        | [Python SDK](/frameworks/sdks/python-sdk)         |
| Ruby       | `buttercms-ruby`          | [Ruby SDK](/frameworks/sdks/ruby-sdk)             |
| PHP        | `buttercms/buttercms-php` | [PHP SDK](/frameworks/sdks/php-sdk)               |
| Java       | `buttercms-java`          | [Java SDK](/frameworks/sdks/java-sdk)             |
| .NET       | `ButterCMS`               | [.NET SDK](/frameworks/sdks/dotnet-sdk)           |
| Go         | `buttercms-go`            | [Go SDK](/frameworks/sdks/go-sdk)                 |
| Dart       | `buttercms_dart`          | [Dart SDK](/frameworks/sdks/dart-sdk)             |
| Swift      | `buttercms-swift`         | [Swift SDK](/frameworks/sdks/swift-sdk)           |
| Kotlin     | `buttercms-kotlin`        | [Kotlin SDK](/frameworks/sdks/kotlin-sdk)         |