README

Yii Framework

Inertia.js + React 19 Application Template

Skeleton Yii2 application with Inertia.js + React 19 integration
Server-driven SPA with Tailwind CSS v4, shadcn/ui, dark mode, live Inertia infinite scroll, and Codeception tests

Use the "Use this template" button on GitHub to create your own repository from this template.

Features

Yii 22.0 preview hero and Vite 8 runtime tooling

Quick start

# create a new Yii2 application using the Inertia.js + React 19 template
composer create-project --prefer-dist yii2-extensions/app-inertia-react:^0.1@dev app-react

# navigate to the application directory
cd app-react

# run database migrations
./yii migrate/up

# build production assets (one-shot; for live editing see the HMR workflow below)
npm run build

# start the development server
./yii serve

Development workflow with HMR

npm run build produces production assets once and exits. To edit .jsx files and see changes in the browser without rebuilding, run two processes side by side:

# Terminal 1 — Vite dev server (HMR for .jsx and Tailwind CSS)
npm run dev

# Terminal 2 — Yii2 in dev mode
YII_ENV=dev ./yii serve

How the pieces connect:

public/index.php reads the YII_ENV environment variable. When it equals dev, Yii's service locator lazily constructs the framework-agnostic Vite facade with DevelopmentConfiguration, and the root view emits <script> tags pointing at http://localhost:5173 instead of the built manifest.
React Fast Refresh is supplied through the application-owned app\vite\ReactRefreshPreambleProvider. Edits to .jsx files and CSS update in place without a full page reload.
Before deploying, stop the Vite dev server, run npm run build, unset YII_ENV (or set it to prod), and serve public/. ProductionConfiguration reads hashed assets from public/build/ via the Vite manifest.