# muetze42/laravel-nova-demo-app architecture

> Architecture diagram of the GitHub repository muetze42/laravel-nova-demo-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/muetze42/laravel-nova-demo-app
- Repository: https://github.com/muetze42/laravel-nova-demo-app

## Overview

##### Project type and purpose
- This is a monolithic full-stack Laravel web application with an integrated Laravel Nova admin panel (“Laravel Nova Demo App”).
- Its primary goal is to demonstrate how to add “packages” (each consisting of a Model, Migration, Nova Resource, optional Factory/Seeder) into a Nova-driven admin UI.

##### File structure
- Top-level “app/” holds the core MVC code:
- app/Http/Controllers → HTTP entry points
- app/Models → Eloquent models
- app/Nova → Nova resources, dashboards, actions, perspectives
- app/Console/Commands → custom artisan commands (including Nova installers)
- “routes/” defines API and web routes.
- “resources/” contains frontend assets (CSS/JS built via Vite) and Blade views (error/illustrated layouts).
- “public/” is the webserver’s document root (index.php bootstraps Laravel).
- “database/” holds migrations, seeders, factories. “deploy.sh” automates migrate+seed.
- “config/” has Laravel and Nova configuration.
- “bootstrap/” and “artisan” support framework bootstrapping and CLI.

