A lightweight (2.9k) alternative to mixpanel-js with offline support for Hybrid and Progressive Web Apps.
Events are written to localStorage first and are only removed once the Mixpanel HTTP API confirms receipt, thus allowing the device to go offline without losing events.
Add mixpanel-lite.min.js to your project:
<script src="mixpanel-lite.min.js"></script>At present only the following methods are supported:
// setup mixpanel mixpanel.init('your-token-here'); // pass { mute: true } to mute by default // assign all future events to a user mixpanel.identify('user@email.com'); // register 'Gender' as a super property mixpanel.register({'Gender': 'Female'}); // assign user info mixpanel.people.set({ $email: 'user@email.com' // only special properties need the $ }); // track an event mixpanel.track('Your Event Name' { firstName: 'Optional event property 1', lastName: 'Optional event property 2' }); // get super property mixpanel.getProperty('distinct_id'); // clear current identity mixpanel.reset(); // stop sending data to mixpanel (calls to track, identify etc are ignored) mixpanel.mute(); // resume sending data to mixpanel mixpanel.unmute(); // check if mixpanel is muted if (mixpanel.muted) { console.log('Mixpanel is disabled'); }mixpanel-lite adds additional properties to each tracking event:
| Name | Type | Description |
|---|---|---|
offline | boolean | true if event captured when offline |
automated | boolean | true if event captured using an automated browser |
dev | boolean | true if event captured when running locally |
ad | object | object containing online ad click ids |
utm | object | object containing UTM tracking values |
bot | boolean | true if script executing via a bot request |
Pull requests are welcomed:
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature - Commit your changes:
git commit -m 'Add some feature' - Push to the branch:
git push origin my-new-feature - Submit a pull request
mixpanel-lite uses window.localStorage and window.Promise which should exist in all modern browsers.
To generate a new mixpanel-lite.min.js from source, tweak the version number in package.json and run:
npm run buildStar the repo if you find this useful as it helps me prioritize which bugs I should tackle first.
For change-log, check releases.
Licensed under MIT License © John Doherty