transloadit · qxprakash · Jun 15, 2026 · Jun 15, 2026 · Jun 15, 2026 · Jun 15, 2026
diff --git a/.changeset/curvy-feet-chew.md b/.changeset/curvy-feet-chew.md
@@ -3,13 +3,10 @@
 "@uppy/google-photos-picker": patch
 "@uppy/google-drive-picker": patch
 "@uppy/thumbnail-generator": patch
-"@uppy/companion-client": patch
 "@uppy/golden-retriever": patch
 "@uppy/image-generator": patch
-"@uppy/provider-views": patch
 "@uppy/remote-sources": patch
 "@uppy/screen-capture": patch
-"@uppy/store-default": patch
 "@uppy/google-drive": patch
 "@uppy/image-editor": patch
 "@uppy/transloadit": patch
@@ -31,7 +28,6 @@
 "@uppy/webdav": patch
 "@uppy/audio": patch
 "@uppy/react": patch
-"@uppy/utils": patch
 "@uppy/core": patch
 "@uppy/form": patch
 "@uppy/zoom": patch
@@ -42,4 +38,4 @@
 "uppy": patch
 ---
 
-Bump shared runtime dependencies (preact, nanoid, lodash, classnames, shallow-equal, pretty-bytes, p-queue, tus-js-client, @transloadit/types @transloadit/prettier-bytes v1, is-mobile, exifr, compressorjs, rxjs, tslib). Also includes type-only fixes in `@uppy/companion`'s `jwt.ts` and `request.ts` to track `@types/jsonwebtoken` v9 and `@types/node`.
+Bump shared runtime dependencies (preact, nanoid, lodash, classnames, shallow-equal, pretty-bytes, p-queue, tus-js-client, @transloadit/types @transloadit/prettier-bytes v1, is-mobile, exifr, compressorjs, rxjs, tslib). Also includes type-only fixes in `@uppy/companion`'s `jwt.ts` and `request.ts` to track `@types/jsonwebtoken` v9 and `@types/node`.
diff --git a/.changeset/lazy-berries-brake.md b/.changeset/lazy-berries-brake.md
@@ -1,5 +1,5 @@
 ---
-"@uppy/companion-client": patch
+"@uppy/core": patch
 ---
 
 uploadRemoteFile() now queues token request and websocket request as a single job in the request queue.
diff --git a/.changeset/mighty-deers-sin.md b/.changeset/mighty-deers-sin.md
@@ -1,8 +1,8 @@
 ---
-"@uppy/companion-client": major
+"@uppy/core": major
 "@uppy/companion": major
 ---
 
 Send token using websocket instead of window.opener.
-Breaking in `@uppy/companion-client` because it needs newest version of Companion in order to work.
+Breaking in `@uppy/core` because it needs newest version of Companion in order to work.
 Breaking in `@uppy/companion` because `companion.socket()` now requires `companionOptions` to be passed as the second argument.
