🧩 Laravel Migration Linter

“Smart developers don’t debug production — they lint migrations.”

💡 Overview

Laravel Migration Linter is a lightweight developer tool that automatically scans your database migrations for risky schema changes before they hit production.

It acts as a static analyzer for your migrations — preventing downtime, data loss, or broken deploys by catching unsafe patterns early in your CI/CD pipeline.

🚀 Key Features

🧠 Safety-first linting — Detects dangerous operations like adding non-nullable columns without defaults or dropping columns.
⚡ Performance awareness — Warns when missing indexes, column renames, or inefficient data types can impact query speed.
💾 Data integrity checks — Alerts when unique constraints, float columns, or type changes may corrupt data.
🔒 Downtime prevention — Detects column renames and operations that cause table locks on production databases.
🧩 Configurable rules — Enable, disable, or adjust severity (info, warning, error) per project.
🧱 Baseline support — Ignore known legacy issues and focus only on new violations.
📊 Developer-friendly reports — Colorized console output, JSON export, and compact mode.
🤖 CI/CD ready — Integrates cleanly with GitHub Actions, GitLab, and other pipelines.
🏗️ SOLID Architecture (v2.0.0) — Extensible with dependency injection, custom formatters, and services.
💡 Actionable Suggestions — Every warning includes fix recommendations and documentation links.

🧰 Why Use It

Traditional Laravel migrations execute directly on production data — even small mistakes can cause downtime.
Laravel Migration Linter analyzes migrations before they run, letting you:

Prevent table locks and schema conflicts
Detect destructive operations in pull requests
Enforce safe migration practices across teams
Standardize schema evolution in CI/CD workflows

📸 Example Reports

_{Screenshot from v2.1.0 — Interactive HTML report with charts, filtering, and search functionality}

_{Screenshot from v2.1.0 — showing lint warnings with flag check_all_tables => true in console output}

🧭 Next Steps

📦 Installation Guide — Learn how to install and publish config
🧩 Usage — See command options and examples
⚙️ Configuration — Customize rule severities
🧠 Writing Custom Rules — Create your own organization-specific checks
🤖 CI/CD Integration — Enforce linting in automated pipelines

💡 Overview​

🚀 Key Features​

🧰 Why Use It​

📸 Example Reports​

🧭 Next Steps​

💡 Overview

🚀 Key Features

🧰 Why Use It

📸 Example Reports

🧭 Next Steps