##### README for additional insights
- Emphasizes using a dedicated development branch.
- Workflow: create Model+Migration+Nova Resource (+ optional Factory/Seeder), register seeder in DatabaseSeeder, add resource to Nova menu via NovaServiceProvider, run `php artisan migrate --seed` and `php artisan helper`.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Public Layer"
        webServer["Web Server\n(public/index.php)"]:::infra
        staticAssets["Static Assets\n(public/assets/, public/css/, public/webfonts/)"]:::frontend
    end

    subgraph "Backend Layer"
        kernel["HTTP Kernel\n(app/Http/Kernel.php)"]:::backend
        middleware["Middleware\n(app/Http/Middleware/)"]:::backend
        routing["Routing\n(routes/web.php\nroutes/api.php)"]:::backend
        controllers["Controllers\n(app/Http/Controllers/)"]:::backend
        serviceProvider["NovaServiceProvider\n(app/Providers/NovaServiceProvider.php)"]:::backend
        novaResources["Nova Resources\n(app/Nova/Resources/)"]:::backend
        dashboards["Nova Dashboards\n(app/Nova/Dashboards/Main.php)"]:::backend
        perspectives["Nova Perspectives\n(app/Nova/Perspectives/)"]:::backend
        actions["Nova Actions\n(app/Nova/Actions/)"]:::backend
        models["Eloquent Models\n(app/Models/)"]:::backend
        config["Configuration\n(config/*.php)"]:::backend
    end

    subgraph "Data Layer"
        migrations["Migrations\n(database/migrations/)"]:::data
        seeders["Seeders & Factories\n(database/seeders/\n database/factories/)"]:::data
        database["Database\n(MySQL/Postgres)"]:::infra
    end

    subgraph "CLI & Deployment Layer"
        artisanCLI["Artisan CLI\n(artisan)"]:::cli
        consoleKernel["Console Kernel\n(app/Console/Kernel.php)"]:::cli
        consoleCommands["Console Commands\n(app/Console/Commands/)"]:::cli
        deployScript["deploy.sh"]:::cli
    end

    subgraph "Asset Pipeline"
        viteConfig["vite.config.js"]:::frontend
        js["JS Entry\n(resources/js/app.js)"]:::frontend
        css["CSS Entry\n(resources/css/app.css)"]:::frontend
    end

    webServer --> staticAssets
    webServer --> kernel
    kernel --> middleware --> routing --> controllers --> models --> database --> controllers --> routing --> kernel --> webServer
    serviceProvider --> novaResources
    serviceProvider --> dashboards
    serviceProvider --> perspectives
    serviceProvider --> actions
    novaResources --> models
    config --> kernel
    config --> serviceProvider
    viteConfig --> js --> staticAssets
    viteConfig --> css --> staticAssets
    artisanCLI --> consoleKernel --> consoleCommands --> migrations
    consoleCommands --> seeders
    consoleCommands --> serviceProvider
    deployScript --> artisanCLI
    migrations --> database
    seeders --> database

    click webServer "https://github.com/muetze42/laravel-nova-demo-app/blob/main/public/index.php"
    click staticAssets "https://github.com/muetze42/laravel-nova-demo-app/tree/main/public/assets/"
    click staticAssets "https://github.com/muetze42/laravel-nova-demo-app/tree/main/public/css/"
    click staticAssets "https://github.com/muetze42/laravel-nova-demo-app/tree/main/public/webfonts/"
    click kernel "https://github.com/muetze42/laravel-nova-demo-app/blob/main/app/Http/Kernel.php"
    click middleware "https://github.com/muetze42/laravel-nova-demo-app/tree/main/app/Http/Middleware/"
    click routing "https://github.com/muetze42/laravel-nova-demo-app/blob/main/routes/web.php"
    click routing "https://github.com/muetze42/laravel-nova-demo-app/blob/main/routes/api.php"
    click controllers "https://github.com/muetze42/laravel-nova-demo-app/blob/main/app/Http/Controllers/Controller.php"
    click controllers "https://github.com/muetze42/laravel-nova-demo-app/tree/main/app/Http/Controllers/"
    click serviceProvider "https://github.com/muetze42/laravel-nova-demo-app/blob/main/app/Providers/NovaServiceProvider.php"
    click novaResources "https://github.com/muetze42/laravel-nova-demo-app/tree/main/app/Nova/Resources/"
    click dashboards "https://github.com/muetze42/laravel-nova-demo-app/blob/main/app/Nova/Dashboards/Main.php"
    click perspectives "https://github.com/muetze42/laravel-nova-demo-app/tree/main/app/Nova/Perspectives/"
    click actions "https://github.com/muetze42/laravel-nova-demo-app/blob/main/app/Nova/Actions/RadioAction.php"
    click actions "https://github.com/muetze42/laravel-nova-demo-app/blob/main/app/Nova/Actions/RadioInlineAction.php"
    click actions "https://github.com/muetze42/laravel-nova-demo-app/tree/main/app/Nova/Actions/"
    click models "https://github.com/muetze42/laravel-nova-demo-app/tree/main/app/Models/"
    click migrations "https://github.com/muetze42/laravel-nova-demo-app/tree/main/database/migrations/"
    click seeders "https://github.com/muetze42/laravel-nova-demo-app/blob/main/database/seeders/DatabaseSeeder.php"
    click seeders "https://github.com/muetze42/laravel-nova-demo-app/tree/main/database/seeders/"
    click seeders "https://github.com/muetze42/laravel-nova-demo-app/blob/main/database/factories/UserFactory.php"
    click artisanCLI "https://github.com/muetze42/laravel-nova-demo-app/tree/main/artisan"
    click consoleKernel "https://github.com/muetze42/laravel-nova-demo-app/blob/main/app/Console/Kernel.php"
    click consoleCommands "https://github.com/muetze42/laravel-nova-demo-app/tree/main/app/Console/Commands/"
    click viteConfig "https://github.com/muetze42/laravel-nova-demo-app/blob/main/vite.config.js"
    click js "https://github.com/muetze42/laravel-nova-demo-app/blob/main/resources/js/app.js"
    click css "https://github.com/muetze42/laravel-nova-demo-app/blob/main/resources/css/app.css"
    click deployScript "https://github.com/muetze42/laravel-nova-demo-app/blob/main/deploy.sh"
    click config "https://github.com/muetze42/laravel-nova-demo-app/blob/main/config/app.php"
    click config "https://github.com/muetze42/laravel-nova-demo-app/blob/main/config/nova.php"

    classDef frontend fill:#e0f8e0,stroke:#3c763d;
    classDef backend fill:#e0f0ff,stroke:#337ab7;
    classDef infra fill:#fcf8e3,stroke:#8a6d3b;
    classDef data fill:#f5e0ff,stroke:#8b008b;
    classDef cli fill:#fff5e6,stroke:#d2691e;
```
