PHPackages                             marwen-brini/smart-schema-docs - 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. [Database & ORM](/categories/database)
4. /
5. marwen-brini/smart-schema-docs

ActiveLibrary[Database & ORM](/categories/database)

marwen-brini/smart-schema-docs
==============================

Auto-generating database documentation system for Laravel - always up-to-date schema docs, ERD diagrams, and relationship mapping

v1.0.0(5mo ago)00MITPHPPHP ^8.3||^8.4CI passing

Since Dec 15Pushed 5mo agoCompare

[ Source](https://github.com/Marwen-Brini/smart-schema-docs)[ Packagist](https://packagist.org/packages/marwen-brini/smart-schema-docs)[ Docs](https://github.com/marwen-brini/smart-schema-docs)[ GitHub Sponsors](https://github.com/Marwen-Brini)[ RSS](/packages/marwen-brini-smart-schema-docs/feed)WikiDiscussions main Synced 1mo ago

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

Smart Schema Docs
=================

[](#smart-schema-docs)

[![Latest Version on Packagist](https://camo.githubusercontent.com/31eb03d63c585aaee88427ca20842146f6a030d855d14e4b6c4606de1b312562/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d617277656e2d6272696e692f736d6172742d736368656d612d646f63732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/marwen-brini/smart-schema-docs)[![GitHub Tests Action Status](https://camo.githubusercontent.com/e2ab8d934f638f3b41d4992042f42cbd381bc1ac2c796f1dcf97ad46ac051846/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d617277656e2d6272696e692f736d6172742d736368656d612d646f63732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/marwen-brini/smart-schema-docs/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/ca6f63a1d6e973f2695e18f1d67ec47eee77c0ae8bfb320a19d66b89273d0307/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6d617277656e2d6272696e692f736d6172742d736368656d612d646f63732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/marwen-brini/smart-schema-docs/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/588e710a0bc3aaa4f86896879eeb5f4d9148ba112a0e61db7c90dc107a418a33/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d617277656e2d6272696e692f736d6172742d736368656d612d646f63732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/marwen-brini/smart-schema-docs)

Auto-generating database documentation system for Laravel - always up-to-date schema docs, ERD diagrams, and relationship mapping.

Features
--------

[](#features)

- Auto-generated ERD diagrams (Mermaid, SVG, PNG)
- Interactive web documentation server
- Multiple export formats (Markdown, HTML, PDF, JSON, DBML)
- Automatic relationship detection (FK constraints + Eloquent)
- Schema change tracking and changelog
- Table statistics and analysis
- Search across entire schema
- Model docblock parsing for column descriptions

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

[](#installation)

You can install the package via composer:

```
composer require marwen-brini/smart-schema-docs --dev
```

You can publish the config file with:

```
php artisan vendor:publish --tag="smart-schema-docs-config"
```

Usage
-----

[](#usage)

### Generate Documentation

[](#generate-documentation)

```
# Generate all documentation
php artisan schema:generate

# Export to specific format
php artisan schema:export --format=markdown --output=docs/database
```

### ERD Diagrams

[](#erd-diagrams)

```
# Generate ERD diagram
php artisan schema:diagram

# Specific tables only
php artisan schema:diagram --tables=users,posts,comments

# Different formats
php artisan schema:diagram --format=svg
php artisan schema:diagram --format=mermaid
```

### Interactive Documentation Server

[](#interactive-documentation-server)

```
# Start documentation server
php artisan schema:serve
```

### Analysis Commands

[](#analysis-commands)

```
# Show table statistics
php artisan schema:stats users

# List all relationships
php artisan schema:relationships

# Search schema
php artisan schema:search "user_id"

# Show schema changelog
php artisan schema:changelog
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

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

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Marwen Brini](https://github.com/marwen-brini)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance73

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

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

Unknown

Total

1

Last Release

154d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c081aa8f05c4eec0f617cd95ebe284deea7279f694c18b084f3edfa2af992176?d=identicon)[Marwen-Brini](/maintainers/Marwen-Brini)

---

Top Contributors

[![Marwen-Brini](https://avatars.githubusercontent.com/u/23398443?v=4)](https://github.com/Marwen-Brini "Marwen-Brini (19 commits)")

---

Tags

laravelschemadatabasedocumentationerdsmart-schema-docs

###  Code Quality

TestsPest

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/marwen-brini-smart-schema-docs/health.svg)

```
[![Health](https://phpackages.com/badges/marwen-brini-smart-schema-docs/health.svg)](https://phpackages.com/packages/marwen-brini-smart-schema-docs)
```

###  Alternatives

[spatie/laravel-backup

A Laravel package to backup your application

6.0k21.8M191](/packages/spatie-laravel-backup)[illuminate/database

The Illuminate Database package.

2.8k52.4M9.4k](/packages/illuminate-database)[kreait/laravel-firebase

A Laravel package for the Firebase PHP Admin SDK

1.3k16.5M42](/packages/kreait-laravel-firebase)[dyrynda/laravel-model-uuid

This package allows you to easily work with UUIDs in your Laravel models.

4802.8M8](/packages/dyrynda-laravel-model-uuid)[clickbar/laravel-magellan

This package provides functionality for working with the postgis extension in Laravel.

423715.4k1](/packages/clickbar-laravel-magellan)[cybercog/laravel-clickhouse

ClickHouse migrations for Laravel

163166.8k](/packages/cybercog-laravel-clickhouse)

PHPackages © 2026

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