npmpackage.info

Gathering detailed insights and metrics for @remix-run/router

Other packages similar to @remix-run/router

@mcansh/remix-fastify

4.1.1

Fastify server request handler for Remix and React Router

remix-hono

0.0.18

Hono middlewares for Remix

remix-router-vue

0.6.1

A Vue UI layer for nested + data-driven routing via @remix-run/router

remix-router-turbo

0.7.1

@remix-run/router on rails

Gathering detailed insights and metrics for @remix-run/router

@remix-run/router - 1.23.0 | npmpackage.info

@remix-run/router

Declarative routing for React

1.23.0

55,192

MIT

TypeScript

2.62 MB

3.3

Installations

npm install @remix-run/router

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>=14.0.0

Node Version

20.18.3

NPM Version

10.8.2 Score

99.9

Supply Chain

99.6

Quality

87.6

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

37

Total

4,409

Closed

1,294

Merged

3,078

Issues

Open

89

Total

8,083

Closed

7,994

Releases

306

v7.6.3

react-router@7.6.3

Updated on Jun 27, 2025

v7.6.2

react-router@7.6.2

Updated on Jun 03, 2025

v7.6.1

react-router@7.6.1

Updated on May 25, 2025

v6.30.1

react-router@6.30.1

Updated on May 20, 2025

v7.6.0

react-router@7.6.0

Updated on May 08, 2025

v7.5.3

react-router@7.5.3

Updated on Apr 28, 2025

View All 306 releases

Languages

TypeScript

JavaScript

CSS

Shell

TypeScript (98.94%)

JavaScript (0.66%)

CSS (0.34%)

Shell (0.06%)

Developer

remix-run

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

55,192 Stars

9,883 Commits

10,650 Forks

805 Watchers

36 Branches

1,076 Contributors

Updated on Jul 13, 2025

Maintainers

View All 1,076 Contributors

Package Meta Information

Latest Version

1.23.0

Package Id

@remix-run/router@1.23.0

Unpacked Size

2.62 MB

Size

669.13 kB

File Count

NPM Version

10.8.2

Node Version

20.18.3

Published on

Feb 27, 2025

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

No dependencies detected.

Remix Router

The @remix-run/router package is a framework-agnostic routing package (sometimes referred to as a browser-emulator) that serves as the heart of React Router and Remix and provides all the core functionality for routing coupled with data loading and data mutations. It comes with built-in handling of errors, race-conditions, interruptions, cancellations, lazy-loading data, and much, much more.

If you're using React Router, you should never import anything directly from the @remix-run/router - you should have everything you need in react-router-dom (or react-router/react-router-native if you're not rendering in the browser). All of those packages should re-export everything you would otherwise need from @remix-run/router.

[!WARNING]

This router is a low-level package intended to be consumed by UI layer routing libraries. You should very likely not be using this package directly unless you are authoring a routing library such as react-router-dom or one of it's other UI ports.

API

A Router instance can be created using createRouter:

