# accuraty/accutheme-tw4 architecture

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

- Interactive diagram: https://gitdiagram.com/accuraty/accutheme-tw4
- Repository: https://github.com/accuraty/accutheme-tw4

## Overview

##### Project type and purpose
- This is an open-source starter theme for DotNetNuke (DNN) using Tailwind CSS v4.
- It provides a complete build pipeline, DNN packaging, 2sxc module styling, DDR menus, containers, and optional Bootstrap shims.

##### File structure
- Top-level config: .env, package.json, rollup.config.*, postcss.config.ts, vite.config.ts, stylelint.config.js.
- “src/” holds Tailwind source CSS, design tokens (AccuTheme-defaults.json), media assets (favicon, fonts, images, svg, videos).
- “dependencies/” contains any third-party or internally maintained libs.
- “ps/” contains PowerShell scripts for theme configuration and favicon generation.
- “dnn/” mirrors the DNN site structure:
- App_Code and DesktopModules hold Razor templates and code for dynamic modules.
- Portals/_default/Skins and Containers define .ascx skin files, DC R menus, DNN panes.
- Portals/0/2sxc holds sample 2sxc content-app views and helpers.
- Other files: DNN project files (.sln, .csproj), config templates, robots.txt, analytics, etc.

##### README for additional insights
- Emphasizes: build commands (npm run dnnpackage, npm run images), devDependencies only, Prettier + ESLint for consistent code, local or remote DNN instance development.
- Highlights: DDR Menus, Disclosure-based Nav and Accordion, 2sxc-friendly containers, optional Bootstrap shim, advanced debug footer.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Developer Workstation
    Dev["Developer Workstation\n(Node.js, NPM, PowerShell, VS Code)"]:::runtime

    %% Configuration & Code Sources
    subgraph "Source & Config" 
        Env["Environment Config (.env)"]:::config
        Npm["NPM Scripts & Package.json"]:::buildTools
        PostCSS["Tailwind CSS Processor\n(postcss.config.ts)"]:::buildTools
        Vite["Vite Bundler\n(vite.config.ts)"]:::buildTools
        Rollup["Rollup Image Processor\n(rollup.config.images.mjs & .info.js)"]:::buildTools
        Lint["Lint & Formatting\n(stylelint.config.js, .eslintrc.js, .prettierrc)"]:::buildTools
        SrcStyles["Tailwind Source Styles & Tokens\n(src/tailwind/, AccuTheme-defaults.json)"]:::source
        SrcMedia["Static Media Assets\n(src/media/)"]:::source
        Deps["Third-Party/Internal Dependencies\n(dependencies/)"]:::source
        PS["PowerShell Scripts\n(ps/AccuTheme-Config.ps1, ps/AccuTheme-Favicons.ps1)"]:::source
    end

    %% Build Pipeline
    subgraph "Build Pipeline"
        Env --> PostCSS
        Env --> Vite
        Env --> Rollup
        Deps --> Vite
        SrcStyles --> PostCSS
        SrcMedia --> Rollup
        PS --> Npm
        Npm --> PostCSS
        Npm --> Vite
        Npm --> Rollup
        Npm --> Lint
    end

    %% Output Artifacts
    subgraph "Output Artifacts"
        Assets["Compiled CSS/JS\n(dnn/Portals/_default)"]:::source
        Images["Processed Images"]:::source
        Package["DNN Theme Package Zip"]:::source
    end

    %% DNN Theme & Runtime Components
    subgraph "DNN Theme Files & Modules"
        Razor["Razor Code Templates\n(App_Code & DesktopModules)"]:::runtime
        Modules2sxc["2sxc Module Views & Helpers\n(dnn/Portals/0/2sxc/)"]:::runtime
        Skins["ASCX Skin Files & Includes\n(dnn/Portals/_default/Skins/AccuTheme-Tw4/)"]:::runtime
        Menus["DDR Menu Definitions\n(dnn/Portals/_default/Skins/AccuTheme-Tw4/menus/)"]:::runtime
        Containers["DNN Pane Containers\n(dnn/Portals/_default/Containers/AccuTheme-Tw4/Plain.ascx)"]:::runtime
    end

    %% DNN Instance & External Services
    DNN["DotNetNuke Instance\n(Core CMS Engine)"]:::runtime
    CDN["Optional Bootstrap CDN/Shim"]:::external
    CApp["2sxc Content App"]:::external

    %% Connections
    PostCSS --> Assets
    Vite --> Assets
    Rollup --> Assets
    Rollup --> Images
    Npm --> Package
    Assets --> Razor
    Assets --> Skins
    Assets --> Menus
    Assets --> Containers
    Assets --> Modules2sxc
    Package --> DNN
    Razor --> DNN
    Skins --> DNN
    Menus --> DNN
    Containers --> DNN
    Modules2sxc --> DNN
    CDN --> DNN
    CApp --> DNN

    %% Click Events
    click PostCSS "https://github.com/accuraty/accutheme-tw4/blob/main/postcss.config.ts"
    click SrcStyles "https://github.com/accuraty/accutheme-tw4/tree/main/src/tailwind/"
    click SrcStyles "https://github.com/accuraty/accutheme-tw4/blob/main/src/AccuTheme-defaults.json"
    click Vite "https://github.com/accuraty/accutheme-tw4/blob/main/vite.config.ts"
    click Rollup "https://github.com/accuraty/accutheme-tw4/blob/main/rollup.config.images.mjs"
    click Rollup "https://github.com/accuraty/accutheme-tw4/blob/main/rollup.config.images.info.js"
    click Lint "https://github.com/accuraty/accutheme-tw4/blob/main/stylelint.config.js"
    click Lint "https://github.com/accuraty/accutheme-tw4/blob/main/.eslintrc.js"
    click Lint "https://github.com/accuraty/accutheme-tw4/blob/main/.prettierrc"
    click Env "https://github.com/accuraty/accutheme-tw4/blob/main/.env"
    click Npm "https://github.com/accuraty/accutheme-tw4/blob/main/package.json"
    click Deps "https://github.com/accuraty/accutheme-tw4/tree/main/dependencies/"
    click PS "https://github.com/accuraty/accutheme-tw4/blob/main/ps/AccuTheme-Config.ps1"
    click PS "https://github.com/accuraty/accutheme-tw4/blob/main/ps/AccuTheme-Favicons.ps1"
    click Razor "https://github.com/accuraty/accutheme-tw4/blob/main/dnn/App_Code/AccuTheme.cshtml"
    click Razor "https://github.com/accuraty/accutheme-tw4/blob/main/dnn/DesktopModules/RazorModules/RazorHost/Scripts/AccuTheme-Tw4--Colors.cshtml"
    click Razor "https://github.com/accuraty/accutheme-tw4/blob/main/dnn/DesktopModules/RazorModules/RazorHost/Scripts/AccuTheme-Tw4--Fonts.cshtml"
    click Modules2sxc "https://github.com/accuraty/accutheme-tw4/tree/main/dnn/Portals/0/2sxc/"
    click Skins "https://github.com/accuraty/accutheme-tw4/tree/main/dnn/Portals/_default/Skins/AccuTheme-Tw4/"
    click Menus "https://github.com/accuraty/accutheme-tw4/tree/main/dnn/Portals/_default/Skins/AccuTheme-Tw4/menus/"
    click Containers "https://github.com/accuraty/accutheme-tw4/blob/main/dnn/Portals/_default/Containers/AccuTheme-Tw4/Plain.ascx"

    %% Styles
    classDef buildTools fill:#D0E8FF,stroke:#0366D6
    classDef source fill:#DFFFD0,stroke:#228B22
    classDef runtime fill:#FFE6B3,stroke:#FF8C00
    classDef external fill:#EEEEEE,stroke:#888888
    classDef config fill:#F0D0FF,stroke:#800080
```
