README

LaraCare Schema Visualizr is an intelligent Laravel package that automatically generates UML/Class Diagrams from your Eloquent Models and Database Migrations, providing a clear and dynamic visualization of your application’s architecture.

It helps developers, architects, and researchers instantly understand model attributes, relationships, and schema structure, all rendered in Mermaid.js format.

Features

• Automatic Model Discovery: Scans all your Laravel model classes and extracts their structure via reflection.
• Migration Intelligence: Parses migration files to infer table names, columns, and foreign key relationships.
• Relationship Detection: Identifies hasOne, hasMany, belongsTo, and belongsToMany relationships using runtime analysis.
• Unified Schema Understanding: Combines information from both models and migrations for complete schema accuracy.
• Visual Representation: Outputs diagrams in Mermaid Class Diagram syntax, compatible with Markdown, Docs, and LiveView rendering.
• Safe & Extensible Architecture: Built with modular parsers (ModelParser, MigrationParser) for easy extension and maintenance.

📦 Installation

composer require laracare/schema-visualizr --dev

Publish the configuration

php artisan vendor:publish --provider="LaraCare\SchemaVisualizr\SchemaVisualizrProvider"

🧠 How It Works

The package works in three main stages:

🧱 Core Components

1️⃣ Diagram Service

This is the central service that generates the final UML.

Location: src/Services/Diagram.php

Responsibilities:

• Load and analyze model classes.

• Parse migration files.

• Detect relationships.

• Generate Mermaid UML syntax.

• Example:

use LaraCare\SchemaVisualizr\Services\Diagram;
use LaraCare\SchemaVisualizr\Parsers\ModelParser;

$diagram = new Diagram(new ModelParser());
$uml = $diagram->generate();

echo $uml;

Output Example:

%%{ init: { 'theme': 'base', 'themeVariables': { 'primaryColor': '#257abbff' }}}%%
classDiagram
    class User {
        +id: string
        +name: string
        +email: string
    }

    class Post {
        +id: string
        +title: string
        +user_id: string
    }

    User --> Post : HasMany
    Post --> User : BelongsTo

🧑‍💻 Author

Jery FOTO AI/ML & IoT Developer | Laravel Backend Engineer 📧 [jery@example.com ] 🌐 https://jery-portal.vercel.app

⭐ Contribute

Pull requests are welcome! If you have new ideas for schema visualization or AI-assisted architecture diagrams, open an issue or PR.

💬 Feedback & Support

Your feedback helps this package evolve intelligently.

• 🧩 Contributions: Fork, improve, and send a PR — every contribution counts.

• 📧 Direct Contact: Contact Me (for professional collaboration)