README

LaraNexus is a visual intelligence and architectural mindmapping toolkit designed for Laravel architects and engineering teams. It automatically transforms complex application flows into interactive, sleek, and intuitive node graphs in real time.

⚡ The Route Sprawl Crisis & The LaraNexus Solution

The Problem: In fast-growing Laravel projects, hundreds of routes, complex middleware pipelines, and controller dependencies turn system architecture into an opaque black box. New engineers take weeks to onboard, and unprotected endpoints slip into production unnoticed.
The Solution: LaraNexus provides zero-configuration, living architecture mindmaps. It inspects your application's routing layer at runtime, highlights security middleware with visual lock badges (🔐), statically discovers connected Eloquent models and Blade views, and enables 1-click jumps directly to controller lines in VS Code.

✨ Key Features

🗺️ Interactive Architecture Mindmap: View your entire application topology from Route to Method in a node-based Mermaid.js graph.
🎨 Modern Dark-Mode UI: Glassmorphic dashboard built with Tailwind CSS and Alpine.js.
🔐 Automated Security Mapping: Instant middleware detection with visual security badges (🔐 auth, verified, throttle).
🔍 Deep Static Discovery: Scans controller source code for imported Eloquent Models (use App\Models\...) and rendered Blade views (view('...')).
🛠️ 1-Click IDE Bridge: Click any controller subgraph to open the exact file and line in VS Code (vscode://file/...).
📑 Project Tree Explorer: Hierarchical view of your application's source code files.
⚡ Real-Time Live Search: Instant node filtering with spotlight highlights and dimming.
📤 Vector SVG Export: Download high-resolution vector diagrams for pull requests, presentations, or ADRs.
🔒 Zero Production Footprint: Designed strictly for local development; does not add overhead to remote environments.

📦 Installation

Install LaraNexus via Composer as a development-only dependency:

composer require diusazzad/laranexus --dev

You can optionally publish the configuration file to customize the URL path and middleware:

php artisan vendor:publish --tag="laranexus-config"

🚀 Usage

Start your local development server:

php artisan serve

Then visit the interactive portals in your browser:

Endpoint	Purpose
`http://127.0.0.1:8000/laranexus`	LaraNexus Portal & Landing Page: Metrics, case studies, and architecture overview
`http://127.0.0.1:8000/laranexus/mindmap`	Interactive Mindmap Canvas: Full-screen interactive graph with search and SVG export
`http://127.0.0.1:8000/laranexus/docs`	Documentation Hub: In-depth technical guides, case studies, and contributing manual

Note

By default, LaraNexus is only accessible in the local environment for security reasons.

⚙️ Configuration

The published configuration file config/laranexus.php allows customization:

return [
    /*
     * The URI path where LaraNexus will be accessible.
     */
    'path' => env('LARANEXUS_PATH', 'laranexus'),

    /*
     * Route middleware applied to LaraNexus screens.
     */
    'middleware' => [
        'web',
    ],
];

💼 Real-World Case Studies

FinTech Enterprise Onboarding (85% Faster): Reduced new engineer ramp-up time on a 450+ route monolith from 14 business days to under 2 hours. Read Case Study.
HealthTech Security Compliance (17 Flags): Discovered 17 unprotected endpoints before an official ISO-27001 audit using visual middleware badges. Read Case Study.
E-Commerce God Controller Refactoring: Safely decomposed a 2,400-line controller into focused domain actions using visual model and view dependency clustering. Read Case Study.

📚 Documentation Sitemap

Explore our in-depth markdown documentation in the docs/ directory:

🤝 Contributing

We welcome contributions of all kinds! Please check out our Contribution Guide and review our Pull Request Guide before submitting code.

Fork the repo and create a feature branch (git switch -b feat/my-feature).
Write clean code with strict typing (declare(strict_types=1);).
Format with Laravel Pint: ./vendor/bin/pint.
Ensure tests pass: php artisan test.
Open a PR using our .github/PULL_REQUEST_TEMPLATE.md.

🛡️ Security

If you discover any security-related issues, please email diusazzad@gmail.com instead of using the public issue tracker. See SECURITY.md for details.

📄 License

The MIT License (MIT). Please see the LICENSE file for more information.

Built with ❤️ for the Laravel Community by Sazzad Hossain (diusazzad)

diusazzad / laranexus

Package info

Security

Statistics