who-am-i-now

Which platform am I on?

Do you need to run platform specific code?

If you need to (programmatically) find the answer to one of the following questions then this package is for you:

• "is my app a react frontend?"
• "is my app a nextjs app?"
• "is my app a PWA standalone (installed) app?"
• "is my app a react-native app?"
• "is my app an expo app?"
• "is my react-native or expo app running on ios, android or web?"
• "is my app a plain node server?"
• etc.

This package is extending the functionality of react-device-detect, by additionally detecting which 'platform' your code is running on and other things.

Live demos

Using who-am-i-now in an expo app

https://snack.expo.dev/@maks-io/who-am-i-now-demo

Using who-am-i-now in a react app

https://stackblitz.com/edit/who-am-i-now-react

Using who-am-i-now in a next.js app

https://stackblitz.com/edit/who-am-i-now-nextjs

Installation

Via npm:

npm i who-am-i-now --save

Via yarn:

yarn add who-am-i-now

Usage

import WhoAmINow, { Who } from "who-am-i-now";

const who: Who = WhoAmINow();

// Example result:
// who = {
//     isMobile: true,
//     isBrowser: false,
//     isReactNativeApp: true,
//     isReactNativeAppIOS: true,
//     isReactNativeAppAndroid: false,
//     isReactNativeAppWeb: false,
//     isExpoApp: true,
//     isReactApp: false,
//     isNextApp: false,
//     isTWA: false,
//     isPWAStandalone: false,
//     isServerApp: false,
//     ... and many others - check section below for details
// }

Selectors

The result of calling whoAmINow() is an object holding various selectors/booleans/values. Every prop is either

• inheriting the behaviour from the original react-device-detect library (entries marked with **), or
• having a different behaviour compared to the original react-device-detect library (entries marked with *), or
• completely new (entries in table without asterisks)

| selector | type | explanation | | ----------------------- | -------------------- |-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | isReactNativeApp | boolean | returns true if code is running in a react-native app (with and without expo) | | isReactNativeAppIOS | boolean | returns true if code is running in a react-native app (with and without expo) and if the platform is ios | | isReactNativeAppAndroid | boolean | returns true if code is running in a react-native app (with and without expo) and if the platform is android | | isReactNativeAppWeb | boolean | returns true if code is running in a react-native app (with and without expo) and if the platform is web (Note that this will be false if code is running in a plain react web app!) | | isExpoApp | boolean | returns true if code is running in a react-native app via expo | | isExpoAppRunningInGo | boolean | undefined | returns true if code is running in expo Go, returns false otherwise, if it is still an expo app, and returns undefined in every other case | | isExpoSnack | boolean | undefined | returns true if code is running in an expo snack, returns false otherwise, if it is still an expo app, and returns undefined in every other case | | isReactApp | boolean | returns true if code is running in a react app | | isNextApp | boolean | returns true if code is running in a nextjs app | | isTWA | boolean | returns true if code is running as part of an android trusted web activities app | | isPWAStandalone | boolean | returns true if code is running as part of a progressive web app / PWA in standalone mode, meaning in an installed way (for instance, after user decided to "add app to homescreen" etc.) | | isServerApp | boolean | returns true if code is running in a plain node "server" app (imagine a classical express api/server for instance) | | isCI | boolean | returns true if code is running as part of a continuous integration / CI pipeline (since version 2.1.0 it relies on the is-ci package) | | isTestRun | boolean | returns true if code is running as part of a test run (for instance jest unit tests, etc. - it relies on the environment to set the variable NODE_ENV=test) | | isJestTestRun | boolean | returns true if code is running as part of a jest test run | | isCypressTestRun | boolean | returns true if code is running as part of a cypress test run | | isBrowser* | boolean | returns true if code is running in a browser - the behaviour from react-device-detect was slightly changed | | isMobile* | boolean | returns true if code is running in a react-native app (with and without expo) but not in web browser (via react-native-web) | | isDesktop* | boolean | returns true if code is NOT running in a react-native app (with and without expo) - in other words, this is the opposite of isMobile above | | isMobileOnly** | boolean | returns the same value react-device-detect returns | | isTablet** | boolean | returns the same value react-device-detect returns | | isSmartTV** | boolean | returns the same value react-device-detect returns | | isWearable** | boolean | returns the same value react-device-detect returns | | isConsole** | boolean | returns the same value react-device-detect returns | | isEmbedded** | boolean | returns the same value react-device-detect returns | | isAndroid** | boolean | returns the same value react-device-detect returns | | isWinPhone** | boolean | returns the same value react-device-detect returns | | isIOS** | boolean | returns the same value react-device-detect returns | | isChrome** | boolean | returns the same value react-device-detect returns | | isFirefox** | boolean | returns the same value react-device-detect returns | | isSafari** | boolean | returns the same value react-device-detect returns | | isOpera** | boolean | returns the same value react-device-detect returns | | isIE** | boolean | returns the same value react-device-detect returns | | isEdge** | boolean | returns the same value react-device-detect returns | | isYandex** | boolean | returns the same value react-device-detect returns | | isChromium** | boolean | returns the same value react-device-detect returns | | isMobileSafari** | boolean | returns the same value react-device-detect returns | | isSamsungBrowser** | boolean | returns the same value react-device-detect returns | | osVersion** | string | returns the same value react-device-detect returns | | osName** | string | returns the same value react-device-detect returns | | fullBrowserVersion** | string | returns the same value react-device-detect returns | | browserVersion** | string | returns the same value react-device-detect returns | | browserName** | string | returns the same value react-device-detect returns | | mobileVendor** | string | returns the same value react-device-detect returns | | mobileModel** | string | returns the same value react-device-detect returns | | engineName** | string | returns the same value react-device-detect returns | | engineVersion** | string | returns the same value react-device-detect returns | | getUA** | string | returns the same value react-device-detect returns | | deviceType** | string | returns the same value react-device-detect returns | | isIOS13** | boolean | returns the same value react-device-detect returns | | isIPhone13** | boolean | returns the same value react-device-detect returns | | isIPad13** | boolean | returns the same value react-device-detect returns | | isIPod13** | boolean | returns the same value react-device-detect returns | | isElectron** | boolean | returns the same value react-device-detect returns | | isEdgeChromium** | boolean | returns the same value react-device-detect returns | | isLegacyEdge** | boolean | returns the same value react-device-detect returns | | isWindows** | boolean | returns the same value react-device-detect returns | | isMacOs** | boolean | returns the same value react-device-detect returns |

Misc

Youtube short: https://youtube.com/shorts/sKyRYo9h514?feature=share

Release workflow

Releases are automated via semantic-release and are triggered by pushes to main.

• Feature branches are safe to push and only run CI.
• Commits that land on main must follow the conventional commit format.
• semantic-release decides whether to publish a new version based on the commits since the last git tag.

Source of truth for versions

The canonical released version is the latest npm version / git tag / GitHub Release.

The checked-in package.json version in this repository may lag behind the latest published npm version. This is expected in the current setup because release metadata is generated during CI and is not committed back to main.

If you want to inspect the latest released version locally, fetch tags and inspect the most recent one:

git fetch --tags
git tag --sort=-version:refname | head -n 5

Local commands

npm run commit
npm run verify
npm run release:dry-run

• npm run commit opens the interactive conventional commit flow.
• npm run verify runs the build and test suite.
• npm run release:dry-run previews what semantic-release would do without publishing.