Workspaces created with npx @trackunit/create-iris-app-workspace now come with @trackunit/eslint-plugin-trackunit set up. The root eslint.config.cjs applies the plugin's base and react presets, and every app and extension gets a lint target. Freshly generated apps and extensions pass lint with zero errors and zero warnings. To lint the whole workspace, run:

npx nx run-many -t lint

Upgrading the @trackunit/* packages in an existing workspace doesn't set up Trackunit linting for you. To adopt Trackunit linting in a workspace you already have, follow Linting.

The published presets also no longer include Jest rules; see below if your projects use Jest.

The customerId and userId fields in the lastEdit object of a trip filter in the Compaction API are deprecated. Trackunit is retiring classic customer and user IDs, and from an upcoming release both fields will always return null.

@trackunit/iris-app-playwright 0.3.1 is a breaking release: irisApp() now returns a Promise<FrameLocator> in every environment. Because the package is still pre-1.0, the break shipped as a minor release, so a ^0.2.x range does not pick it up but any 0.3.x does.

Updated 2026-10-28: corrected the version. This entry previously said v1.0.0, which was never released; the change first shipped in 0.3.1.

Await it before using the app fixture:

// Before — no longer works
const app = irisApp();
await irisApp().getByTestId("asset-list").click();

// After
const app = await irisApp();
await app.getByTestId("asset-list").click();

// Or parenthesize a receiver chain
await (await irisApp()).getByTestId("asset-list").click();

@trackunit/custom-field-api (from 2.20.1) replaces owner.marketplaceEntry with owner.irisApp on every custom field definition returned by useCustomFieldDefinitions, useAllCustomFieldDefinitions, and useCustomFieldsValueAndDefinition — with no compatibility field. If your app reads definition.owner?.marketplaceEntry, bumping the dependency is a compile failure, not a deprecation warning. Apps that only use owner.irisAppId, or don't read owner at all, are unaffected.

Updated 2026-10-28: corrected the version. This entry previously said 2.20.0, which was never published; the change first shipped in 2.20.1.

@trackunit/react-components (from 3.0.1) removes CopyableText, and @trackunit/react-table-base-components (from 2.8.1, a minor release) removes CopyableCell, with no compatibility shim — if any of your code imports either, bumping the dependency without running the migration is a compile failure, not a deprecation warning. Repos that never used them are unaffected.

Updated 2026-10-07: corrected the versions (this entry previously said 3.0.0 for both packages) and the CopyableCell migration, which now produces CopyableValue from @trackunit/react-table-base-components 2.12.1.

Run these two commands in the consuming repo after bumping the dependencies:

nx g @trackunit/migrations:migrate
nx g @trackunit/migrations:run-migrations

@trackunit/css-class-variance-utilities (from 2.0.0) has upgraded to the upstream cva@1.0.0-beta.8 package. cvaMerge is removed with no compatibility shim — if any of your code calls it, bumping this dependency without running the migration is a compile failure, not a deprecation warning. Repos that never called cvaMerge are unaffected.

Run these two commands in the consuming repo after bumping the dependency:

nx g @trackunit/migrations:migrate
nx g @trackunit/migrations:run-migrations

@trackunit/react-drawer has been reworked to align with Sheet and Modal: a new useDrawer hook owns state and dismiss, a new DrawerHeader component provides the standard toolbar, and the panel now has explicit variant="default" | "modal" semantics. Legacy inline props on <Drawer /> (open, onClose, onOpen, hasOverlay, keepMountedWhenClosed) and the DrawerToggle component have been removed.

The @trackunit/iris-app-sdk-webpack, @trackunit/iris-app-sdk-rspack, and @trackunit/iris-app-webpack-plugin packages have been removed. Vite (@trackunit/iris-app-sdk-vite) is now the only supported build system for Iris Apps.

The Device Health Issues API is now generally available. The endpoints have been promoted from v1beta1 to v1, and the API is no longer marked as beta.

Below is a list of all available REST endpoints:

Issue API​

➕ GET: /v1/assets/{assetId}/issues

Get issues by asset

➕ GET: /v1/issues

Get issues

➕ GET: /v1/issues/{issueId}

Get issue by id

Breaking changes

⚠️ The v1beta1 endpoints have been replaced by v1. Update any integrations to use the /v1/... paths.

⚠️ The issue type LOW_DEVICE_BATTERY_VOLTAGE has been renamed to LOW_DEVICE_BATTERY. Update any filtering or handling that relies on this value.

The @trackunit/iris-app-sdk-webpack and @trackunit/iris-app-sdk-rspack build executors are deprecated and will be removed in the coming months. Vite is the supported path forward — migrate your Iris app to the Vite executor.