PHPackages                             webminty/boost-webminty-guidelines - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. webminty/boost-webminty-guidelines

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

webminty/boost-webminty-guidelines
==================================

Webminty Laravel &amp; PHP coding guidelines for Laravel Boost

3.3.0(1mo ago)0208↓68.2%2MITBladePHP ^8.2

Since Feb 17Pushed 1mo agoCompare

[ Source](https://github.com/webmintydotcom/boost-webminty-guidelines)[ Packagist](https://packagist.org/packages/webminty/boost-webminty-guidelines)[ Docs](https://webminty.com)[ RSS](/packages/webminty-boost-webminty-guidelines/feed)WikiDiscussions main Synced yesterday

READMEChangelog (8)Dependencies (3)Versions (9)Used By (2)

Boost Webminty Guidelines
=========================

[](#boost-webminty-guidelines)

A [Laravel Boost](https://laravelboost.com) plugin that provides [Webminty's](https://webminty.com) Laravel &amp; PHP coding standards as an AI skill. When installed, AI code assistants automatically follow Webminty's conventions for any Laravel or PHP work.

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

[](#requirements)

- PHP 8.2+
- Laravel Boost

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

[](#installation)

```
composer require webminty/boost-webminty-guidelines --dev
```

The package auto-discovers via Laravel's package discovery — no additional setup required.

What It Does
------------

[](#what-it-does)

This package registers four skills with Laravel Boost:

SkillActivates When**webminty-laravel-standards**Writing, editing, or reviewing any Laravel/PHP code**webminty-tailwind-standards**Writing or editing Tailwind CSS in Blade, Livewire, Inertia, or the CSS entry file**webminty-livewire-standards**Working on Livewire components, form objects, or `wire:` directives**webminty-inertia-standards**Working on controllers returning Inertia responses, shared data, or Inertia testingSkills activate automatically based on context, ensuring consistent adherence to Webminty's conventions regardless of frontend stack.

Standards Overview
------------------

[](#standards-overview)

### PHP

[](#php)

- `declare(strict_types=1)` in every file
- All classes `final` by default
- Typed properties, parameters, and return types (including `void`)
- Constructor property promotion
- Strict comparison (`===` / `!==`)
- PSR-12 compliance (includes PSR-1)

### Laravel

[](#laravel)

- **Models** — `$guarded = ['id']`, `casts()` method, `#[Scope]` attribute for query scopes
- **Actions** — Single-purpose `final` classes with an `execute()` method for business logic
- **Controllers** — Thin controllers that delegate to Actions; Form Requests for validation
- **DTOs** — Extend `Spatie\LaravelData\Data`, always `final`
- **Routes** — Kebab-case URLs, dot-notation names, RESTful conventions
- **Migrations** — Anonymous classes, `hash_id` pattern, boolean columns prefixed with `is_`/`has_`
- **Testing** — Pest PHP with `test()` syntax, architecture tests to enforce standards
- **Jobs** — `final`, `ShouldQueue`, dependencies injected in `handle()`

### Tailwind CSS

[](#tailwind-css)

- **Tailwind v4** with CSS-first config — `@import "tailwindcss"` and `@theme` in a single CSS entry file; no `tailwind.config.js`
- Default to built-in utilities and the default scale (spacing, colour, radius, font-size, breakpoint)
- Brand tokens only via `@theme` (`--color-brand-*`, `--font-display`)
- Extract repeated utility patterns to **components** (Blade / Livewire / Inertia), not custom CSS via `@apply`
- Class ordering enforced by `prettier-plugin-tailwindcss`
- Container queries (`@container`, `@sm:`, `@md:`) for component-level responsiveness
- `data-*:` and `aria-*:` variants for stateful UI over JS class toggling
- `focus-visible:` (not `focus:`) for focus rings

### Naming Conventions

[](#naming-conventions)

WhatConventionExampleURLskebab-case`/about-us`Route namesdot notation`tickets.show`ModelsSingular PascalCase`User`ActionsVerb-first PascalCase`CreateTicket`TablesPlural snake\_case`mash_items`Columnssnake\_case`is_active`Viewskebab-case`ticket-list.blade.php`Commands`app:` prefix, kebab-case`app:send-email`### Code Quality Tools

[](#code-quality-tools)

ToolPurposeLaravel PintCode formattingPHPStan + LarastanStatic analysis (level 5)RectorAutomated refactoringPest PHPTestingPer-Project File Conventions
----------------------------

[](#per-project-file-conventions)

In addition to coding standards, this package mandates three documentation files at the root of every project that installs it. AI assistants will create and maintain these files automatically as work progresses.

FilePurposeUpdate trigger**`features.md`**Canonical record of what the product does — `Status: In Development | Live`, then user-facing features and backend features. Used later for documentation, marketing copy, and build-out planning.End of any feature/PR that adds, changes, or removes a user-facing capability or backend feature.**`DECISIONS.md`**Append-only log of non-obvious technical and architectural decisions (stack picks, package choices, data-model trade-offs, opting out of Laravel defaults). Each entry: `## YYYY-MM-DD — Title`, **Decision**, **Why**, **Alternatives considered**.When making a choice another developer would reasonably ask "why did we do it this way?" about. Prior entries are never edited or deleted.**`CHANGELOG.md`**Reverse-chronological log of user-visible changes, grouped by `Added` / `Changed` / `Fixed` / `Removed` / `Deprecated` / `Security` under a date or version heading. Follows [Keep a Changelog](https://keepachangelog.com).When shipping a release, deploy, or user-visible change. Pre-launch projects collect entries under `## Unreleased`.`features.md` is distinct from `README.md`: README covers how to install, run, and develop the project; `features.md` covers what the product does. The full convention details (including what *not* to put in each file) live in the always-loaded `core.blade.php` guideline.

Full Reference
--------------

[](#full-reference)

The complete guidelines are available:

For a Laravel Quickstart:

Changelog
---------

[](#changelog)

This package follows [Semantic Versioning](https://semver.org). See [CHANGELOG.md](CHANGELOG.md) for release history.

Thank you
---------

[](#thank-you)

[Webminty](https://webminty.com) team

###  Health Score

44

—

FairBetter than 90% of packages

Maintenance90

Actively maintained with recent releases

Popularity15

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity52

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

Total

8

Last Release

51d ago

Major Versions

1.0.0 → 2.0.02026-02-24

2.0.1 → 3.0.02026-03-26

### Community

Maintainers

![](https://www.gravatar.com/avatar/6df96861ef914619e7d981dda936319ef29c8fcdf2f47c4a5c2e8f6ec25e3ff0?d=identicon)[webmintydotcom](/maintainers/webmintydotcom)

---

Top Contributors

[![webmintydotcom](https://avatars.githubusercontent.com/u/176715447?v=4)](https://github.com/webmintydotcom "webmintydotcom (13 commits)")

---

Tags

laravelcoding-standardsguidelinesboostwebminty

### Embed Badge

![Health badge](/badges/webminty-boost-webminty-guidelines/health.svg)

```
[![Health](https://phpackages.com/badges/webminty-boost-webminty-guidelines/health.svg)](https://phpackages.com/packages/webminty-boost-webminty-guidelines)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[renatomarinho/laravel-page-speed

Laravel Page Speed

2.5k1.7M11](/packages/renatomarinho-laravel-page-speed)[spatie/boost-spatie-guidelines

Spatie's Laravel &amp; PHP coding guidelines for Laravel Boost

105179.2k8](/packages/spatie-boost-spatie-guidelines)[vinkius-labs/laravel-page-speed

Laravel Page Speed

2.5k12.5k1](/packages/vinkius-labs-laravel-page-speed)[spatie/guidelines-skills

Spatie's coding guidelines as AI skills for Laravel Boost and skills.sh

8873.2k2](/packages/spatie-guidelines-skills)[emargareten/inertia-modal

Inertia Modal is a Laravel package that lets you implement backend-driven modal dialogs for Inertia apps.

90142.9k](/packages/emargareten-inertia-modal)

PHPackages © 2026

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