# julianoczkowski/solidjs architecture

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

- Interactive diagram: https://gitdiagram.com/julianoczkowski/solidjs
- Repository: https://github.com/julianoczkowski/solidjs

## Overview

##### Project Type and Purpose
- This is primarily a front-end application template and documentation system built with SolidJS/SolidStart (TypeScript) that integrates Trimble Modus Web Components for UI, supplemented by AI-driven developer tooling (Cursor Memories & Rules) and Figma MCP for design-to-code context. It’s often deployed as a static+SSR site with an associated local AI/IDE integration and design-system bridge.

##### File Structure Analysis
- Top-level directories:
- Cursor Memories (AI memory definitions)
- Cursor Project Rules (AI rule sets enforcing standards)
- Cursor User Rule (developer’s personal workflow)
- MCP (Model Context Protocol config for Figma & Context7)
- WebComponentsDocs (40+ MD guides for each Modus component)
- README.md orchestrates usage of SolidStart + Modus components + Cursor + MCP. There are no classic “backend” or “database” directories—SSR is handled by SolidStart internally.

##### Key Architecture Insights from README
- SSR + hydration via SolidStart
- Custom Elements registration (defineCustomElements)
- Styling via Modus CSS custom properties (+ optional Tailwind)
- Cursor IDE communicates with local MCP servers (Context7, Figma)
- Documentation is a static markdown site alongside the code

##### Main Components
a. Developer Environment
- IDE/Text Editor (with Cursor plugin)
- Cursor Memories & Rules loaded from project folders
b. Build & Runtime
- Vite (or SolidStart build tool)
- Node‐based SSR Server (SolidStart)
- Client Browser (CSR + hydration)
c. UI Library & Styling
- TypeScript declarations (global.d.ts)
d. Documentation Subsystem
- Static markdown files (WebComponentsDocs)
- MDX/Markdown rendering pipeline (e.g., VitePress or custom)
e. External Services
- Figma MCP Server (via MCP/mcp.json)
- Context7 MCP server (Cursor’s AI backend)

##### Relationships & Data Flows
- Developer → IDE with Cursor → loads Memories & Rules → provides inline AI assistance
- Source code → Build tool (Vite/SolidStart) → outputs SSR server + static assets
- SSR Server ↔ Browser: initial HTML + JS for hydration (Mount Guard pattern)
- Browser → Modus Web Components (registered custom elements)
- SSR Server ↔ MCP servers:
- Context7 (AI context)
- Figma (design tokens & component specs)

##### Architectural Patterns & Principles
- SSR + CSR hydration (Show fallback until mounted)
- Custom Web Components as UI primitives
- Model Context Protocol for AI/design integration
- AI-first developer workflow (Cursor Memories & Rules)
- CSS custom properties for theming

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Developer Environment
    subgraph "Developer Environment"
        direction TB
        IDE["IDE / Text Editor (with Cursor plugin)"]:::devTools
        CMem["Cursor Memories"]:::devTools
        CPR["Cursor Project Rules"]:::devTools
        CUR["Cursor User Rule"]:::devTools
    end

    IDE -->|"loads memories"| CMem
    IDE -->|"loads project rules"| CPR
    IDE -->|"loads user rule"| CUR

    %% External Services
    subgraph "External Services"
        direction TB
        Figma["Figma MCP Server"]:::external
        Context7["Context7 MCP Server"]:::external
    end

    IDE -->|"AI requests"| Context7
    IDE -->|"design requests"| Figma

    %% Build & Runtime
    subgraph "Build & Runtime"
        direction TB
        Source["Source Code"]:::code
        Build["Vite / SolidStart Build"]:::runtime
        SSR["SolidStart SSR Server"]:::runtime
        Browser["Browser (CSR + hydration)"]:::runtime
        WebComp["Modus Web Components"]:::runtime
    end

    Source -->|"build"| Build
    Build -->|"deploy SSR"| SSR
    SSR -->|"SSR HTML response"| Browser
    Browser -->|"hydrate UI"| WebComp
    SSR -->|"design context"| Figma
    SSR -->|"AI context"| Context7

    %% Documentation Subsystem
    subgraph "Documentation Subsystem"
        direction TB
        Docs["Modus Web Components Markdown guides"]:::docs
        Pipeline["MDX/Markdown Rendering Pipeline"]:::docs
    end

    Docs -->|"render docs"| Pipeline

    %% Project Orchestration
    Orchestrator["README.md (Project Orchestration)"]:::docs

    %% Legend
    subgraph "Legend"
        direction TB
        L1["Green: Developer Tools"]:::devTools
        L2["Blue: Runtime"]:::runtime
        L3["Orange: External Services"]:::external
        L4["Grey: Documentation"]:::docs
    end

    %% Click Events
    click CMem "https://github.com/julianoczkowski/solidjs/tree/main/Cursor Memories/"
    click CPR "https://github.com/julianoczkowski/solidjs/tree/main/Cursor Project Rules/"
    click CUR "https://github.com/julianoczkowski/solidjs/tree/main/Cursor User Rule/"
    click Figma "https://github.com/julianoczkowski/solidjs/blob/main/MCP/mcp.json"
    click Context7 "https://github.com/julianoczkowski/solidjs/blob/main/MCP/mcp.json"
    click Docs "https://github.com/julianoczkowski/solidjs/tree/main/WebComponentsDocs/"
    click Orchestrator "https://github.com/julianoczkowski/solidjs/blob/main/README.md"

    %% Styles
    classDef devTools fill:#ccffcc,stroke:#333,stroke-width:1px
    classDef runtime fill:#ccddff,stroke:#333,stroke-width:1px
    classDef external fill:#ffdead,stroke:#333,stroke-width:1px
    classDef docs fill:#e0e0e0,stroke:#333,stroke-width:1px
    classDef code fill:#f0f8ff,stroke:#333,stroke-width:1px
```
