Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
# Changelog

## [v3.5.0](https://github.com/mixpanel/mixpanel-react-native/tree/v3.5.0) (2026-07-10)

### Features
- Adds feature flag support to main SDK ([#434](https://github.com/mixpanel/mixpanel-react-native/pull/434))

[Full Changelog](https://github.com/mixpanel/mixpanel-react-native/compare/v3.4.0...v3.5.0)

## [v3.4.0](https://github.com/mixpanel/mixpanel-react-native/tree/v3.4.0) (2026-06-15)

### Enhancements
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<img src="https://user-images.githubusercontent.com/71290498/231855346-12c8fc52-5f24-485c-b9e6-24468599fb87.png" alt="Mixpanel React Native Library" height="150"/>
</div>

##### _June 15, 2026_ - [v3.4.0](https://github.com/mixpanel/mixpanel-react-native/releases/tag/v3.4.0)
##### _July 10, 2026_ - [v3.5.0](https://github.com/mixpanel/mixpanel-react-native/releases/tag/v3.5.0)

## Table of Contents

Expand Down
92 changes: 50 additions & 42 deletions docs/Mixpanel.html
Original file line number Diff line number Diff line change
Expand Up @@ -93,7 +93,7 @@ <h4 class="name" id="Mixpanel"><span class="type-signature"></span>new Mixpanel<

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line39">line 39</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line40">line 40</a>
</li></ul></dd>


Expand Down Expand Up @@ -161,8 +161,8 @@ <h4 class="name" id="flags"><span class="type-signature"></span>flags<span class
<p>Feature Flags enable dynamic feature control and A/B testing capabilities.
This property is lazy-loaded to avoid unnecessary initialization until first access.

<p><b>Native Mode Only:</b> Feature flags are currently only available when using native mode
(iOS/Android). JavaScript mode (Expo/React Native Web) support is planned for a future release.
<p>Feature flags work in both native mode (iOS/Android) and JavaScript mode (Expo/React Native Web).
In JavaScript mode, use Flags#updateContext to update targeting context at runtime.
</div>


Expand Down Expand Up @@ -210,7 +210,7 @@ <h4 class="name" id="flags"><span class="type-signature"></span>flags<span class
<dt class="tag-see">See:</dt>
<dd class="tag-see">
<ul>
<li><a href="Flags.html">Flags</a></li>
<li>Flags</li>
</ul>
</dd>

Expand Down Expand Up @@ -370,7 +370,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line484">line 484</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line493">line 493</a>
</li></ul></dd>


Expand Down Expand Up @@ -535,7 +535,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line359">line 359</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line368">line 368</a>
</li></ul></dd>


Expand Down Expand Up @@ -628,7 +628,7 @@ <h4 class="name" id="clearSuperProperties"><span class="type-signature"></span>c

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line592">line 592</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line601">line 601</a>
</li></ul></dd>


Expand Down Expand Up @@ -790,7 +790,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line512">line 512</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line521">line 521</a>
</li></ul></dd>


Expand Down Expand Up @@ -927,7 +927,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line617">line 617</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line626">line 626</a>
</li></ul></dd>


Expand Down Expand Up @@ -1043,7 +1043,7 @@ <h4 class="name" id="flush"><span class="type-signature"></span>flush<span class

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line677">line 677</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line692">line 692</a>
</li></ul></dd>


Expand Down Expand Up @@ -1139,7 +1139,7 @@ <h4 class="name" id="getDeviceId"><span class="type-signature"></span>getDeviceI

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line664">line 664</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line679">line 679</a>
</li></ul></dd>


Expand Down Expand Up @@ -1257,7 +1257,7 @@ <h4 class="name" id="getDistinctId"><span class="type-signature"></span>getDisti

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line646">line 646</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line661">line 661</a>
</li></ul></dd>


Expand Down Expand Up @@ -1440,7 +1440,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line464">line 464</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line473">line 473</a>
</li></ul></dd>


Expand Down Expand Up @@ -1540,7 +1540,7 @@ <h4 class="name" id="getPeople"><span class="type-signature"></span>getPeople<sp

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line401">line 401</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line410">line 410</a>
</li></ul></dd>


Expand Down Expand Up @@ -1654,7 +1654,7 @@ <h4 class="name" id="getSuperProperties"><span class="type-signature"></span>get

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line580">line 580</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line589">line 589</a>
</li></ul></dd>


Expand Down Expand Up @@ -1764,7 +1764,7 @@ <h4 class="name" id="hasOptedOutTracking"><span class="type-signature"></span>ha

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line284">line 284</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line293">line 293</a>
</li></ul></dd>


Expand Down Expand Up @@ -1935,7 +1935,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line329">line 329</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line338">line 338</a>
</li></ul></dd>


Expand Down Expand Up @@ -2158,7 +2158,10 @@ <h5>Parameters:</h5>


<td class="description last">The base URL used for Mixpanel API requests.
Use "https://api-eu.mixpanel.com" for EU data residency. See setServerURL()</td>
Must match your project's data residency region:
US (default): "https://api.mixpanel.com",
EU: "https://api-eu.mixpanel.com",
India: "https://api-in.mixpanel.com". See setServerURL()</td>
</tr>


Expand Down Expand Up @@ -2339,7 +2342,8 @@ <h6>Properties</h6>


<td class="description last">Context properties used for feature flag targeting.
Can include user properties, device properties, or any custom properties for flag evaluation.
Use the `custom_properties` key to nest targeting properties
(e.g., `context: { custom_properties: { user_tier: 'premium' } }`).
Note: In native mode, context must be set during initialization and cannot be updated later.</td>
</tr>

Expand Down Expand Up @@ -2388,7 +2392,7 @@ <h6>Properties</h6>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line151">line 151</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line158">line 158</a>
</li></ul></dd>


Expand Down Expand Up @@ -2450,8 +2454,10 @@ <h5>Examples</h5>
await mixpanel.init(false, {}, 'https://api.mixpanel.com', false, {
enabled: true,
context: {
platform: 'mobile',
app_version: '2.1.0'
custom_properties: {
platform: 'mobile',
app_version: '2.1.0'
}
}
});</code></pre>

Expand Down Expand Up @@ -2525,7 +2531,7 @@ <h4 class="name" id="optInTracking"><span class="type-signature"></span>optInTra

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line294">line 294</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line303">line 303</a>
</li></ul></dd>


Expand Down Expand Up @@ -2617,7 +2623,7 @@ <h4 class="name" id="optOutTracking"><span class="type-signature"></span>optOutT

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line305">line 305</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line314">line 314</a>
</li></ul></dd>


Expand Down Expand Up @@ -2764,7 +2770,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line534">line 534</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line543">line 543</a>
</li></ul></dd>


Expand Down Expand Up @@ -2904,7 +2910,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line549">line 549</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line558">line 558</a>
</li></ul></dd>


Expand Down Expand Up @@ -3064,7 +3070,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line497">line 497</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line506">line 506</a>
</li></ul></dd>


Expand Down Expand Up @@ -3153,7 +3159,7 @@ <h4 class="name" id="reset"><span class="type-signature"></span>reset<span class

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line628">line 628</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line637">line 637</a>
</li></ul></dd>


Expand Down Expand Up @@ -3292,7 +3298,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line275">line 275</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line284">line 284</a>
</li></ul></dd>


Expand Down Expand Up @@ -3430,7 +3436,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line241">line 241</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line250">line 250</a>
</li></ul></dd>


Expand Down Expand Up @@ -3590,7 +3596,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line448">line 448</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line457">line 457</a>
</li></ul></dd>


Expand Down Expand Up @@ -3729,7 +3735,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line230">line 230</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line239">line 239</a>
</li></ul></dd>


Expand Down Expand Up @@ -3775,7 +3781,9 @@ <h4 class="name" id="setServerURL"><span class="type-signature"></span>setServer
<div class="description">
Set the base URL used for Mixpanel API requests.
Useful if you need to proxy Mixpanel requests. Defaults to https://api.mixpanel.com.
To route data to Mixpanel's EU servers, set to https://api-eu.mixpanel.com
Must match your project's data residency region:
US (default): https://api.mixpanel.com, EU: https://api-eu.mixpanel.com,
India: https://api-in.mixpanel.com
</div>


Expand Down Expand Up @@ -3868,7 +3876,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line218">line 218</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line227">line 227</a>
</li></ul></dd>


Expand Down Expand Up @@ -4008,7 +4016,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line260">line 260</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line269">line 269</a>
</li></ul></dd>


Expand Down Expand Up @@ -4147,7 +4155,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line603">line 603</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line612">line 612</a>
</li></ul></dd>


Expand Down Expand Up @@ -4313,7 +4321,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line381">line 381</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line390">line 390</a>
</li></ul></dd>


Expand Down Expand Up @@ -4502,7 +4510,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line424">line 424</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line433">line 433</a>
</li></ul></dd>


Expand Down Expand Up @@ -4643,7 +4651,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line565">line 565</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line574">line 574</a>
</li></ul></dd>


Expand Down Expand Up @@ -4832,7 +4840,7 @@ <h5>Parameters:</h5>

<dt class="tag-source">Source:</dt>
<dd class="tag-source"><ul class="dummy"><li>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line193">line 193</a>
<a href="index.js.html">index.js</a>, <a href="index.js.html#line200">line 200</a>
</li></ul></dd>


Expand Down Expand Up @@ -4878,13 +4886,13 @@ <h5>Parameters:</h5>
</div>

<nav>
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Flags.html">Flags</a></li><li><a href="Mixpanel.html">Mixpanel</a></li><li><a href="MixpanelGroup.html">MixpanelGroup</a></li><li><a href="People.html">People</a></li></ul>
<h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="Mixpanel.html">Mixpanel</a></li><li><a href="MixpanelGroup.html">MixpanelGroup</a></li><li><a href="People.html">People</a></li></ul>
</nav>

<br class="clear">

<footer>
Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.5</a> on Fri Nov 07 2025 13:06:53 GMT-0800 (Pacific Standard Time)
Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 4.0.5</a> on Fri Jul 10 2026 16:42:42 GMT+0000 (Coordinated Universal Time)
</footer>

<script> prettyPrint(); </script>
Expand Down
Loading
Loading