# pixelbite-css/dist architecture

> Architecture diagram of the GitHub repository pixelbite-css/dist, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pixelbite-css/dist
- Repository: https://github.com/pixelbite-css/dist

## Overview

#### Purpose and Consumption Model
This is a distribution repository for PixelbiteCSS: versioned, prebuilt CSS and JavaScript assets intended for direct inclusion in browser projects. It contains no application source, build pipeline, server, or package manifest. Consumers load assets from GitHub-backed jsDelivr URLs described in `README.md`.

#### Public Entry Points
Each release exposes two browser assets:
- Stylesheet: `v/1.6/pixelbite.css`
- JavaScript companion: `v/1.6/pixelbite.js`

Earlier stable release entry points follow the same contract, including `v/1.5.2/pixelbite.css`, `v/1.5.2/pixelbite.js`, `v/1.4.2/pixelbite.css`, and `v/1.4.2/pixelbite.js`. The version directory is therefore the primary public API boundary.

#### Release Artifact Layout
The `v/` tree is an immutable-style release catalog. Every version directory packages matching CSS and JS artifacts together:
- `v/1.4.2/`
- `v/1.5/`
- `v/1.5.2/`
- `v/1.6/`

Consumers should pin a version in CDN URLs rather than relying on a root/latest asset, since no unversioned production `pixelbite.css` or `pixelbite.js` exists at repository root.

#### Runtime Boundary
Assets run entirely in the consumer’s browser:
- CSS is loaded through a `<link>` tag and supplies Pixelbite styling.
- JavaScript is loaded through a `<script>` tag and supplies associated client-side behavior.

The repository itself has no backend runtime, deployment service, database, or API. Its external delivery dependency is jsDelivr, which resolves GitHub repository paths such as `.../dist/v/{version}/pixelbite.css`.

#### Experimental Channel
`experimental/` is a separate, unversioned distribution channel:
- `experimental/pixelbite.css`
- `experimental/pixelbite.js`

It likely represents preview or non-stable artifacts and should be treated as outside the stable versioned compatibility contract. Consumers needing reproducibility should use files under `v/`.

#### Release Metadata and History
Release-oriented documentation is separated from delivered browser assets:
- `changelog/README.md`
- `changelog/versions.json`

`changelog/versions.json` is the likely machine-readable version index for release/history consumers, while the artifact directories remain the authoritative locations for actual downloadable files.

#### Legal Boundary
Usage and redistribution are governed by `LICENSE`. The README explicitly requires consumers to review and accept its terms before cloning or using distributed assets.

