# nathansmith/960-grid-system architecture

> Architecture diagram of the GitHub repository nathansmith/960-grid-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nathansmith/960-grid-system
- Repository: https://github.com/nathansmith/960-grid-system

## Overview

##### Project type and purpose
- This is not a “running” web application but a front-end design toolkit—specifically a CSS grid framework (the “960 Grid System”) with accompanying assets (sketch sheets, design-tool templates, editor plugins, demos).
- Its purpose is to provide a 12/16/24-column grid, a reset and text stylesheet, plus ready-to-use templates and plugins to streamline web-page layout prototyping.

##### File structure
- Top-level folders:
- code/
– css/ (core grid and helper .css files)
– css/min/ (minified versions)
– demo*.html (sample pages showing the grid in action)
– img/ (any demo images)
- app_plugins/ (design‐tool extensions for Fireworks, Photoshop)
- templates/ (grid templates for dozens of design packages: Acorn, GIMP, Illustrator, etc.)
- sketch_sheets/ (PDFs for printed sketching)
- logo_files/, licenses/ (assets and legal docs)
- There is no server backend, no database, no build script: it’s purely static assets organized by function.

##### README for additional insights
- Confirms the toolkit nature of the project.
- Explains installation of design-tool plugins.
- Shows how to include CSS in an HTML file and how to switch to RTL styles.
- Mentions MIT/GPL dual licensing.

a. Main components
1. Core CSS Library
- reset.css, text.css, 960.css (12/16/24-col), plus RTL variants
- Minified folder mirrors these files
2. Demo Harness
- HTML demo pages that load the CSS to illustrate usage
3. Design-Tool Integration
- /app_plugins for Fireworks & Photoshop extensions
4. Template Repository
- /templates containing per-tool grid files (Acorn, Illustrator, InDesign, QuarkXPress, GIMP, OmniGraffle…)
5. Sketch Sheets
- Printable PDF layouts
6. Supporting Assets
- /logo_files, /licenses
b. Relationships and interactions
- Demo HTML “consumes” the CSS files and images.
- Designers “consume” templates and plugin packages in their respective tools.
- CSS files form the heart—everything else orbits around illustrating or packaging the grid.
c. Architectural patterns/design principles
- Separation of concerns:
- Core CSS vs. minified build vs. demo
- Grid core vs. reset vs. typography
- Designer integration vs. developer integration
- Extensibility: plug-in model for design tools, file per tool type in templates.
- Simplicity: no runtime code, purely static distribution.
d. Key technologies
- CSS (grid system, reset, text)
- HTML (demos)
- MXP installer (Fireworks plugin)
- Various design formats (.psd, .ai, .xcf, .idml, .qxp, etc.)

