PHPackages                             probeforge/seoforge - 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. [Templating &amp; Views](/categories/templating)
4. /
5. probeforge/seoforge

ActiveLibrary[Templating &amp; Views](/categories/templating)

probeforge/seoforge
===================

Early-stage SEO troubleshooting tool for Laravel 12 Blade templates. Detects missing SEO elements and can fix basic structural issues - content still needs manual work.

v1.1.0(11mo ago)01MITPHPPHP ^8.2CI failing

Since Jun 2Pushed 11mo agoCompare

[ Source](https://github.com/adoroci/SEOForge)[ Packagist](https://packagist.org/packages/probeforge/seoforge)[ RSS](/packages/probeforge-seoforge/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (5)Versions (2)Used By (0)

SEOForge (Alpha)
================

[](#seoforge-alpha)

[![Latest Version](https://camo.githubusercontent.com/65a499c147c8baa11884c48eb91c493f21652da4200b1bc031d7f106eb8e7cbe/68747470733a2f2f706f7365722e707567782e6f72672f70726f6265666f7267652f73656f666f7267652f762f737461626c65)](https://packagist.org/packages/probeforge/seoforge)[![License](https://camo.githubusercontent.com/e95e838cccb21960249036d99f0406c448769d1a33ca68865c5ba06d7bded49e/68747470733a2f2f706f7365722e707567782e6f72672f70726f6265666f7267652f73656f666f7267652f6c6963656e7365)](https://packagist.org/packages/probeforge/seoforge)

⚠️ **Alpha Version Warning**: This is an early development tool with limitations. It's not production-ready.

A basic SEO troubleshooting tool for Laravel 12 Blade templates. Scans your templates for missing SEO elements and can fix some basic structural issues.

What This Tool Actually Does
----------------------------

[](#what-this-tool-actually-does)

**✅ What It Can Do:**

- Scan Blade templates for missing SEO elements (meta tags, Open Graph, etc.)
- Generate reports showing what's missing
- Add basic structural elements like viewport meta tag, canonical URLs, favicon links
- Create file backups before making changes
- Output results in table or JSON format

**❌ What It Cannot Do:**

- Write meta descriptions, titles, or any content for you
- Guarantee SEO success or rankings
- Fix semantic or content-related SEO issues
- Replace proper SEO strategy and planning
- Handle complex template logic or dynamic content perfectly

**🎯 Realistic Use Case:**This is a development helper to quickly identify missing SEO elements in your templates. You still need to write the actual SEO content yourself.

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

[](#installation)

```
composer require probeforge/seoforge:@dev
```

Quick Usage
-----------

[](#quick-usage)

### Check what's missing:

[](#check-whats-missing)

```
php artisan seo:audit
```

### Fix basic structural issues:

[](#fix-basic-structural-issues)

```
php artisan seo:fix --issues=viewport,canonical --backup
```

### Get JSON output for scripts:

[](#get-json-output-for-scripts)

```
php artisan seo:audit --json
```

What Gets Checked
-----------------

[](#what-gets-checked)

**Level A (Basic):**

- Title tags, meta descriptions, canonical URLs, viewport, lang attribute

**Level AA (Social):**

- Open Graph tags, Twitter cards, image alt attributes, heading hierarchy

**Level AAA (Advanced):**

- Schema markup, meta keywords, favicons, preconnect hints, hreflang

What Can Be Auto-Fixed
----------------------

[](#what-can-be-auto-fixed)

Only basic structural elements:

- `viewport` - Adds viewport meta tag
- `canonical` - Adds canonical URL link
- `favicon` - Adds favicon link
- `language` - Adds lang attribute to html tag
- `meta_robots` - Adds robots meta tag
- `preconnect` - Adds preconnect/DNS prefetch
- `apple_touch_icon` - Adds Apple touch icon

**Important**: The tool cannot create content like meta descriptions or titles - that's your job!

Commands
--------

[](#commands)

### `seo:audit`

[](#seoaudit)

```
php artisan seo:audit [--path=] [--level=A|AA|AAA] [--json]
```

### `seo:fix`

[](#seofix)

```
php artisan seo:fix [--path=] [--backup] [--issues=viewport,canonical]
```

Example Blade Setup
-------------------

[](#example-blade-setup)

```

    @yield('title', 'Default Title')

    @yield('content')

```

Then in your pages:

```
@extends('layouts.app')

@section('title', 'About Us - My Site')
@section('description', 'Learn about our company and mission.')
@section('og_title', 'About Our Company')

@section('content')
    About Us
    Content goes here...
@endsection
```

Known Issues &amp; Limitations
------------------------------

[](#known-issues--limitations)

- Table formatting can be messy in some terminals
- Regex detection may have false positives/negatives
- Cannot handle complex Blade logic
- Windows path handling has some edge cases
- Does not validate content quality, only presence
- Cannot generate meaningful content

Configuration
-------------

[](#configuration)

Optional - publish config:

```
php artisan vendor:publish --provider="ProbeForge\SEOForge\SeoForgeServiceProvider"
```

Is This For Me?
---------------

[](#is-this-for-me)

**Yes, if you want to:**

- Quickly scan templates for missing SEO elements
- Get a basic SEO checklist for your Laravel app
- Add basic structural SEO elements automatically

**No, if you expect:**

- AI-generated meta descriptions or titles
- Complete SEO optimization
- Production-ready SEO automation
- Marketing or content strategy advice

Contributing
------------

[](#contributing)

This is alpha software. Contributions welcome, but expect breaking changes.

License
-------

[](#license)

MIT License. See [LICENSE.md](LICENSE.md).

---

**Bottom Line**: This tool finds missing SEO elements and adds basic tags. You still need to write the actual SEO content yourself. It's a starting point, not a complete solution.

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance50

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity49

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

Unknown

Total

1

Last Release

351d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/548eed428563e93b4e473523fcff9f5588e8bc7bc61f54132e539c67d864aea3?d=identicon)[adoroci](/maintainers/adoroci)

---

Top Contributors

[![adoroci](https://avatars.githubusercontent.com/u/28033178?v=4)](https://github.com/adoroci "adoroci (1 commits)")

---

Tags

laravelbladeAudittemplatesoptimizationseostructured-dataschema-orgopen-graphmeta-tagstwitter cards

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/probeforge-seoforge/health.svg)

```
[![Health](https://phpackages.com/badges/probeforge-seoforge/health.svg)](https://phpackages.com/packages/probeforge-seoforge)
```

###  Alternatives

[larament/seokit

A complete SEO package for Laravel, covering everything from meta tags to social sharing and structured data.

411.9k](/packages/larament-seokit)[fitztrev/laravel-html-minify

Minifies the HTML output of Laravel 4 applications

414211.4k](/packages/fitztrev-laravel-html-minify)[ycs77/inertia-laravel-ssr-head

Simple SSR Head for Inertia Laravel

3211.5k](/packages/ycs77-inertia-laravel-ssr-head)[devrabiul/laravel-seo-manager

Laravel SEO Manager is an SEO tool that improves SEO by adding recommended meta tags.

404.8k](/packages/devrabiul-laravel-seo-manager)[yocmen/html-minify

Minifies the HTML output of Laravel 5 applications (Originally from https://github.com/fitztrev/laravel-html-minify)

1713.7k](/packages/yocmen-html-minify)

PHPackages © 2026

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