Main entry points: [`v/1.6/pixelbite.css`](https://github.com/pixelbite-css/dist/blob/main/v/1.6/pixelbite.css) (pixelbite.css), [`v/1.6/pixelbite.js`](https://github.com/pixelbite-css/dist/blob/main/v/1.6/pixelbite.js) (pixelbite.js), [`README.md`](https://github.com/pixelbite-css/dist/blob/main/README.md) (README), [`experimental/pixelbite.css`](https://github.com/pixelbite-css/dist/blob/main/experimental/pixelbite.css) (pixelbite.css)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_stable["Stable releases"]
  node_stable_catalog["v/ release catalog<br/>versioned distribution"]
  node_v142["v1.4.2<br/>release directory"]
  node_v15["v1.5<br/>release directory"]
  node_v152["v1.5.2<br/>release directory"]
  node_v16["v1.6<br/>release directory"]
  node_v16_css["pixelbite.css<br/>stylesheet artifact<br/>[pixelbite.css]"]
  node_v16_js["pixelbite.js<br/>JavaScript artifact<br/>[pixelbite.js]"]
end

subgraph group_experimental["Experimental channel"]
  node_experimental_channel["experimental/<br/>preview distribution"]
  node_experimental_css["pixelbite.css<br/>stylesheet artifact<br/>[pixelbite.css]"]
  node_experimental_js["pixelbite.js<br/>JavaScript artifact<br/>[pixelbite.js]"]
end

subgraph group_metadata["Release metadata"]
  node_changelog_readme["Changelog README<br/>release documentation<br/>[README.md]"]
  node_version_index["versions.json<br/>version index<br/>[versions.json]"]
end

node_readme["README<br/>consumer guide<br/>[README.md]"]
node_license["LICENSE<br/>legal terms"]
node_jsdelivr{{"jsDelivr<br/>CDN delivery"}}
node_browser(("Consumer browser<br/>runtime"))

node_readme -->|"documents CDN URLs"| node_jsdelivr
node_readme -->|"requires acceptance"| node_license
node_stable_catalog -->|"contains"| node_v142
node_stable_catalog -->|"contains"| node_v15
node_stable_catalog -->|"contains"| node_v152
node_stable_catalog -->|"contains"| node_v16
node_v16 -->|"packages"| node_v16_css
node_v16 -->|"packages"| node_v16_js
node_experimental_channel -->|"contains"| node_experimental_css
node_experimental_channel -->|"contains"| node_experimental_js
node_version_index -.->|"indexes release history"| node_stable_catalog
node_changelog_readme -->|"documents"| node_version_index
node_jsdelivr -->|"resolves pinned path"| node_v16_css
node_jsdelivr -->|"resolves pinned path"| node_v16_js
node_v16_css -->|"loaded by link"| node_browser
node_v16_js -->|"loaded by script"| node_browser
node_experimental_css -.->|"loads preview styling"| node_browser
node_experimental_js -.->|"loads preview behavior"| node_browser

click node_readme "https://github.com/pixelbite-css/dist/blob/main/README.md"
click node_v16_css "https://github.com/pixelbite-css/dist/blob/main/v/1.6/pixelbite.css"
click node_v16_js "https://github.com/pixelbite-css/dist/blob/main/v/1.6/pixelbite.js"
click node_experimental_css "https://github.com/pixelbite-css/dist/blob/main/experimental/pixelbite.css"
click node_experimental_js "https://github.com/pixelbite-css/dist/blob/main/experimental/pixelbite.js"
click node_changelog_readme "https://github.com/pixelbite-css/dist/blob/main/changelog/README.md"
click node_version_index "https://github.com/pixelbite-css/dist/blob/main/changelog/versions.json"
click node_license "https://github.com/pixelbite-css/dist/blob/main/LICENSE"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_stable_catalog,node_v142,node_v15,node_v152,node_v16,node_v16_css,node_v16_js toneBlue
class node_experimental_channel,node_experimental_css,node_experimental_js toneAmber
class node_changelog_readme,node_version_index toneMint
class node_readme,node_license,node_jsdelivr,node_browser toneNeutral
```

## Components

### Stable releases

Versioned browser assets form the supported distribution contract.

- **v/ release catalog**: versioned distribution · Primary public API boundary for pinned releases.
- **v1.4.2**: release directory
- **v1.5**: release directory
- **v1.5.2**: release directory
- **v1.6**: release directory · Current documented release.
- [pixelbite.css](https://github.com/pixelbite-css/dist/blob/main/v/1.6/pixelbite.css): stylesheet artifact · Browser styling entry point. · `v/1.6/pixelbite.css`
- [pixelbite.js](https://github.com/pixelbite-css/dist/blob/main/v/1.6/pixelbite.js): JavaScript artifact · Browser behavior entry point. · `v/1.6/pixelbite.js`

### Experimental channel

Unversioned preview artifacts outside the stable compatibility contract.

- **experimental/**: preview distribution · Unversioned artifacts for non-stable use.
- [pixelbite.css](https://github.com/pixelbite-css/dist/blob/main/experimental/pixelbite.css): stylesheet artifact · `experimental/pixelbite.css`
- [pixelbite.js](https://github.com/pixelbite-css/dist/blob/main/experimental/pixelbite.js): JavaScript artifact · `experimental/pixelbite.js`

### Release metadata

Documentation and history are separate from delivered assets.

- [Changelog README](https://github.com/pixelbite-css/dist/blob/main/changelog/README.md): release documentation · `changelog/README.md`
- [versions.json](https://github.com/pixelbite-css/dist/blob/main/changelog/versions.json): version index · Machine-readable release history index. · `changelog/versions.json`

### Other components

- [README](https://github.com/pixelbite-css/dist/blob/main/README.md): consumer guide · Documents jsDelivr inclusion URLs and license acceptance. · `README.md`
- [LICENSE](https://github.com/pixelbite-css/dist/blob/main/LICENSE): legal terms · Governs use and redistribution. · `LICENSE`
- **jsDelivr**: CDN delivery · Resolves GitHub-backed paths for consumers.
- **Consumer browser**: runtime · Loads CSS via link and JavaScript via script.

## Connections

- README → jsDelivr: documents CDN URLs
- README → LICENSE: requires acceptance
- v/ release catalog → v1.4.2: contains
- v/ release catalog → v1.5: contains
- v/ release catalog → v1.5.2: contains
- v/ release catalog → v1.6: contains
- v1.6 → pixelbite.css: packages
- v1.6 → pixelbite.js: packages
- experimental/ → pixelbite.css: contains
- experimental/ → pixelbite.js: contains
- versions.json → v/ release catalog: indexes release history
- Changelog README → versions.json: documents
- jsDelivr → pixelbite.css: resolves pinned path
- jsDelivr → pixelbite.js: resolves pinned path
- pixelbite.css → Consumer browser: loaded by link
- pixelbite.js → Consumer browser: loaded by script
- pixelbite.css → Consumer browser: loads preview styling
- pixelbite.js → Consumer browser: loads preview behavior
