PHPackages                             vireo/starter - 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. [Framework](/categories/framework)
4. /
5. vireo/starter

ActiveProject[Framework](/categories/framework)

vireo/starter
=============

Vireo Framework application starter template with Vertical Slice Architecture and Inertia.js.

v1.2.0(3mo ago)011MITJavaScriptPHP ^8.4

Since Feb 1Pushed 3mo agoCompare

[ Source](https://github.com/mrzh4s/Vireo-Starter)[ Packagist](https://packagist.org/packages/vireo/starter)[ Docs](https://github.com/mrzh4s/vireo-starter)[ RSS](/packages/vireo-starter/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (7)Used By (0)

Vireo Starter
=============

[](#vireo-starter)

A modern PHP application starter template built on the [Vireo Framework](https://github.com/mrzh4s/vireo-framework) with Vertical Slice Architecture and Inertia.js.

Features
--------

[](#features)

- **Vertical Slice Architecture** - Organized by feature, not by layer
- **Inertia.js + React** - Modern SPA experience without building an API
- **TailwindCSS v4** - Utility-first CSS framework
- **Authentication System** - Login, registration, password reset
- **User Activity Tracking** - Monitor user actions with geolocation support
- **API Traffic Monitoring** - Track and analyze API usage
- **Role & Permission Based Access** - Fine-grained authorization
- **Rate Limiting** - Protect endpoints from abuse
- **Input Validation & Sanitization** - Built-in security features
- **Multiple Database Support** - PostgreSQL, MySQL, SQLite, SQL Server
- **Multiple Cache Drivers** - File, Redis, Memcached, Database
- **Multiple Storage Drivers** - Local, FTP, SFTP, S3, DigitalOcean Spaces, MinIO

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

[](#requirements)

- PHP 8.4+
- Composer
- Node.js 18+
- npm or yarn

Installation
------------

[](#installation)

```
# Create a new project
composer create-project vireo/starter my-app

# Navigate to project directory
cd my-app

# Install JavaScript dependencies
npm install

# Copy environment file (done automatically by composer)
cp .env.example .env

# Generate application key
./vireo key:generate

# Run database migrations
./vireo migrate

# Seed the database (optional)
./vireo db:seed
```

Development
-----------

[](#development)

Start the development servers:

```
# Start PHP development server
./vireo serve

# In a separate terminal, start Vite dev server
npm run dev

# Or run both with the dev command
composer dev
```

Visit `http://localhost:8000` in your browser.

Project Structure
-----------------

[](#project-structure)

```
├── Config/              # Application configuration
├── Features/            # Feature modules (Vertical Slices)
│   ├── Auth/            # Authentication feature
│   ├── UserActivity/    # User activity tracking
│   └── ApiMonitoring/   # API traffic monitoring
├── Infrastructure/      # Infrastructure code
│   ├── Http/            # Controllers, middleware, routes
│   ├── Persistence/     # Migrations, seeds, repositories
│   └── Resources/       # Frontend assets (JS, CSS)
└── Tests/               # Test suite

```

Available Commands
------------------

[](#available-commands)

```
# Development
./vireo serve              # Start development server
./vireo dev                # Start dev server with Vite HMR
npm run dev               # Start Vite dev server
npm run build             # Build frontend assets

# Database
./vireo migrate            # Run migrations
./vireo migrate:rollback   # Rollback last migration
./vireo migrate:status     # Show migration status
./vireo db:seed            # Run database seeders

# Testing
composer test             # Run PHPUnit tests
```

Configuration
-------------

[](#configuration)

All configuration is done through environment variables. Copy `.env.example` to `.env` and adjust the values:

- **Database**: Configure your database connection (PostgreSQL recommended for production)
- **Cache**: Choose between file, Redis, Memcached, or database caching
- **Session**: Configure session storage driver
- **Storage**: Set up file storage (local, S3, FTP, etc.)
- **Rate Limiting**: Configure API rate limits

See `.env.example` for detailed documentation of all available options.

Testing
-------

[](#testing)

```
# Run all tests
composer test

# Run specific test file
./vendor/bin/phpunit Tests/Unit/Validation/ValidatorTest.php
```

Documentation
-------------

[](#documentation)

- [Vireo Framework Documentation](https://github.com/mrzh4s/vireo-framework#readme)
- [Inertia.js Documentation](https://inertiajs.com/)
- [React Documentation](https://react.dev/)
- [TailwindCSS Documentation](https://tailwindcss.com/docs)

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to this project.

License
-------

[](#license)

This project is open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance80

Actively maintained with recent releases

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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.

###  Release Activity

Cadence

Every ~0 days

Total

6

Last Release

105d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4001d44e4ea205b8b89fe482b3554c0b4b27f6f80f1ac515122a9827c32137c9?d=identicon)[mrzh4s](/maintainers/mrzh4s)

---

Top Contributors

[![mrzh4s](https://avatars.githubusercontent.com/u/53334450?v=4)](https://github.com/mrzh4s "mrzh4s (23 commits)")

---

Tags

phpframeworkinertiaboilerplatereactstartervuevertical-slice

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vireo-starter/health.svg)

```
[![Health](https://phpackages.com/badges/vireo-starter/health.svg)](https://phpackages.com/packages/vireo-starter)
```

###  Alternatives

[kompo/kompo

Laravel & Vue.js FullStack Components for Rapid Application Development

11812.4k21](/packages/kompo-kompo)

PHPackages © 2026

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