diff --git a/MIGRATION-6.0-merge-into-core.md b/MIGRATION-6.0-merge-into-core.md
@@ -0,0 +1,82 @@
+# Migration: packages merged into `@uppy/core` (6.0)
+
+In Uppy 6.0, four packages were folded into `@uppy/core` and are now exposed through
+subpath exports. The standalone packages are **removed from npm**. This eliminates a
+class of duplicate-version bugs (every plugin already depends on `@uppy/core`, so there
+is now a single source of truth) and lets co-dependent types reference each other
+directly instead of through hand-maintained duplicates.
+
+## 1. Import paths
+
+Update imports from the removed packages to the matching `@uppy/core` subpath:
+
+| Removed package          | New import                     |
+| ------------------------ | ------------------------------ |
+| `@uppy/utils`            | `@uppy/core/utils`             |
+| `@uppy/store-default`    | `@uppy/core/store-default`     |
+| `@uppy/companion-client` | `@uppy/core/companion-client`  |
+| `@uppy/provider-views`   | `@uppy/core/provider-views`    |
+
+```diff
+- import { fetcher } from '@uppy/utils'
++ import { fetcher } from '@uppy/core/utils'
+
+- import { RequestClient } from '@uppy/companion-client'
++ import { RequestClient } from '@uppy/core/companion-client'
+```
+
+Then:
+
+1. Remove `@uppy/utils`, `@uppy/store-default`, `@uppy/companion-client`, and
+   `@uppy/provider-views` from your `package.json`.
+2. Make sure `@uppy/core` is listed as a dependency (it already is for any plugin).
+
+## 2. CSS
+
+The provider UI styles moved with the code:
+
+| Old                                      | New                                            |
+| ---------------------------------------- | ---------------------------------------------- |
+| `@uppy/provider-views/css/style.min.css` | `@uppy/core/provider-views/css/style.min.css`  |
+| `@uppy/provider-views/css/style.css`     | `@uppy/core/provider-views/css/style.css`      |
+
+> Most apps don't import this directly — it ships bundled in `@uppy/dashboard`'s CSS.
+> Only update it if you were importing the provider-views stylesheet explicitly.
+
+## 3. TypeScript types
+
+- **`RequestOptions`** moved from `@uppy/utils` to `@uppy/core/companion-client`
+  (it is the companion request type and now lives next to `RequestClient`).
+
+  ```diff
+  - import type { RequestOptions } from '@uppy/utils'
+  + import type { RequestOptions } from '@uppy/core/companion-client'
+  ```
+
+- **`CompanionClientProvider` / `CompanionClientSearchProvider`** are **removed**. They
+  were hand-maintained stand-ins that only existed because `@uppy/utils` couldn't see
+  the real provider classes. Now that everything lives in `@uppy/core`, the real classes
+  are used directly. If you typed against them, import the real class from
+  `@uppy/core/companion-client` instead (or `Pick` the members you need):
+
+  ```diff
+  - import type { CompanionClientProvider } from '@uppy/utils'
+  + import type Provider from '@uppy/core/companion-client'
+  - const p: CompanionClientProvider = ...
+  + const p: Provider<MyMeta, MyBody> = ...
+  ```
+
+  Note: `UnknownProviderPlugin['provider']` is now typed as a structural subset of
+  `Provider` (via `Pick`), so a custom provider that matches the public surface still
+  fits without subclassing the exact class.
+
+## 4. The `uppy` all-in-one package — no change
+
+If you use the meta-package or the CDN bundle, nothing changes:
+
+```js
+import { Uppy, Dashboard, DefaultStore } from 'uppy' // still works
+// window.Uppy.DefaultStore — still works
+```
+
+These re-exports were repointed to the new `@uppy/core` subpaths internally.
diff --git a/examples/companion-custom-provider/client/MyCustomProvider.jsx b/examples/companion-custom-provider/client/MyCustomProvider.jsx
@@ -1,8 +1,12 @@
 /** @jsx h */
 
-import { getAllowedHosts, Provider, tokenStorage } from '@uppy/companion-client'
 import { UIPlugin } from '@uppy/core'
-import { ProviderViews } from '@uppy/provider-views'
+import {
+  getAllowedHosts,
+  Provider,
+  tokenStorage,
+} from '@uppy/core/companion-client'
+import { ProviderViews } from '@uppy/core/provider-views'
 
 const defaultOptions = {}
 

diff --git a/examples/companion-custom-provider/package.json b/examples/companion-custom-provider/package.json
@@ -4,11 +4,9 @@
   "private": true,
   "type": "module",
   "dependencies": {
-    "@uppy/companion-client": "workspace:*",
     "@uppy/core": "workspace:*",
     "@uppy/dashboard": "workspace:*",
     "@uppy/google-drive": "workspace:*",
-    "@uppy/provider-views": "workspace:*",
     "@uppy/tus": "workspace:*",
     "preact": "^10.29.2"
   },