1// Create and initialize a router.  "initialize" contains all side effects
2// including history listeners and kicking off the initial data fetch
3let router = createRouter({
4  // Required properties
5  routes: [{
6    path: '/',
7    loader: ({ request, params }) => { /* ... */ },
8    children: [{
9      path: 'home',
10      loader: ({ request, params }) => { /* ... */ },
11    }]
12  },
13  history: createBrowserHistory(),
14
15  // Optional properties
16  basename, // Base path
17  mapRouteProperties, // Map framework-agnostic routes to framework-aware routes
18  future, // Future flags
19  hydrationData, // Hydration data if using server-side-rendering
20}).initialize();

Internally, the Router represents the state in an object of the following format, which is available through router.state. You can also register a subscriber of the signature (state: RouterState) => void to execute when the state updates via router.subscribe();

1interface RouterState {
2  // False during the initial data load, true once we have our initial data
3  initialized: boolean;
4  // The `history` action of the most recently completed navigation
5  historyAction: Action;
6  // The current location of the router.  During a navigation this reflects
7  // the "old" location and is updated upon completion of the navigation
8  location: Location;
9  // The current set of route matches
10  matches: DataRouteMatch[];
11  // The state of the current navigation
12  navigation: Navigation;
13  // The state of any in-progress router.revalidate() calls
14  revalidation: RevalidationState;
15  // Data from the loaders for the current matches
16  loaderData: RouteData;
17  // Data from the action for the current matches
18  actionData: RouteData | null;
19  // Errors thrown from loaders/actions for the current matches
20  errors: RouteData | null;
21  // Map of all active fetchers
22  fetchers: Map<string, Fetcher>;
23  // Scroll position to restore to for the active Location, false if we
24  // should not restore, or null if we don't have a saved position
25  // Note: must be enabled via router.enableScrollRestoration()
26  restoreScrollPosition: number | false | null;
27  // Proxied `preventScrollReset` value passed to router.navigate()
28  preventScrollReset: boolean;
29}

Navigations

All navigations are done through the router.navigate API which is overloaded to support different types of navigations:

1// Link navigation (pushes onto the history stack by default)
2router.navigate("/page");
3
4// Link navigation (replacing the history stack)
5router.navigate("/page", { replace: true });
6
7// Pop navigation (moving backward/forward in the history stack)
8router.navigate(-1);
9
10// Form submission navigation
11let formData = new FormData();
12formData.append(key, value);
13router.navigate("/page", {
14  formMethod: "post",
15  formData,
16});
17
18// Relative routing from a source routeId
19router.navigate("../../somewhere", {
20  fromRouteId: "active-route-id",
21});

Fetchers

Fetchers are a mechanism to call loaders/actions without triggering a navigation, and are done through the router.fetch() API. All fetch calls require a unique key to identify the fetcher.

1// Execute the loader for /page
2router.fetch("key", "/page");
3
4// Submit to the action for /page
5let formData = new FormData();
6formData.append(key, value);
7router.fetch("key", "/page", {
8  formMethod: "post",
9  formData,
10});

Revalidation

By default, active loaders will revalidate after any navigation or fetcher mutation. If you need to kick off a revalidation for other use-cases, you can use router.revalidate() to re-execute all active loaders.

Future Flags

We use Future Flags in the router to help us introduce breaking changes in an opt-in fashion ahead of major releases. Please check out the blog post and React Router Docs for more information on this process. The currently available future flags in @remix-run/router are:

Flag	Description
`v7_normalizeFormMethod`	Normalize `useNavigation().formMethod` to be an uppercase HTTP Method
`v7_prependBasename`	Prepend the `basename` to incoming `router.navigate`/`router.fetch` paths

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/close-feature-pr.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/close-feature-pr.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/close-no-repro-issue.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/close-no-repro-issue.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/close-no-repro-issues.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/close-no-repro-issues.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/close-no-repro-issues.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/close-no-repro-issues.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/close-no-repro-issues.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/close-no-repro-issues.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deduplicate-lock-file.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/deduplicate-lock-file.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/deduplicate-lock-file.yml:24: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/deduplicate-lock-file.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/deduplicate-lock-file.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/deduplicate-lock-file.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/docs.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/docs.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/docs.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/docs.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/docs.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/format.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/format.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/format.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/format.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/format.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/format.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/no-response.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/no-response.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-comments.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-comments.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-comments.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-comments.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-experimental.yml:21: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-experimental.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-experimental.yml:29: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-experimental.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-experimental.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-experimental.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-nightly.yml:32: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-nightly.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-nightly.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-nightly.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-nightly.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-nightly.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-stage-2-alpha.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-stage-2-alpha.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release-stage-2-alpha.yml:35: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-stage-2-alpha.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release-stage-2-alpha.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release-stage-2-alpha.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:26: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:34: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:76: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:79: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:82: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/shared-build.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/shared-build.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/shared-build.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/shared-build.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/shared-build.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/shared-build.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/shared-integration.yml:41: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/shared-integration.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/shared-integration.yml:44: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/shared-integration.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/shared-integration.yml:47: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/shared-integration.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/support.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/support.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/test.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:39: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/test.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:42: update your workflow using https://app.stepsecurity.io/secureworkflow/remix-run/react-router/test.yml/main?enable=pin
Info: 0 out of 28 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 15 third-party GitHubAction dependencies pinned

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Reason

41 existing vulnerabilities detected

Details

Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
Warn: Project is vulnerable to: GHSA-67mh-4wv8-2f99
Warn: Project is vulnerable to: GHSA-mwcw-c2x4-8c55
Warn: Project is vulnerable to: GHSA-7fh5-64p2-3v2j
Warn: Project is vulnerable to: GHSA-gcx4-mw62-g8wm
Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
Warn: Project is vulnerable to: GHSA-c24v-8rfc-w8vw
Warn: Project is vulnerable to: GHSA-8jhw-289h-jh2g
Warn: Project is vulnerable to: GHSA-64vr-g452-qvp3
Warn: Project is vulnerable to: GHSA-9cwx-2883-4wfx
Warn: Project is vulnerable to: GHSA-vg6x-rcgg-rjx6
Warn: Project is vulnerable to: GHSA-x574-m823-4x7w
Warn: Project is vulnerable to: GHSA-4r4m-qw57-chr8
Warn: Project is vulnerable to: GHSA-xcj6-pq6g-qj4x
Warn: Project is vulnerable to: GHSA-356w-63v5-8wf4
Warn: Project is vulnerable to: GHSA-859w-5945-r5v3
Warn: Project is vulnerable to: GHSA-353f-5xf4-qw67
Warn: Project is vulnerable to: GHSA-92r3-m2mg-pj97
Warn: Project is vulnerable to: GHSA-qwcr-r2fm-qrc7
Warn: Project is vulnerable to: GHSA-pxg6-pf52-xh8x
Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
Warn: Project is vulnerable to: GHSA-rv95-896h-c2vc
Warn: Project is vulnerable to: GHSA-qw6h-vgh9-j6wx
Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j
Warn: Project is vulnerable to: GHSA-rhx6-c78j-4q9w
Warn: Project is vulnerable to: GHSA-m6fv-jmcg-4jfg
Warn: Project is vulnerable to: GHSA-cm22-4g7w-348p
Warn: Project is vulnerable to: GHSA-4pfg-2mw5-f8jx
Warn: Project is vulnerable to: GHSA-h5c3-5r3r-rr8q
Warn: Project is vulnerable to: GHSA-rmvr-2pp2-xj38
Warn: Project is vulnerable to: GHSA-xx4v-prfh-6cgc
Warn: Project is vulnerable to: GHSA-8hc4-vh64-cxmj
Warn: Project is vulnerable to: GHSA-jr5f-v2jv-69x6
Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
Warn: Project is vulnerable to: GHSA-75v8-2h7p-7m2m
Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
Warn: Project is vulnerable to: GHSA-3mv9-4h5g-vhg3
Warn: Project is vulnerable to: GHSA-cxrh-j4jr-qwg3
Warn: Project is vulnerable to: GHSA-c76h-2ccp-4975

Score

3.3

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More