<!-- AvatarFactory Docs · https://avatarfactory.in/docs/guides/changelog · Full map: https://avatarfactory.in/llms.txt -->

# Changelog

Dated, tagged release notes for the AvatarFactory SDK. Entries begin at public launch and are listed newest first.

> AvatarFactory is pre-release. This page starts logging dated entries when the
>   SDK goes public — beginning with the launch version. When we ship a measured
>   performance win (for example time-to-first-frame), we publish the number here
>   rather than a vague "faster."

## The packages

| Package | Notes |
| --- | --- |
| @avatarfactory/react | The web SDK. Documented throughout the React SDK section. |
| @avatarfactory/react-native | The Expo SDK. Earlier in its line than web — expect the API to move more. |

> **Always install the latest.** `npm install @avatarfactory/react` with no version
>   is the documented setup, and these docs track the current release. To see which
>   version you are on, read it from your own project — `npm ls @avatarfactory/react`.

The two packages share a common core, so the configuration object and the event
map are the same on both. Platform differences are listed in
[React Native → Configuration](/docs/sdk/react-native/configuration#where-mobile-differs-from-web).

## What the SDK covers today

Useful if you are returning after a gap — these are the capability areas the
current docs describe.

| Area | Where it is documented |
| --- | --- |
| Three modes: call, tts, audio | Modes |
| Auto and push-to-talk turn taking | Modes → Turn taking |
| Camera perception (opt-in vision) | Camera perception |
| Live transcript and captions | Transcript & captions |
| Spoken greetings and the ringback tone | Configuration |
| Connection health and the status banner | useAvatar → Health |
| Mic and speaker mute | useAvatar → Mute |
| Multi-provider brains and BYOK | Bring your own keys |
| No-code embedding in Framer | Framer |

## How versions work

- The React and React Native SDKs share the same core but **version
  independently** — check both numbers above rather than assuming they match.
- Serialized formats (for example persisted playback clips) are versioned so
  older data keeps working across SDK updates.
- Breaking changes are called out explicitly in the entry and, where relevant,
  in a migration note.

## Staying current

Pin the SDK version in your `package.json` and upgrade deliberately — review
this page for changes before bumping. Publishing a new avatar or configuration
in the Platform does not change your installed SDK version.