diff --git a/packages/@uppy/angular/turbo.json b/packages/@uppy/angular/turbo.json
@@ -2,11 +2,7 @@
   "extends": ["//"],
   "tasks": {
     "build": {
-      "dependsOn": [
-        "@uppy/core#build",
-        "@uppy/dashboard#build",
-        "@uppy/utils#build"
-      ],
+      "dependsOn": ["@uppy/core#build", "@uppy/dashboard#build"],
       "inputs": [
         "projects/uppy/angular/src/**/*.{js,ts,jsx,tsx}",
         "package.json",

diff --git a/packages/@uppy/audio/package.json b/packages/@uppy/audio/package.json
@@ -40,7 +40,6 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@uppy/utils": "workspace:^",
     "preact": "^10.29.2"
   },
   "devDependencies": {

diff --git a/packages/@uppy/audio/src/Audio.tsx b/packages/@uppy/audio/src/Audio.tsx
@@ -7,8 +7,8 @@ import type {
 } from '@uppy/core'
 
 import { UIPlugin } from '@uppy/core'
-import type { LocaleStrings } from '@uppy/utils'
-import { getFileTypeExtension } from '@uppy/utils'
+import type { LocaleStrings } from '@uppy/core/utils'
+import { getFileTypeExtension } from '@uppy/core/utils'
 import packageJson from '../package.json' with { type: 'json' }
 import locale from './locale.js'
 import PermissionsScreen from './PermissionsScreen.js'

diff --git a/packages/@uppy/audio/src/DiscardButton.tsx b/packages/@uppy/audio/src/DiscardButton.tsx
@@ -1,4 +1,4 @@
-import type { I18n } from '@uppy/utils'
+import type { I18n } from '@uppy/core/utils'
 
 interface DiscardButtonProps {
   onDiscard: () => void

diff --git a/packages/@uppy/audio/src/PermissionsScreen.tsx b/packages/@uppy/audio/src/PermissionsScreen.tsx
@@ -1,4 +1,4 @@
-import type { I18n } from '@uppy/utils'
+import type { I18n } from '@uppy/core/utils'
 import type { h } from 'preact'
 
 interface PermissionsScreenProps {

diff --git a/packages/@uppy/audio/src/RecordButton.tsx b/packages/@uppy/audio/src/RecordButton.tsx
@@ -1,4 +1,4 @@
-import type { I18n } from '@uppy/utils'
+import type { I18n } from '@uppy/core/utils'
 
 interface RecordButtonProps {
   recording: boolean

diff --git a/packages/@uppy/audio/src/RecordingScreen.tsx b/packages/@uppy/audio/src/RecordingScreen.tsx
@@ -1,4 +1,4 @@
-import type { I18n } from '@uppy/utils'
+import type { I18n } from '@uppy/core/utils'
 import { useEffect, useRef } from 'preact/hooks'
 import AudioSourceSelect, {
   type AudioSourceSelectProps,

diff --git a/packages/@uppy/audio/src/SubmitButton.tsx b/packages/@uppy/audio/src/SubmitButton.tsx
@@ -1,4 +1,4 @@
-import type { I18n } from '@uppy/utils'
+import type { I18n } from '@uppy/core/utils'
 
 interface SubmitButtonProps {
   onSubmit: () => void

diff --git a/packages/@uppy/audio/tsconfig.build.json b/packages/@uppy/audio/tsconfig.build.json
@@ -7,9 +7,6 @@
   "include": ["./src/**/*.*"],
   "exclude": ["./src/**/*.test.ts"],
   "references": [
-    {
-      "path": "../utils/tsconfig.build.json"
-    },
     {
       "path": "../core/tsconfig.build.json"
     }

diff --git a/packages/@uppy/audio/tsconfig.json b/packages/@uppy/audio/tsconfig.json
@@ -6,9 +6,6 @@
   },
   "include": ["./package.json", "./src/**/*.*"],
   "references": [
-    {
-      "path": "../utils/tsconfig.build.json"
-    },
     {
       "path": "../core/tsconfig.build.json"
     }

diff --git a/packages/@uppy/aws-s3/package.json b/packages/@uppy/aws-s3/package.json
@@ -37,10 +37,6 @@
     ".": "./lib/index.js",
     "./package.json": "./package.json"
   },
-  "dependencies": {
-    "@uppy/companion-client": "workspace:^",
-    "@uppy/utils": "workspace:^"
-  },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.362.0",
     "@aws-sdk/s3-request-presigner": "^3.362.0",

diff --git a/packages/@uppy/aws-s3/src/HTTPCommunicationQueue.ts b/packages/@uppy/aws-s3/src/HTTPCommunicationQueue.ts
@@ -1,5 +1,8 @@
 import type { Body, Meta, UppyFile } from '@uppy/core'
-import type { RateLimitedQueue, WrapPromiseFunctionType } from '@uppy/utils'
+import type {
+  RateLimitedQueue,
+  WrapPromiseFunctionType,
+} from '@uppy/core/utils'
 import type AwsS3Multipart from './index.js'
 import type {
   AwsS3MultipartOptions,

diff --git a/packages/@uppy/aws-s3/src/MultipartUploader.ts b/packages/@uppy/aws-s3/src/MultipartUploader.ts
@@ -1,6 +1,6 @@
 import type { Uppy } from '@uppy/core'
-import type { Body, Meta, UppyFile } from '@uppy/utils'
-import { AbortController } from '@uppy/utils'
+import type { Body, Meta, UppyFile } from '@uppy/core/utils'
+import { AbortController } from '@uppy/core/utils'
 import type { HTTPCommunicationQueue } from './HTTPCommunicationQueue.js'
 
 const MB = 1024 * 1024

diff --git a/packages/@uppy/aws-s3/src/index.ts b/packages/@uppy/aws-s3/src/index.ts
@@ -1,25 +1,20 @@
-import { RequestClient } from '@uppy/companion-client'
 import {
   BasePlugin,
   type DefinePluginOpts,
   EventManager,
   type PluginOpts,
   type Uppy,
 } from '@uppy/core'
-import type {
-  Body,
-  LocalUppyFile,
-  Meta,
-  RequestOptions,
-  UppyFile,
-} from '@uppy/utils'
+import type { RequestOptions } from '@uppy/core/companion-client'
+import { RequestClient } from '@uppy/core/companion-client'
+import type { Body, LocalUppyFile, Meta, UppyFile } from '@uppy/core/utils'
 import {
   createAbortError,
   filterFilesToEmitUploadStarted,
   filterFilesToUpload,
   getAllowedMetaFields,
   RateLimitedQueue,
-} from '@uppy/utils'
+} from '@uppy/core/utils'
 import packageJson from '../package.json' with { type: 'json' }
 import createSignedURL from './createSignedURL.js'
 import { HTTPCommunicationQueue } from './HTTPCommunicationQueue.js'

diff --git a/packages/@uppy/aws-s3/src/utils.ts b/packages/@uppy/aws-s3/src/utils.ts
@@ -1,5 +1,5 @@
-import type { Body } from '@uppy/utils'
-import { createAbortError } from '@uppy/utils'
+import type { Body } from '@uppy/core/utils'
+import { createAbortError } from '@uppy/core/utils'
 
 import type { AwsS3Part } from './index.js'
 

diff --git a/packages/@uppy/aws-s3/tsconfig.build.json b/packages/@uppy/aws-s3/tsconfig.build.json
@@ -7,12 +7,6 @@
   "include": ["./src/**/*.*"],
   "exclude": ["./src/**/*.test.ts"],
   "references": [
-    {
-      "path": "../companion-client/tsconfig.build.json"
-    },
-    {
-      "path": "../utils/tsconfig.build.json"
-    },
     {
       "path": "../core/tsconfig.build.json"
     }

diff --git a/packages/@uppy/aws-s3/tsconfig.json b/packages/@uppy/aws-s3/tsconfig.json
@@ -7,12 +7,6 @@
   },
   "include": ["./package.json", "./src/**/*.*"],
   "references": [
-    {
-      "path": "../companion-client/tsconfig.build.json"
-    },
-    {
-      "path": "../utils/tsconfig.build.json"
-    },
     {
       "path": "../core/tsconfig.build.json"
     }

diff --git a/packages/@uppy/box/package.json b/packages/@uppy/box/package.json
@@ -34,9 +34,6 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@uppy/companion-client": "workspace:^",
-    "@uppy/provider-views": "workspace:^",
-    "@uppy/utils": "workspace:^",
     "preact": "^10.29.2"
   },
   "peerDependencies": {

diff --git a/packages/@uppy/box/src/Box.tsx b/packages/@uppy/box/src/Box.tsx
@@ -1,9 +1,3 @@
-import {
-  type CompanionPluginOptions,
-  getAllowedHosts,
-  Provider,
-  tokenStorage,
-} from '@uppy/companion-client'
 import type {
   AsyncStore,
   Body,
@@ -13,9 +7,14 @@ import type {
   UppyFile,
 } from '@uppy/core'
 import { UIPlugin, type Uppy } from '@uppy/core'
-import { ProviderViews } from '@uppy/provider-views'
-
-import type { LocaleStrings } from '@uppy/utils'
+import {
+  type CompanionPluginOptions,
+  getAllowedHosts,
+  Provider,
+  tokenStorage,
+} from '@uppy/core/companion-client'
+import { ProviderViews } from '@uppy/core/provider-views'
+import type { LocaleStrings } from '@uppy/core/utils'
 // biome-ignore lint/style/useImportType: h is not a type
 import { type ComponentChild, h } from 'preact'
 import packageJson from '../package.json' with { type: 'json' }

diff --git a/packages/@uppy/box/tsconfig.build.json b/packages/@uppy/box/tsconfig.build.json
@@ -7,15 +7,6 @@
   "include": ["./src/**/*.*"],
   "exclude": ["./src/**/*.test.ts"],
   "references": [
-    {
-      "path": "../companion-client/tsconfig.build.json"
-    },
-    {
-      "path": "../provider-views/tsconfig.build.json"
-    },
-    {
-      "path": "../utils/tsconfig.build.json"
-    },
     {
       "path": "../core/tsconfig.build.json"
     }