rvxlab/laravel-htmx-starter

An opinionated Laravel starter kit with Htmx and all kinds of tooling ready to go

dev-main 2025-06-07 06:05 UTC

Requires

• php: ^8.4
• laravel/framework: ^12.17
• laravel/octane: ^2.9
• laravel/tinker: ^2.10.1
• nunomaduro/essentials: ^0.1

Requires (Dev)

• ergebnis/composer-normalize: ^2.47
• fakerphp/faker: ^1.24.1
• larastan/larastan: ^3.4
• laravel/pail: ^1.2.3
• laravel/pint: ^1.22.1
• laravel/sail: ^1.43.1
• mockery/mockery: ^1.6.12
• nunomaduro/collision: ^8.8
• pestphp/pest: ^3.8.2
• pestphp/pest-plugin-arch: ^3.1.1
• pestphp/pest-plugin-laravel: ^3.2
• phpstan/extension-installer: ^1.4.3
• rector/rector: ^2.0.17

MIT

• laravel
• starter-kit
• htmx

README

Laravel HTMX Starter Kit

A heavily opinionated starter kit for Laravel that bundles essential tooling with the simplicity of HTMX into a jumping off point.

Requirements

• PHP 8.4
• Bun (Can be replaced with your package manager of choice, see below)

Installed Packages

The following packages come pre-installed:

• Htmx
• Lefthook
• Octane
  • FrankenPHP
• Pest
  • Arch Plugin
  • Laravel Plugin
• PHPStan
  • Larastan
• Pint
• Prettier
• Rector

Pint

The Pint config is based on Nuno Maduro's Essentials package with some tweaks:

• Uses PER preset
• Groups Imports
  • By extension, disables Single Import Per Statement
• New With Parenthesis
  • Disabled for anonymous classes
• No Unused Imports
• Yoda Style

PHPStan

By default, PHPStan is set to level 10.

Bun

By default, this starter kit uses Bun to manage JavaScript dependencies. If you prefer to use a different one, do the following:

• Delete bun.lock
• Update bun references with the equivalent of your preferred package manager in:
  • composer.json
  • lefthook.yaml
  • maskfile.md
  • package.json
• Delete the node_modules folder
• Reinstall your JavaScript dependencies

Common Scripts

Common scripts as handled using Mask.

While these are useful, you're not required to have Mask installed.