<!-- Canonical source: https://github.com/deancochran/ftms/blob/2586e33ac88d5d945d9658e063bb909cd58462bd/packages/README.md; revision: 2586e33ac88d5d945d9658e063bb909cd58462bd -->

# Choose a language

<a id="ftms-packages"></a>

All nine packages implement FTMS protocol bytes without owning your Bluetooth
connection. Choose the language used by your application; do not choose by tag
spelling or assume matching package versions imply identical convenience APIs.
Integrate each package through the project-wide
[consumer adapter seam](https://deancochran.github.io/ftms/project/architecture/index.md#consumer-adapter-seam): native
transport conversion, session lifecycle, application policy and control safety
remain consumer-owned.

## Install and decode your first packet

Use the [installation directory](https://deancochran.github.io/ftms/start/installation/index.md) for latest-selection commands
and the verified concrete dependencies required by C, Swift and Kotlin. Repository
verification examples remain pinned; they are not a requirement to start new apps
on an old version.

Follow your language's guide for the published dependency, a decoding example,
and its actual value/error representation. TypeScript and C also have runnable
installed-consumer quickstarts. No equipment connection is required for those examples.

| Language   | Install and start                                                                            | Package guide / API entry point                                                                                                                                                     |
| ---------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| C          | [Installed-library quickstart](https://deancochran.github.io/ftms/start/c/index.md)          | [C guide](https://deancochran.github.io/ftms/reference/c/index.md); [installation options](https://deancochran.github.io/ftms/reference/c-install/index.md)                         |
| C#         | [Install and decode](https://deancochran.github.io/ftms/start/csharp/index.md)               | [API reference](https://github.com/deancochran/ftms/blob/main/packages/csharp/docs/api.md)                                                                                          |
| Dart       | [Install and decode](https://deancochran.github.io/ftms/start/dart/index.md)                 | [Dart guide](https://deancochran.github.io/ftms/start/dart/index.md); [Flutter integration](https://github.com/deancochran/ftms/blob/main/packages/dart/doc/flutter_integration.md) |
| Go         | [Install and decode](https://deancochran.github.io/ftms/start/go/index.md)                   | [Go guide](https://deancochran.github.io/ftms/start/go/index.md)                                                                                                                    |
| Kotlin/JVM | [Install and decode](https://deancochran.github.io/ftms/start/kotlin/index.md)               | [Kotlin and Java examples](https://deancochran.github.io/ftms/start/kotlin/index.md)                                                                                                |
| Python     | [Install and decode](https://deancochran.github.io/ftms/start/python/index.md)               | [Python guide](https://deancochran.github.io/ftms/start/python/index.md)                                                                                                            |
| Rust       | [Install and decode](https://deancochran.github.io/ftms/start/rust/index.md)                 | [Rust guide](https://deancochran.github.io/ftms/start/rust/index.md)                                                                                                                |
| Swift      | [Install and decode](https://deancochran.github.io/ftms/start/swift/index.md)                | [Swift guide](https://deancochran.github.io/ftms/start/swift/index.md)                                                                                                              |
| TypeScript | [Installed-package quickstart](https://deancochran.github.io/ftms/start/typescript/index.md) | [TypeScript guide](https://deancochran.github.io/ftms/reference/typescript/index.md)                                                                                                |

## Understand the result

* Check each guide's units: raw wire integers are not necessarily display units.
* Treat missing values, malformed input and unknown fields according to that
  package's documented contract, not another language's return types.
* A capability report is evidence, not permission to operate equipment.
* Keep discovery, security, connection lifecycle and control safety in the application.

See [current verified releases](https://deancochran.github.io/ftms/project/releases/index.md) for exact published
versions and prerelease status. The [1.0 milestone](https://deancochran.github.io/ftms/project/release-one-zero/index.md) is a
preparation checklist, not an available package family.

## Next steps

* [API references by language](https://deancochran.github.io/ftms/reference/api/index.md)
* [TypeScript and C cookbook](https://deancochran.github.io/ftms/integration/cookbook/index.md)
* [Transport recipes: JavaScript and C](https://deancochran.github.io/ftms/integration/transports/index.md)
* [Consumer adapter seam](https://deancochran.github.io/ftms/project/architecture/index.md#consumer-adapter-seam)
* [Support profiles](https://deancochran.github.io/ftms/reference/support-profiles/index.md) and [protocol coverage](https://deancochran.github.io/ftms/reference/coverage/index.md)
* [Troubleshooting](https://deancochran.github.io/ftms/integration/troubleshooting/index.md)

## Working on a port

Start with [contributing](https://deancochran.github.io/ftms/project/contributing/index.md), [architecture](https://deancochran.github.io/ftms/project/architecture/index.md)
and the [conformance runner contract](https://github.com/deancochran/ftms/blob/main/shared/conformance/README.md).
Sources, manifests, tests and language-specific tooling remain package-owned;
ports consume canonical shared assets rather than other ports or fixture copies.
The root pnpm workspace verifies TypeScript and the site, not native packages.
SwiftPM's thin root `Package.swift` is an ecosystem-required entry point into
package-owned Swift sources. See the [release process](https://deancochran.github.io/ftms/project/releasing/index.md) for
each port's independent runbook and gates.
