Change8

Migrating to Remix remix@3.0.0-beta.5

Version remix@3.0.0-beta.5 introduces 2 breaking changes. This guide details how to update your code.

Released: 7/1/2026

2
Breaking Changes
2
Migration Steps
63
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

remix/ui/accordionremix/ui/accordion/primitivesremix/ui/anchorremix/ui/breadcrumbsremix/ui/buttonremix/ui/checkboxremix/ui/comboboxremix/ui/combobox/primitivesremix/ui/inputremix/ui/listboxremix/ui/menuremix/ui/menu/primitivesremix/ui/popoverremix/ui/radioremix/ui/selectremix/ui/select/primitivesremix/ui/tabsremix/ui/tabs/primitivesremix/ui/toggleremix/ui/toggle/primitivesflashAttributehiddenTypeaheadmatchNextItemBySearchTextonKeyDownSearchValuewaitwaitForCssTransitionremix/route-patterngetRoutePatternCapturesRoutePatternCaptureRoutePatternJSONremix/route-pattern/hrefCreateHrefErrorDetailsremix/route-pattern/matchMatchParamMetaremix/node-fetch-serverassetsasync-context-middlewareauthauth-middlewareclicompression-middlewarecop-middlewarecors-middlewarecsrf-middlewarefetch-proxyfetch-routerfile-storagefile-storage-s3form-data-middlewareform-data-parserfslazy-filelogger-middlewaremethod-override-middlewaremimenode-fetch-serverrender-middlewareresponseroute-patternsession-middlewarestatic-middlewareui

Breaking Changes

Issue #1

Removed helper re-exports from `remix/ui`: `flashAttribute`, `hiddenTypeahead`, `matchNextItemBySearchText`, `onKeyDown`, `SearchValue`, `wait`, and `waitForCssTransition`. These must now be imported from their specific locations or replaced.

Issue #2

Removed package exports for several component modules under `remix/components/*` and some UI modules under `remix/ui/*` (e.g., `remix/components/accordion`, `remix/ui/glyph`). Consumers must update imports to use the new `remix/ui/*` exports structure.

Migration Steps

  1. 1
    Update imports for UI components previously accessed via `remix/components/*` or deprecated `remix/ui/*` paths to use the new standardized `remix/ui/*` exports (e.g., `remix/ui/accordion`).
  2. 2
    If using deprecated helper exports from `remix/ui`, find their new specific import locations or replacements.

Release Summary

This pre-release introduces a major restructuring of package exports, standardizing UI component imports under `remix/ui/*` and removing many old component/helper exports. It also adds the `trustProxy` option to `remix/node-fetch-server` and updates numerous internal dependencies.

Need More Details?

View the full release notes and all changes for Remix remix@3.0.0-beta.5.

View Full Changelog