PHPackages                             marekmiklusek/laravel-starter-kit-livewire - 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. marekmiklusek/laravel-starter-kit-livewire

ActiveProject[Framework](/categories/framework)

marekmiklusek/laravel-starter-kit-livewire
==========================================

A Laravel livewire starter kit with code quality tools pre-configured.

v1.2.1(1mo ago)17MITBladePHP ^8.4.0CI passing

Since Nov 6Pushed 1mo agoCompare

[ Source](https://github.com/marekmiklusek/laravel-starter-kit-livewire)[ Packagist](https://packagist.org/packages/marekmiklusek/laravel-starter-kit-livewire)[ RSS](/packages/marekmiklusek-laravel-starter-kit-livewire/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (4)Dependencies (40)Versions (13)Used By (0)

🚀 Laravel Livewire Starter Kit
==============================

[](#-laravel-livewire-starter-kit)

[Laravel's official Livewire starter kit](https://laravel.com/docs/12.x/starter-kits#livewire) enhanced with development workflow tools, code quality standards, and additional developer experience improvements from [laravel-starter-kit](https://github.com/marekmiklusek/laravel-starter-kit). ✨

📋 Requirements
--------------

[](#-requirements)

- PHP &gt;= 8.4.0
- Composer
- Node.js &amp; NPM
- MySQL (or your preferred database)

🚀 Quick Start
-------------

[](#-quick-start)

Note

In `config/database.php`, `'engine' => 'InnoDB',` is used as the default for both `mysql` and `mariadb` connections.

### 📦 Installation

[](#-installation)

Create a new Laravel Livewire project:

```
composer create-project marekmiklusek/laravel-starter-kit-livewire --prefer-dist app-name
```

Run the automated setup script:

```
composer setup
```

This command will:

1. Install PHP dependencies via Composer
2. Create `.env` file from `.env.example` (if not exists)
3. Create `.env.production` file from `.env.example` (if not exists)
4. Generate application key
5. Run database migrations
6. Install NPM dependencies
7. Build frontend assets

### ⚙️ Additional Setup

[](#️-additional-setup)

#### 🔧 Environment Configuration

[](#-environment-configuration)

After running `composer setup`, configure your `.env` file with your database credentials:

```
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_username
DB_PASSWORD=your_password
```

#### 🌐 Browser Testing Setup (Optional)

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

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

```
npm install playwright
npx playwright install
```

This installs the necessary browser binaries for running browser tests.

#### 🚀 Production Environment

[](#-production-environment)

The setup script automatically creates a `.env.production` file. Configure it with production-specific settings:

```
# Edit .env.production with your production settings
```

Configure production environment variables:

- Set `APP_ENV=production`
- Set `APP_DEBUG=false`
- Configure production database credentials
- Set secure `APP_KEY` (generated during setup)
- Configure mail, cache, queue, and session drivers
- Set proper logging channels

💻 Development
-------------

[](#-development)

### 🖥️ Running the Development Server

[](#️-running-the-development-server)

Start all development services concurrently:

```
composer dev
```

This starts:

- **Laravel development server** (port 8000) - Your Livewire application
- **Queue listener** - Background job processing
- **Log viewer (Pail)** - Real-time log monitoring
- **Vite dev server** - Hot Module Replacement for CSS/JS

Your Livewire application will be available at `http://localhost:8000` 🎉

🔍 Code Quality
--------------

[](#-code-quality)

### 🧹 Linting &amp; Formatting

[](#-linting--formatting)

Fix code style issues:

```
composer lint
```

This runs:

- Rector (PHP refactoring)
- Laravel Pint (PHP formatting)
- Prettier (frontend formatting)

### 🧪 Testing

[](#-testing)

Run the full test suite:

```
composer test
```

This includes:

- Type coverage (100% minimum)
- Unit and feature tests (Pest)
- Code style validation
- Static analysis (PHPStan)

### 🌐 Browser Testing

[](#-browser-testing)

This starter kit includes Pest 4 with browser testing capabilities. Create browser tests in `tests/Browser/`:

```
it('displays the welcome page', function () {
    $page = visit('/');

    $page->assertSee('Laravel')
        ->assertNoJavascriptErrors();
});
```

### 🧪 Testing Livewire Components

[](#-testing-livewire-components)

Test your Livewire components with Pest's built-in Livewire testing:

```
use Livewire\Livewire;

it('can update user profile', function () {
    $user = User::factory()->create();

    Livewire::actingAs($user)
        ->test(\App\Livewire\Settings\Profile::class)
        ->set('name', 'New Name')
        ->call('save')
        ->assertHasNoErrors()
        ->assertDispatched('profile-updated');

    expect($user->fresh()->name)->toBe('New Name');
});
```

📜 Available Scripts
-------------------

[](#-available-scripts)

### 🎼 Composer Scripts

[](#-composer-scripts)

- `composer setup` - Initial project setup
- `composer dev` - Run all development services
- `composer lint` - Fix code style issues
- `composer test` - Run full test suite
- `composer test:unit` - Run Pest tests only
- `composer test:types` - Run PHPStan analysis
- `composer test:type-coverage` - Check type coverage
- `composer test:lint` - Validate code style
- `composer update:requirements` - Update all dependencies

### 📦 NPM Scripts

[](#-npm-scripts)

- `npm run dev` - Start Vite dev server
- `npm run build` - Build for production
- `npm run lint` - Format frontend code
- `npm run test:lint` - Check frontend code style

📄 License
---------

[](#-license)

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

###  Health Score

43

—

FairBetter than 91% of packages

Maintenance91

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity59

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 ~13 days

Recently: every ~5 days

Total

12

Last Release

44d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4b43359edbb79cfeec622571fbf701e4bf401283a5a717e1bfc296d360608459?d=identicon)[marekmiklusek](/maintainers/marekmiklusek)

---

Top Contributors

[![marekmiklusek](https://avatars.githubusercontent.com/u/112761697?v=4)](https://github.com/marekmiklusek "marekmiklusek (21 commits)")

---

Tags

frameworklaravel

###  Code Quality

TestsPest

Static AnalysisPHPStan, Rector

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/marekmiklusek-laravel-starter-kit-livewire/health.svg)

```
[![Health](https://phpackages.com/badges/marekmiklusek-laravel-starter-kit-livewire/health.svg)](https://phpackages.com/packages/marekmiklusek-laravel-starter-kit-livewire)
```

###  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)
