Name Picker Malfunction

    TypeScript icon, indicating that this package has built-in type declarations

    4.0.0 • Public • Published

    nucleus-analytics npm

    Isomorphic analytics and error tracking library for browser, Node.js, Electron and NW.js desktop applications.

    We made it as simple as possible to report the data you need to analyze your app and improve it.

    To start using this module, sign up and get an app ID on


    This module works in both the renderer and the main process, but you should use it in one process only, otherwise you'll see duplicate data. We recommend the renderer process with nodeIntegration enabled.

    This module can even run in a browser outside of Node (for example in the Electron renderer process with Node Integration disabled).

    V4.0 breaking changes

    • the .appStarted() method has been removed and integrated into .init()
    • the module is now 100% compatible with browser and hybrid environments
    • anonymous users are automatically tracked
    • user sessions now expire after 30 mins of inactivity
    • on Electron, the module is now made to be used in 1 process only (renderer recommended)
    • The device ID is now different between computer user sessions (existing users will count as new users on the dashboard)
    • .screen() has been replaced by .page() (but is still available as an alias)
    • the "autoUserId" option has been removed
    • the deprecated .checkUpdates() method has been removed
    • events are throttle to 20/s maximum
    • stop tracking device ram and arch


    Using npm:

    $ npm install nucleus-analytics --save

    In the browser:

    <script src=""></script>
    Nucleus.init("<Your App Id>")


    Sign up and get a tracking ID for your app here.

    You only need to call init once per process.

    import Nucleus from "nucleus-analytics"
    Nucleus.init("<Your App Id>")
    // Optional: sets an user ID
    // Report things
    Nucleus.track("PLAYED_TRACK", {
      trackName: "My Awesome Song",
      duration: 120,


    You can init Nucleus with options:

    import Nucleus from "nucleus-analytics"
    Nucleus.init("<Your App Id>", {
      disableInDev: false, // disable module while in development (default: false)
      disableTracking: false, // completely disable tracking from the start (default: false)
      disableErrorReports: false, // disable errors reporting (default: false)
      sessionTimeout: 60 * 60, // in seconds, after how much inactivity a session expires
      useOldDeviceId: false, // use the legacy device ID (default: false)
      debug: true, // Show logs

    Each property is optional. You can start using the module with just the app ID.

    The module will try to autodetect a maximum of data as possible but some can fail to detect. It will tell you in the logs which one it failed to detect.

    You can also change the data:

      version: "0.3.1",
      language: "fr",
      // ...

    Note : when running in development, the app version will be '0.0.0'

    Identify your users

    You can track specific users actions on the 'User Explorer' section of your dashboard.

    For that, you need to supply an userId, a string that will allow you to track your users.

    It can be your own generated ID, an email, username... etc.


    You can also pass custom attributes to be reported along with it.

    Nucleus.identify("someUniqueUserId", {
      age: 34,
      name: "Richard Hendricks",
      jobType: "CEO",

    If you call .identify() multiple times, the last one will be remembered as the current user data (it will overwrite).

    Later on, you can update the userId only (and keep the attributes) with this method:


    Update user attributes

    You can report custom user attributes along with the automatic data.

    Those will be visible in your user dashboard if you previously set an user ID.

    The module will remember past properties so you can use Nucleus.setProps multiple times without overwriting past props.

    Properties can either numbers, strings or booleans. Nested properties or arrays aren't supported at the moment.

      age: 34,
      name: "Richard Hendricks",
      jobType: "CEO",

    Enable overwrite: set the second parameter as true to overwrite past properties.

      age: 23
    }, true)


    After initializing Nucleus, you can send your own custom events.


    They are a couple event names that are reserved by Nucleus: init, error: and nucleus:. Don't report events containing these strings.

    Attach custom data

    You can also add extra information to tracked events, as a JSON object.

    Properties can either numbers, strings or booleans. Nested properties or arrays aren't supported at the moment (they won't show in the dashboard).


    Nucleus.track("PLAYED_TRACK", {
      trackName: "My Awesome Song",
      duration: 120,

    Pages and Screen Views (beta)

    You can set up Nucleus to track page visits and screen views in your app.

    For that, whenever the user navigates to a different page, call the .page() method with the new view name."View Name")

    You can attach extra info about the view. Example:"Cart", {
      action: "addItem",
      count: 5

    Params can either be numbers, strings or booleans. Nested params or arrays aren't supported at the moment (they won't show in the dashboard).

    Toggle tracking

    This will completely disable any communication with Nucleus' servers.

    To opt-out your users from tracking, use the following methods:


    and to opt back in:


    This change won't persist after restarts so you have to handle the saving of the settings.

    You can also supply a disableTracking: true option to the module on start if you want to directly prevent tracking.

    Error tracking

    Nucleus will by default report all uncaughtException, unhandledRejection and windowError events.

    If you'd like to report another type of error, you can do so with:

    Nucleus.trackError("myCustomError", err)

    Contact for any inquiry


    npm i nucleus-analytics


    DownloadsWeekly Downloads






    Unpacked Size

    195 MB

    Total Files


    Last publish


    • vincelwt