##### Detail level
- Grouping (folders) and file relationships.
- Optional flows (e.g., RTL path only if `dir="rtl"` is set).

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "960 Grid System"
        direction TB

        subgraph "Core CSS Library"
            direction TB
            reset["reset.css"]:::core
            reset_rtl["reset_rtl.css"]:::core
            text["text.css"]:::core
            text_rtl["text_rtl.css"]:::core
            g960["960.css"]:::core
            g960_rtl["960_rtl.css"]:::core
            g12["960_12_col.css"]:::core
            g12_rtl["960_12_col_rtl.css"]:::core
            g16["960_16_col.css"]:::core
            g16_rtl["960_16_col_rtl.css"]:::core
            g24["960_24_col.css"]:::core
            g24_rtl["960_24_col_rtl.css"]:::core
            subgraph "Minified CSS"
                direction TB
                min_css["code/css/min/"]:::core
            end
        end

        subgraph "Demo Harness"
            direction TB
            demo["demo.html"]:::core
            demo_rtl["demo_rtl.html"]:::core
            demo24["demo_24_col.html"]:::core
            demo24_rtl["demo_24_col_rtl.html"]:::core
            imgs["img/"]:::core
        end

        subgraph "Design-Tool Plugins"
            direction TB
            subgraph "Fireworks Plugin"
                fw_mxp["960.gs Grid Commands.mxp"]:::designer
                fw_install["INSTALL.txt"]:::designer
                fw_src["_source/"]:::designer
            end
            subgraph "Photoshop Plugin"
                ps_action["960_GRIDS.atn"]:::designer
                ps_install["INSTALL.txt"]:::designer
            end
        end

        subgraph "Design Templates"
            direction TB
            acorn["acorn/"]:::designer
            affinity["affinity_designer/"]:::designer
            balsamiq["balsamiq/"]:::designer
            corel["corel_draw/"]:::designer
            expr["expression_design/"]:::designer
            fw_tpl["fireworks/"]:::designer
            flash["flash/"]:::designer
            gimp["gimp/"]:::designer
            illustrator["illustrator/"]:::designer
            indesign["indesign/"]:::designer
            inkscape["inkscape/"]:::designer
            omni["omnigraffle/"]:::designer
            photoshop_tpl["photoshop/"]:::designer
            pixelmator["pixelmator/"]:::designer
            quark["quarkxpress/"]:::designer
            visio["visio/"]:::designer
            xara["xara/"]:::designer
        end

        subgraph "Sketch Sheets"
            direction TB
            sheet12["960_sketch_12_col.pdf"]:::designer
            sheet16["960_sketch_16_col.pdf"]:::designer
            sheet24["960_sketch_24_col.pdf"]:::designer
            sheetall["960_sketch_all.pdf"]:::designer
        end

        subgraph "Supporting Assets"
            direction TB
            logos["logo_files/"]:::support
            licenses["licenses/"]:::support
        end
    end

    CoreCSS["Developer Projects"]:::external
    DesignApps["Design Applications"]:::external

    %% Relationships
    g960 -->|"included in"| demo
    reset --> demo
    text --> demo
    g960 --> CoreCSS
    reset --> CoreCSS
    text --> CoreCSS

    fw_mxp -->|"installs to"| DesignApps
    ps_action --> DesignApps
    acorn --> DesignApps
    illustrator --> DesignApps
    indesign --> DesignApps
    gimp --> DesignApps
    omnigraffle --> DesignApps
    quark --> DesignApps

    sheet12 -->|"printable for"| DesignApps

    %% Click Events
    click reset "https://github.com/nathansmith/960-grid-system/blob/master/code/css/reset.css"
    click reset_rtl "https://github.com/nathansmith/960-grid-system/blob/master/code/css/reset_rtl.css"
    click text "https://github.com/nathansmith/960-grid-system/blob/master/code/css/text.css"
    click text_rtl "https://github.com/nathansmith/960-grid-system/blob/master/code/css/text_rtl.css"
    click g960 "https://github.com/nathansmith/960-grid-system/blob/master/code/css/960.css"
    click g960_rtl "https://github.com/nathansmith/960-grid-system/blob/master/code/css/960_rtl.css"
    click g12 "https://github.com/nathansmith/960-grid-system/blob/master/code/css/960_12_col.css"
    click g12_rtl "https://github.com/nathansmith/960-grid-system/blob/master/code/css/960_12_col_rtl.css"
    click g16 "https://github.com/nathansmith/960-grid-system/blob/master/code/css/960_16_col.css"
    click g16_rtl "https://github.com/nathansmith/960-grid-system/blob/master/code/css/960_16_col_rtl.css"
    click g24 "https://github.com/nathansmith/960-grid-system/blob/master/code/css/960_24_col.css"
    click g24_rtl "https://github.com/nathansmith/960-grid-system/blob/master/code/css/960_24_col_rtl.css"
    click min_css "https://github.com/nathansmith/960-grid-system/tree/master/code/css/min/"

    click demo "https://github.com/nathansmith/960-grid-system/blob/master/code/demo.html"
    click demo_rtl "https://github.com/nathansmith/960-grid-system/blob/master/code/demo_rtl.html"
    click demo24 "https://github.com/nathansmith/960-grid-system/blob/master/code/demo_24_col.html"
    click demo24_rtl "https://github.com/nathansmith/960-grid-system/blob/master/code/demo_24_col_rtl.html"
    click imgs "https://github.com/nathansmith/960-grid-system/tree/master/code/img/"

    click fw_mxp "https://github.com/nathansmith/960-grid-system/blob/master/app_plugins/fireworks/960.gs Grid Commands.mxp"
    click fw_install "https://github.com/nathansmith/960-grid-system/blob/master/app_plugins/fireworks/INSTALL.txt"
    click fw_src "https://github.com/nathansmith/960-grid-system/tree/master/app_plugins/fireworks/_source/"
    click ps_action "https://github.com/nathansmith/960-grid-system/blob/master/app_plugins/photoshop/960_GRIDS.atn"
    click ps_install "https://github.com/nathansmith/960-grid-system/blob/master/app_plugins/photoshop/INSTALL.txt"

    click acorn "https://github.com/nathansmith/960-grid-system/tree/master/templates/acorn/"
    click affinity "https://github.com/nathansmith/960-grid-system/tree/master/templates/affinity_designer/"
    click balsamiq "https://github.com/nathansmith/960-grid-system/tree/master/templates/balsamiq/"
    click corel "https://github.com/nathansmith/960-grid-system/tree/master/templates/corel_draw/"
    click expr "https://github.com/nathansmith/960-grid-system/tree/master/templates/expression_design/"
    click fw_tpl "https://github.com/nathansmith/960-grid-system/tree/master/templates/fireworks/"
    click flash "https://github.com/nathansmith/960-grid-system/tree/master/templates/flash/"
    click gimp "https://github.com/nathansmith/960-grid-system/tree/master/templates/gimp/"
    click illustrator "https://github.com/nathansmith/960-grid-system/tree/master/templates/illustrator/"
    click indesign "https://github.com/nathansmith/960-grid-system/tree/master/templates/indesign/"
    click inkscape "https://github.com/nathansmith/960-grid-system/tree/master/templates/inkscape/"
    click omni "https://github.com/nathansmith/960-grid-system/tree/master/templates/omnigraffle/"
    click photoshop_tpl "https://github.com/nathansmith/960-grid-system/tree/master/templates/photoshop/"
    click pixelmator "https://github.com/nathansmith/960-grid-system/tree/master/templates/pixelmator/"
    click quark "https://github.com/nathansmith/960-grid-system/tree/master/templates/quarkxpress/"
    click visio "https://github.com/nathansmith/960-grid-system/tree/master/templates/visio/"
    click xara "https://github.com/nathansmith/960-grid-system/tree/master/templates/xara/"

    click sheet12 "https://github.com/nathansmith/960-grid-system/blob/master/sketch_sheets/960_sketch_12_col.pdf"
    click sheet16 "https://github.com/nathansmith/960-grid-system/blob/master/sketch_sheets/960_sketch_16_col.pdf"
    click sheet24 "https://github.com/nathansmith/960-grid-system/blob/master/sketch_sheets/960_sketch_24_col.pdf"
    click sheetall "https://github.com/nathansmith/960-grid-system/blob/master/sketch_sheets/960_sketch_all.pdf"

    click logos "https://github.com/nathansmith/960-grid-system/tree/master/logo_files/"
    click licenses "https://github.com/nathansmith/960-grid-system/tree/master/licenses/"

    %% Styles
    classDef core fill:#FFF8B0,stroke:#E0C040
    classDef designer fill:#B0D4FF,stroke:#4090E0
    classDef support fill:#E0E0E0,stroke:#A0A0A0
    classDef external fill:#FFFFFF,stroke:#000000,stroke-dasharray: 5 5
```
