README

A Laravel Boost plugin that provides Webminty's Laravel & PHP coding standards as an AI skill. When installed, AI code assistants automatically follow Webminty's conventions for any Laravel or PHP work.

Requirements

• PHP 8.2+
• Laravel Boost

Installation

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

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

What It Does

This package registers three skills with Laravel Boost:

Skills activate automatically based on context, ensuring consistent adherence to Webminty's conventions regardless of frontend stack.

Standards Overview

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

• 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()

Naming Conventions

Code Quality Tools

Full Reference

The complete guidelines are available: https://github.com/webmintydotcom/standards

For a Laravel Quickstart: https://github.com/webmintydotcom/laravel-quickstart

Changelog

This package follows Semantic Versioning. See CHANGELOG.md for release history.

Thank you

Webminty team