react-test-app

react-test-app is a basic React application intended for validating UI testing frameworks against a known, stable target.

Use it to quickly check framework setup, selectors, routing, auth flows, and regression behavior in tools such as Playwright, Cypress, Selenium, or WebdriverIO.

Why this package exists

• Provides a predictable UI surface for end-to-end and component-style UI test automation.
• Includes common app patterns (navigation, protected routes, forms, profile page).
• Ships with a CLI so test suites can start the app consistently on a chosen port.

Install

npm install react-test-app

Or from local source:

npm install ../ReactApp

Run the app for tests

Use npx:

npx react-test-app --port 4173

Or if installed globally/in a project:

react-test-app --port 4173

CLI options

• --port <number> or -p <number>: Port to run the app on.
• PORT environment variable is used when --port is not provided.

Local development

npm run dev

Build

npm run build

Build output includes static assets and CLI launcher at dist/react-test-app.js.

Package scripts

• npm run dev: Start local Vite dev server.
• npm run build: Build app and CLI launcher.
• npm run test: Run unit tests.
• npm run lint: Run linting.
• npm start -- --port 4173: Build and run the packaged launcher.

Publishing checklist

npm run build
npm pack
npm publish

If publishing under a scoped package for the first time, use:

npm publish --access public