PHPackages                             fkrzski/project-skeleton-laravel-react - 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. fkrzski/project-skeleton-laravel-react

ActiveProject[Framework](/categories/framework)

fkrzski/project-skeleton-laravel-react
======================================

The skeleton application for the Laravel framework.

1.0.2(4mo ago)10[8 PRs](https://github.com/fkrzski/project-skeleton-laravel-react/pulls)MITTypeScriptPHP ^8.5CI passing

Since Dec 8Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/fkrzski/project-skeleton-laravel-react)[ Packagist](https://packagist.org/packages/fkrzski/project-skeleton-laravel-react)[ GitHub Sponsors](https://github.com/fkrzski)[ RSS](/packages/fkrzski-project-skeleton-laravel-react/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (3)Dependencies (24)Versions (14)Used By (0)

[![Latest Version on Packagist](https://camo.githubusercontent.com/afd5224b4e518526fe8faeee855638c7b814a8dcfdc83505145a365931e30f6c/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666b727a736b692f70726f6a6563742d736b656c65746f6e2d6c61726176656c2d72656163742e7376673f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/fkrzski/project-skeleton-laravel-react)[![Tests](https://camo.githubusercontent.com/f7bcd046f59f7fee543fd925cb5bf3024719ad69359afdfda8e120d53c6024f5/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f666b727a736b692f70726f6a6563742d736b656c65746f6e2d6c61726176656c2d72656163742f74657374732e796d6c3f6272616e63683d6d6173746572266c6162656c3d7465737473267374796c653d666f722d7468652d6261646765)](https://github.com/fkrzski/project-skeleton-laravel-react/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/f6329268fe3b87da0f9a78c91cd577c80d24dcc895e5c271550659ee04a31b44/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666b727a736b692f70726f6a6563742d736b656c65746f6e2d6c61726176656c2d72656163742e7376673f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/fkrzski/project-skeleton-laravel-react)[![License](https://camo.githubusercontent.com/295c6806268aaaed8c558d11d59826c45d247dcafb3718ce6b1c85d16c6fd82f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f666b727a736b692f70726f6a6563742d736b656c65746f6e2d6c61726176656c2d72656163743f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/fkrzski/project-skeleton-laravel-react)

**Laravel Starter Kit (Inertia &amp; React)** is an ultra-strict, type-safe [Laravel](https://laravel.com) skeleton engineered for developers who refuse to compromise on code quality. This opinionated starter kit enforces rigorous development standards through meticulous tooling configuration and architectural decisions that prioritize type safety, immutability, and fail-fast principles.

Includes [Laravel Sail](https://laravel.com/docs/sail) for seamless Docker-based development environment, ensuring consistency across all development machines.

Why This Starter Kit?
---------------------

[](#why-this-starter-kit)

Modern PHP has evolved into a mature, type-safe language, yet many Laravel projects still operate with loose conventions and optional typing. This starter kit changes that paradigm by enforcing:

- **Fully Actions-Oriented Architecture**: Every operation is encapsulated in a single-action class
- **Cruddy by Design**: Standardized CRUD operations for all controllers, actions, and Inertia &amp; React pages
- **100% Type Coverage**: Every method, property, and parameter is explicitly typed
- **Zero Tolerance for Code Smells**: Rector, PHPStan, ESLint, and Prettier at maximum strictness catch issues before they become bugs
- **Immutable-First Architecture**: Data structures favor immutability to prevent unexpected mutations
- **Fail-Fast Philosophy**: Errors are caught at compile-time, not runtime
- **Automated Code Quality**: Pre-configured tools ensure consistent, pristine code across your entire team
- **Just Better Laravel Defaults**: Thanks to **[Essentials](https://github.com/nunomaduro/essentials)** / strict models, auto eager loading, immutable dates, and more...
- **AI Guidelines**: Integrated AI Guidelines to assist in maintaining code quality and consistency
- **Full Testing Suite**: More than 150 tests with 100% code coverage using Pest
-

This isn't just another Laravel boilerplate—it's a statement that PHP applications can and should be built with the same rigor as strongly-typed languages like Rust or TypeScript.

Getting Started
---------------

[](#getting-started)

> **Requires [PHP 8.5+](https://php.net/releases/) and a code coverage driver like [pcov](https://github.com/krakjoe/pcov)** for local development, **OR [Docker](https://www.docker.com/get-started)** for Sail-based development.

Create your type-safe Laravel application using [Composer](https://getcomposer.org):

```
composer create-project fkrzski/project-skeleton-laravel-react --prefer-dist example-app
```

### Initial Setup with Laravel Sail (Recommended)

[](#initial-setup-with-laravel-sail-recommended)

Navigate to your project and start using Docker containers:

```
cd example-app

# Install dependencies (if not already installed)
composer install

# Start Sail containers
./vendor/bin/sail up -d

# Run setup inside the container
./vendor/bin/sail composer setup

# Your application is now running at http://localhost
```

**Pro tip:** Create a shell alias for Sail:

```
alias sail='./vendor/bin/sail'
```

Then you can use `sail` instead of `./vendor/bin/sail`:

```
sail up -d
sail composer setup
sail artisan migrate
```

### Initial Setup (Local Development)

[](#initial-setup-local-development)

Alternatively, you can run the project locally without Docker:

```
cd example-app

# Setup the project
composer setup

# Start the development server
composer dev
```

### Optional: Browser Testing Setup

[](#optional-browser-testing-setup)

If you plan to use Pest's browser testing capabilities:

```
# Local
npm install playwright
npx playwright install

# With Sail
./vendor/bin/sail npm install playwright
./vendor/bin/sail npx playwright install
```

### Verify Installation

[](#verify-installation)

Run the test suite to ensure everything is configured correctly:

```
# Local
composer test

# With Sail
./vendor/bin/sail composer test
```

You should see 100% test coverage and all quality checks passing.

Available Tooling
-----------------

[](#available-tooling)

> **Note:** All commands below can be prefixed with `./vendor/bin/sail` when using Laravel Sail (e.g., `./vendor/bin/sail composer test`)

### Setup &amp; Development

[](#setup--development)

- `composer setup` - Complete project setup (install dependencies, generate key, run migrations, build assets)
- `composer dev` - Starts Laravel server, queue worker, log monitoring, and Vite dev server concurrently

### Code Quality

[](#code-quality)

- `composer pint` - Runs Laravel Pint (PHP code formatter) on modified files
- `composer analyse` - Runs PHPStan static analysis
- `composer refactor` - Runs Rector for automated refactoring
- `composer lint` - Runs all formatters: Rector, Pint, and Prettier (JS/TS/CSS)

### Testing - Unit &amp; Coverage

[](#testing---unit--coverage)

- `composer test:unit` - Runs Pest tests in parallel with code coverage
- `composer test:unit:mutation` - Runs mutation testing with minimum 100% score
- `composer test:type-coverage` - Ensures 100% type coverage with Pest
- `composer test:profanity` - Checks for profanity in test names

### Testing - Static Analysis

[](#testing---static-analysis)

- `composer test:env` - Validates required environment variables
- `composer test:syntax` - Checks PHP syntax in all files
- `composer test:types` - Runs PHPStan and TypeScript type checking
- `composer test:lint` - Dry-run mode for linters (CI/CD pipelines)
- `composer test:pint` - Pint in test mode (doesn't modify files)
- `composer test:refactor` - Rector in dry-run mode

### Testing - Complete Suite

[](#testing---complete-suite)

- `composer test` - Runs the complete test suite:
    - Environment validation
    - Profanity check
    - Syntax validation
    - All linters (dry-run)
    - Type checking (PHPStan + TypeScript)
    - Type coverage (100% minimum)
    - Unit tests (parallel with coverage)
    - Mutation testing (100% minimum)

### Maintenance

[](#maintenance)

- `composer update:requirements` - Updates all PHP and NPM dependencies to latest versions

License
-------

[](#license)

**Laravel Starter Kit Inertia React** was created by **[Filip Krzyżanowski](https://www.linkedin.com/in/fkrzski/)** under the **[MIT license](https://opensource.org/licenses/MIT)**.

###  Health Score

40

—

FairBetter than 87% of packages

Maintenance82

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 67.2% 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 ~1 days

Total

3

Last Release

149d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/accf44fd0ffa5349a96edefe2daf51dc4475af31a01611acade1d44b35341d61?d=identicon)[fkrzski](/maintainers/fkrzski)

---

Top Contributors

[![fkrzski](https://avatars.githubusercontent.com/u/75097934?v=4)](https://github.com/fkrzski "fkrzski (39 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (19 commits)")

---

Tags

interialaravelreactskeletonskeleton-applicationframeworklaravel

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/fkrzski-project-skeleton-laravel-react/health.svg)

```
[![Health](https://phpackages.com/badges/fkrzski-project-skeleton-laravel-react/health.svg)](https://phpackages.com/packages/fkrzski-project-skeleton-laravel-react)
```

###  Alternatives

[codewithdennis/larament

Larament is a time-saving starter kit to quickly launch Laravel 13.x projects. It includes FilamentPHP 5.x pre-installed and configured, along with additional tools and features to streamline your development workflow.

3691.5k](/packages/codewithdennis-larament)

PHPackages © 2026

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