# nftushar/blockxpert architecture

> Architecture diagram of the GitHub repository nftushar/blockxpert, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nftushar/blockxpert
- Repository: https://github.com/nftushar/blockxpert

## Overview

##### Project type and purpose
- This is a WordPress plugin (“BlockXpert”) that ships custom Gutenberg blocks: ai-faq, ai-product-recommendations, and product-slider.
- It provides both editor (React/JS) and frontend rendering, plus an admin settings UI and REST endpoints for AI-driven features.

##### File structure
- Top-level plugin files: blockxpert.php, readme.txt, license.txt, composer.json, package.json, webpack.config.js.
- “src/blocks/…”: uncompiled block source (edit.js, view.js, style.scss, index.js).
- “build/…”: compiled assets (JS, CSS, PHP asset manifests) for each block.
- “includes/…”: PHP classes and admin code:
- classes/class-blockxpert.php – main plugin bootstrap
- class-blockxpert-admin-settings.php – settings page
- class-blockxpert-rest.php – REST API handlers
- class-blockxpert-blocks.php – block registration and server-side rendering
- assets/css/admin.css – admin styles
- “vendor/…“: Composer dependencies.
- “blocks/…/block.json”: per-block metadata for Gutenberg auto-discovery.

##### README for additional insights
- Minimal top-level README (“# Gutenberg-blocks”).

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Core
    WP["WordPress Core"]:::php

    %% Plugin Bootstrap
    subgraph "Plugin Bootstrap & Initialization"
        PB["blockxpert.php"]:::php
        Init["includes/init.php"]:::php
    end

    %% Plugin Backend
    subgraph "Plugin PHP Backend"
        MainClass["class-blockxpert.php"]:::php
        AdminUI["class-blockxpert-admin-settings.php"]:::php
        AdminPage["admin-page.php"]:::php
        SettingsHandler["settings-handler.php"]:::php
        AdminCSS["admin.css"]:::css
        RESTClass["class-blockxpert-rest.php"]:::php
        BlocksClass["class-blockxpert-blocks.php"]:::php
    end

    %% Blocks Registration
    subgraph "Block Metadata"
        FAQMeta["ai-faq/block.json"]:::json
        ProdRecMeta["ai-product-recommendations/block.json"]:::json
        SliderMeta["product-slider/block.json"]:::json
    end

    %% JS Source
    subgraph "Uncompiled Block Source"
        SRCIndex["src/index.js"]:::js
        subgraph "ai-faq"
            FAQEdit["edit.js"]:::js
            FAQViewSrc["view.js"]:::js
            FAQStyleSrc["style.scss"]:::css
            FAQIndexSrc["index.js"]:::js
        end
        subgraph "ai-product-recommendations"
            PREdit["edit.js"]:::js
            PRViewSrc["view.js"]:::js
            PRStyleSrc["style.scss"]:::css
            PRIndexSrc["index.js"]:::js
        end
        subgraph "product-slider"
            SLEdit["edit.js"]:::js
            SLViewSrc["view.js"]:::js
            SLStyleSrc["style.scss"]:::css
            SLIndexSrc["index.js"]:::js
        end
    end

    %% Build Assets
    subgraph "Compiled Build Assets"
        BuildIndexJS["build/index.js"]:::js
        BuildIndexAsset["build/index.asset.php"]:::php
        subgraph "ai-faq"
            FAQViewBuild["view.js"]:::js
            FAQViewAsset["view.asset.php"]:::php
            FAQStyleBuildJS["style-index.js"]:::js
            FAQStyleBuildAsset["style-index.asset.php"]:::php
            FAQCSS1["style-index.css"]:::css
            FAQCSS2["style-style-index.css"]:::css
        end
        subgraph "ai-product-recommendations"
            PRViewBuild["view.js"]:::js
            PRViewAsset["view.asset.php"]:::php
            PRStyleBuildJS["style-index.js"]:::js
            PRStyleBuildAsset["style-index.asset.php"]:::php
            PRCSS1["style-index.css"]:::css
            PRCSS2["style-style-index.css"]:::css
        end
        subgraph "product-slider"
            SLViewBuild["view.js"]:::js
            SLViewAsset["view.asset.php"]:::php
            SLStyleBuildJS["style-index.js"]:::js
            SLStyleBuildAsset["style-index.asset.php"]:::php
            SLCSS1["style-index.css"]:::css
            SLCSS2["style-style-index.css"]:::css
        end
    end

    %% Build Pipeline
    subgraph "Build Pipeline"
        Webpack["webpack.config.js"]:::build
        PackageJSON["package.json"]:::build
        PackageLock["package-lock.json"]:::build
        ComposerJSON["composer.json"]:::build
        ComposerLock["composer.lock"]:::build
        Vendor["vendor/"]:::build
    end

    %% Editor & Frontend
    subgraph "Block Editor (React UI)"
        EditorUI["Editor JS/CSS"]:::js
    end

    subgraph "Frontend Rendering"
        FrontendJS["view.js/CSS"]:::js
    end

    %% External Service
    ExternalAI["External AI Service"]:::external

    %% Relationships
    WP --> PB
    PB --> Init
    Init --> MainClass
    MainClass --> AdminUI
    MainClass --> RESTClass
    MainClass --> BlocksClass
    AdminUI --> AdminPage
    AdminUI --> SettingsHandler
    AdminUI --> AdminCSS
    BlocksClass --> FAQMeta
    BlocksClass --> ProdRecMeta
    BlocksClass --> SliderMeta

    FAQMeta --> BlocksClass
    ProdRecMeta --> BlocksClass
    SliderMeta --> BlocksClass

    Webpack --> BuildIndexJS
    Webpack --> FAQViewBuild
    Webpack --> PRViewBuild
    Webpack --> SLViewBuild

    PackageJSON --> Webpack
    PackageLock --> Webpack
    ComposerJSON --> MainClass
    ComposerLock --> MainClass
    Vendor --> MainClass

    BuildIndexJS --> EditorUI
    FAQViewBuild --> EditorUI
    PRViewBuild --> EditorUI
    SLViewBuild --> EditorUI
    FAQStyleBuildJS --> EditorUI
    PRStyleBuildJS --> EditorUI
    SLStyleBuildJS --> EditorUI

    FrontendJS -->WP
    EditorUI -->|"calls REST"| RESTClass
    RESTClass --> ExternalAI
    BlocksClass --> FrontendJS

    SettingsHandler --> WP

    %% Click Events
    click PB "https://github.com/nftushar/blockxpert/blob/main/blockxpert.php"
    click Init "https://github.com/nftushar/blockxpert/blob/main/includes/init.php"
    click MainClass "https://github.com/nftushar/blockxpert/blob/main/includes/classes/class-blockxpert.php"
    click AdminUI "https://github.com/nftushar/blockxpert/blob/main/includes/classes/class-blockxpert-admin-settings.php"
    click AdminPage "https://github.com/nftushar/blockxpert/blob/main/includes/admin/admin-page.php"
    click SettingsHandler "https://github.com/nftushar/blockxpert/blob/main/includes/admin/settings-handler.php"
    click AdminCSS "https://github.com/nftushar/blockxpert/blob/main/includes/assets/css/admin.css"
    click RESTClass "https://github.com/nftushar/blockxpert/blob/main/includes/classes/class-blockxpert-rest.php"
    click BlocksClass "https://github.com/nftushar/blockxpert/blob/main/includes/classes/class-blockxpert-blocks.php"
    click FAQMeta "https://github.com/nftushar/blockxpert/blob/main/blocks/ai-faq/block.json"
    click ProdRecMeta "https://github.com/nftushar/blockxpert/blob/main/blocks/ai-product-recommendations/block.json"
    click SliderMeta "https://github.com/nftushar/blockxpert/blob/main/blocks/product-slider/block.json"
    click SRCIndex "https://github.com/nftushar/blockxpert/blob/main/src/index.js"
    click FAQEdit "https://github.com/nftushar/blockxpert/blob/main/src/blocks/ai-faq/edit.js"
    click FAQViewSrc "https://github.com/nftushar/blockxpert/blob/main/src/blocks/ai-faq/view.js"
    click FAQStyleSrc "https://github.com/nftushar/blockxpert/blob/main/src/blocks/ai-faq/style.scss"
    click FAQIndexSrc "https://github.com/nftushar/blockxpert/blob/main/src/blocks/ai-faq/index.js"
    click PREdit "https://github.com/nftushar/blockxpert/blob/main/src/blocks/ai-product-recommendations/edit.js"
    click PRViewSrc "https://github.com/nftushar/blockxpert/blob/main/src/blocks/ai-product-recommendations/view.js"
    click PRStyleSrc "https://github.com/nftushar/blockxpert/blob/main/src/blocks/ai-product-recommendations/style.scss"
    click PRIndexSrc "https://github.com/nftushar/blockxpert/blob/main/src/blocks/ai-product-recommendations/index.js"
    click SLEdit "https://github.com/nftushar/blockxpert/blob/main/src/blocks/product-slider/edit.js"
    click SLViewSrc "https://github.com/nftushar/blockxpert/blob/main/src/blocks/product-slider/view.js"
    click SLStyleSrc "https://github.com/nftushar/blockxpert/blob/main/src/blocks/product-slider/style.scss"
    click SLIndexSrc "https://github.com/nftushar/blockxpert/blob/main/src/blocks/product-slider/index.js"
    click BuildIndexJS "https://github.com/nftushar/blockxpert/blob/main/build/index.js"
    click BuildIndexAsset "https://github.com/nftushar/blockxpert/blob/main/build/index.asset.php"
    click FAQViewBuild "https://github.com/nftushar/blockxpert/blob/main/build/ai-faq/view.js"
    click FAQViewAsset "https://github.com/nftushar/blockxpert/blob/main/build/ai-faq/view.asset.php"
    click FAQStyleBuildJS "https://github.com/nftushar/blockxpert/blob/main/build/ai-faq/style-index.js"
    click FAQStyleBuildAsset "https://github.com/nftushar/blockxpert/blob/main/build/ai-faq/style-index.asset.php"
    click PRViewBuild "https://github.com/nftushar/blockxpert/blob/main/build/ai-product-recommendations/view.js"
    click PRViewAsset "https://github.com/nftushar/blockxpert/blob/main/build/ai-product-recommendations/view.asset.php"
    click PRStyleBuildJS "https://github.com/nftushar/blockxpert/blob/main/build/ai-product-recommendations/style-index.js"
    click PRStyleBuildAsset "https://github.com/nftushar/blockxpert/blob/main/build/ai-product-recommendations/style-index.asset.php"
    click SLViewBuild "https://github.com/nftushar/blockxpert/blob/main/build/product-slider/view.js"
    click SLViewAsset "https://github.com/nftushar/blockxpert/blob/main/build/product-slider/view.asset.php"
    click SLStyleBuildJS "https://github.com/nftushar/blockxpert/blob/main/build/product-slider/style-index.js"
    click SLStyleBuildAsset "https://github.com/nftushar/blockxpert/blob/main/build/product-slider/style-index.asset.php"
    click Webpack "https://github.com/nftushar/blockxpert/blob/main/webpack.config.js"
    click PackageJSON "https://github.com/nftushar/blockxpert/blob/main/package.json"
    click PackageLock "https://github.com/nftushar/blockxpert/blob/main/package-lock.json"
    click ComposerJSON "https://github.com/nftushar/blockxpert/blob/main/composer.json"
    click ComposerLock "https://github.com/nftushar/blockxpert/blob/main/composer.lock"
    click Vendor "https://github.com/nftushar/blockxpert/tree/main/vendor/"

    %% Styles
    classDef php fill:#FFE0B2,stroke:#E65100,color:#000
    classDef js fill:#BBDEFB,stroke:#1976D2,color:#000
    classDef css fill:#C8E6C9,stroke:#388E3C,color:#000
    classDef build fill:#E1BEE7,stroke:#8E24AA,color:#000
    classDef external fill:#FFCDD2,stroke:#C62828,color:#000
```
