From 5bce58f32e52c884e83a40c1a052b8826b59281e Mon Sep 17 00:00:00 2001
From: Kirill Batalin <kvbatalin@gmail.com>
Date: Tue, 15 Jul 2025 00:06:02 +0100
Subject: [PATCH] docs: add telemetrydeck-expo-plugin integration guide

Document the telemetrydeck-expo-plugin that automatically adds environment parameters to TelemetryDeck signals in Expo projects (device, app, and user context data).
---
 guides/react-setup.md | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/guides/react-setup.md b/guides/react-setup.md
index f131071..52147d5 100644
--- a/guides/react-setup.md
+++ b/guides/react-setup.md
@@ -136,6 +136,35 @@ import App from "./App";
 registerRootComponent(App);
 ```
 
+### Enhanced Expo Environment Data (Optional)
+
+For richer analytics in Expo projects, you can use the community-maintained `telemetrydeck-expo-plugin` that automatically enriches every signal with 40+ environment parameters including device info, app version, accessibility settings, locale, timezone, and more.
+
+```shell
+npm install telemetrydeck-expo-plugin
+```
+
+Add the plugin to your TelemetryDeck instance:
+
+```tsx
+import { createTelemetryDeck } from "@typedigital/telemetrydeck-react";
+import { expoPlugin } from "telemetrydeck-expo-plugin";
+
+const td = createTelemetryDeck({
+  app: process.env.APP_ID,
+  user: "anonymous",
+  plugins: [expoPlugin], // Automatically adds device, app, and user context
+});
+```
+
+This plugin automatically adds parameters like:
+- **Device**: model, OS version, architecture, screen resolution, orientation
+- **App**: version, build number, SDK info
+- **User preferences**: locale, timezone, color scheme, accessibility settings
+- **Context**: marketplace source, debug/release build type, and more
+
+[View the complete list of parameters and documentation](https://github.com/kbatalin/telemetrydeck-expo-plugin)
+
 ## What to do next
 
 Now that you've integrated TelemetryDeck, learn how to use the analytics platform to gain valuable insights about your users: