Registry / aws / vite-plugin-react-router-amplify-hosting

vite-plugin-react-router-amplify-hosting

library0.7.0jsnpmunverified

Vite plugin for deploying React Router SSR applications to AWS Amplify Hosting. Current version 0.7.0 (supports Vite 5/6/7/8, React Router v7, Node >=20). Generates deploy-manifest.json, bundles a server.mjs entry point, and produces the correct folder structure for Amplify deployment. Requires manual installation of express, compression, morgan, isbot, and @react-router/express. Alternative to Amplify's built-in SSR support with tighter React Router integration.

aws web-framework devops

npm install vite-plugin-react-router-amplify-hosting

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-REACT-

vite-plugin-react-router-amplify-hosting

awsjavascriptv0.7.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

amplifyHosting

✓ import { amplifyHosting } from 'vite-plugin-react-router-amplify-hosting'

✗ import amplifyHosting from 'vite-plugin-react-router-amplify-hosting'

Named export only. Default import will not work.

AmplifyHostingOptions

✓ import type { AmplifyHostingOptions } from 'vite-plugin-react-router-amplify-hosting'

✗ import { AmplifyHostingOptions } from 'vite-plugin-react-router-amplify-hosting'

TypeScript type export, cannot be used as runtime value.

AmplifyHostingConfig

✓ import type { AmplifyHostingConfig } from 'vite-plugin-react-router-amplify-hosting'

✗ import { AmplifyHostingConfig } from 'vite-plugin-react-router-amplify-hosting'

TypeScript type export, cannot be used as runtime value.

Minimal Vite config adding the amplify plugin for React Router SSR on Amplify Hosting.

// vite.config.ts import { defineConfig } from 'vite'; import { reactRouter } from '@react-router/dev/vite'; import { amplifyHosting } from 'vite-plugin-react-router-amplify-hosting'; export default defineConfig({ plugins: [ reactRouter(), amplifyHosting({ computeResources: 'serverless', }), ], });

Debug

Known issues

breakingRequires Node.js v20 or later. Older Node versions cause build failures.

fix

Upgrade Node to v20 or use nvm in CI: nvm install 20 && nvm use 20

affects: <20.0.0

breakingPlugin generates non-standard deploy structure; artifacts.baseDirectory must be .amplify-hosting.

fix

Set artifacts.baseDirectory: .amplify-hosting in amplify.yml

affects: >=0.1.0

deprecatedThe unstable_viteEnvironmentApi flag has been experimental in some versions; prefer stable API.

fix

Remove unstable_viteEnvironmentApi flag; use stable configuration.

affects: >=0.2.0 <0.5.0

gotchaMissing server dependencies (express, compression, morgan, isbot, @react-router/express) cause SSR build failures.

fix

npm add -D compression express isbot morgan @react-router/express

affects: >=0.1.0

gotchaVite 8 support added in 0.7.0; older versions break with Vite 8.

fix

Upgrade to vite-plugin-react-router-amplify-hosting@0.7.0

affects: <0.7.0

Errors

Common errors & fixes

Cannot find module 'express' or '@react-router/express'

Missing required runtime dependencies for the server bundle.

fix

npm install express compression morgan @react-router/express

Error: Node version (18.x) is not supported. Expected Node.js >=20.0.0

Plugin requires Node.js v20 or later due to engine constraints.

fix

Use nvm install 20 && nvm use 20 in preBuild phase of amplify.yml

The 'baseDirectory' should be '.amplify-hosting' but is '.next' or other

Amplify build settings must point to the output directory generated by this plugin.

fix

Set artifacts.baseDirectory: .amplify-hosting in amplify.yml

Upgrade

Version history

0.7.0latest on npm

Audit

Dependencies

@react-router/devrequiredpeer dependency

viterequiredpeer dependency

expressrequiredrequired for SSR server

compressionrequiredrequired for server bundle

morganrequiredrequired for server bundle

@react-router/expressrequiredrequired for server bundle

isbotoptionalrequired for server bundle

Agent activity

38 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/fossamagna/react-router-amplify ↗

packagehttps://www.npmjs.com/package/vite-plugin-react-router-amplify-hosting ↗