PHPackages                             yii3/app-inertia-vue - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. yii3/app-inertia-vue

ActiveProject

yii3/app-inertia-vue
====================

A Yii 3 application template powered by Inertia 3 and Vue 3.

10CSSCI passing

Since Aug 28Pushed yesterdayCompare

[ Source](https://github.com/yii3/app-inertia-vue)[ Packagist](https://packagist.org/packages/yii3/app-inertia-vue)[ RSS](/packages/yii3-app-inertia-vue/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

Yii 3 Inertia Vue application
=============================

[](#yii-3-inertia-vue-application)

`yii3/app-inertia-vue` is a reference application that integrates Yii 3, Inertia.js 3, Vue 3.5, TypeScript, and Vite 8. Yii owns routing and page data, Inertia carries page responses and navigation state, and Vue renders the interactive interface.

Home page
---------

[](#home-page)

The home page demonstrates the integration with working application behavior:

- **Architecture** presents a constructor-injected invokable action and the explicit PSR-15 middleware pipeline that handles each request.
- **Stack** shows the Yii, Inertia, Vue, and Vite responsibilities in one server-driven request flow.
- **Partial reloads** refresh only the `runtime` page prop while preserving the persistent layout, deferred data, and scroll position.
- **Deferred props** resolve the `ecosystem` diagnostics group after the first response, with an accessible loading state in Vue.
- **Infinite scroll** exposes `requestFeed` through `Prop::scroll()`. The server provides cursor metadata, Inertia merges `requestFeed.data`, and Vue appends each three-event page inside a contained scroll region.
- **Explore** links to the local debugger when access is allowed, the official Yii 3 guide, the neutral Yii 2 upgrade guide, and the application source.
- A persistent light and dark theme follows the operating-system preference until the visitor chooses a mode, then stores that choice locally.

Requirements
------------

[](#requirements)

- PHP 8.3 or later.
- Composer 2.
- Node.js 22.12 or later.

Install locally
---------------

[](#install-locally)

Install the locked PHP and frontend dependencies, build the production assets, and create the local environment file:

```
composer install
npm ci
npm run build
cp .env.example .env
```

Start the application on port 8081:

```
./yii serve
```

Open .

Vite development server
-----------------------

[](#vite-development-server)

For hot module replacement, set `VITE_DEV_SERVER=true` in `.env`, then run the Vite and Yii development servers in separate terminals:

```
npm run dev
```

```
./yii serve
```

The PHP application continues to own routing and the initial HTML response. Vite serves the Vue entrypoint and hot updates. In production mode, `PHPForge\Vite\Vite` reads `public/build/.vite/manifest.json`; the manifest modification time also provides the Inertia asset version.

Debugger
--------

[](#debugger)

`yii3/debug` is a development dependency. Its toolbar middleware wraps the Inertia pipeline when the package is installed and exposes local-only request history and `/debug` routes. The home page applies the same local-IP policy before showing its Debugger link.

See the [debugger notes](docs/debugger.md) for the integration details and reference captures.

Project map
-----------

[](#project-map)

```
config/routes.php                 Named Yii 3 routes
config/di/application.php         PSR-15 middleware pipeline
config/di/vite.php                Vite configuration
config/params.php                 Application and Inertia parameters
public/index.php                  Dotenv and HTTP application bootstrap
resources/js/app.ts               Typed Inertia and Vue bootstrap
resources/js/composables/         Persistent theme state
resources/js/layouts/             Persistent Vue application shell
resources/js/pages/Home.vue       Home page and Inertia demonstrations
resources/js/styles/app.css       Application visual system
resources/views/app.php           Initial Inertia HTML document
src/Web/Workbench/HomeAction.php  Home props and scroll pagination
tests/Web/                        Essential browser-level application tests

```

Yii references
--------------

[](#yii-references)

- [Official Yii 3 guide](https://yiisoft.github.io/docs/guide/)
- [Moving from Yii 2](https://yiisoft.github.io/docs/guide/intro/upgrade-from-v2.html)explains how to rebuild and verify one application flow at a time. Keeping a mature Yii 2 application running can also be a valid choice.
- [Yii 3 release announcement](https://www.yiiframework.com/news/777/yii3-is-released)
- [Official Yii packages](https://github.com/yiisoft)

Quality checks
--------------

[](#quality-checks)

```
npm run typecheck
npm run build
composer tests
composer static
composer check-dependencies
vendor/bin/ecs check --ansi
```

PHPStan runs at maximum level. Use `composer ecs` when you intentionally want to apply coding-standard fixes. The Web suite covers the home page, its feed pagination, and the application-owned 404 response without duplicating tests for framework or tooling packages.

License
-------

[](#license)

The application is released under the BSD 3-Clause License. See `LICENSE`.

###  Health Score

21

—

LowBetter than 17% of packages

Maintenance65

Regular maintenance activity

Popularity2

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/524d2b46690f41fce7188d369488a35e7624e6c5a264d82aacd08548bfd156ab?d=identicon)[terabytesoftw](/maintainers/terabytesoftw)

---

Top Contributors

[![terabytesoftw](https://avatars.githubusercontent.com/u/42547589?v=4)](https://github.com/terabytesoftw "terabytesoftw (2 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

### Embed Badge

![Health badge](/badges/yii3-app-inertia-vue/health.svg)

```
[![Health](https://phpackages.com/badges/yii3-app-inertia-vue/health.svg)](https://phpackages.com/packages/yii3-app-inertia-vue)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
