# fiascko/zerofiascko architecture

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

- Interactive diagram: https://gitdiagram.com/fiascko/zerofiascko
- Repository: https://github.com/fiascko/zerofiascko

## Overview

ZeroFiascko is an offline, browser-based project manager: users create a project or open a JSON file, work with cards on a five-lane board, and export the project as JSON. Project state is held in browser local storage and can also be imported from or downloaded to user-managed files. The README documents the board, archive, project details, notes, statistics, and offline operation. Edges reflect calls visible in the sampled JavaScript or capabilities documented in the README; unsampled HTML wiring is not inferred.

Main entry points: [`js/dashboard.js`](https://github.com/fiascko/zerofiascko/blob/main/js/dashboard.js) (Dashboard controller), [`js/index.js`](https://github.com/fiascko/zerofiascko/blob/main/js/index.js) (Create and open), [`js/core/project.js`](https://github.com/fiascko/zerofiascko/blob/main/js/core/project.js) (Browser storage), [`index.html`](https://github.com/fiascko/zerofiascko/blob/main/index.html) (Project entry screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Project entry"]
  node_entry["Project entry screen<br/>[index.html]"]
  node_entrylogic["Create and open<br/>[index.js]"]
end

subgraph group_workflow["Board workflow"]
  node_dashboard["Dashboard controller<br/>[dashboard.js]"]
  node_board["Kanban board<br/>[dashboard.js]"]
  node_cardactions["Card actions<br/>[dashboard.js]"]
end

subgraph group_features["Project features"]
  node_projectinfo["Project information<br/>[project-info.js]"]
  node_notes["Project notes<br/>[notes.js]"]
  node_archive["Card archive<br/>[archive.js]"]
  node_statistics["Project statistics<br/>[statistics.js]"]
end

subgraph group_data["Project data"]
  node_projectmodel["Project model<br/>[project.js]"]
  node_validation["Project validation<br/>[validations.js]"]
  node_storage[("Browser storage<br/>[project.js]")]
  node_jsonfiles["JSON file transfer<br/>[project.js]"]
  node_constants["Project and lane definitions<br/>[constants.js]"]
  node_utilities["Project utilities<br/>[utils.js]"]
end

node_user(("Project user"))

node_user -->|"starts in"| node_entry
node_entry -->|"handles actions"| node_entrylogic
node_entrylogic -->|"creates project"| node_projectmodel
node_entrylogic -->|"loads file"| node_jsonfiles
node_entrylogic -->|"saves project"| node_storage
node_entrylogic -->|"opens dashboard"| node_dashboard
node_dashboard -->|"loads project"| node_storage
node_dashboard -->|"renders board"| node_board
node_dashboard -->|"renders details"| node_projectinfo
node_dashboard -->|"renders statistics"| node_statistics
node_dashboard -->|"renders notes"| node_notes
node_dashboard -->|"renders archive"| node_archive
node_board -->|"offers card actions"| node_cardactions
node_cardactions -->|"saves changes"| node_storage
node_projectinfo -->|"saves edits"| node_dashboard
node_notes -->|"saves edits"| node_dashboard
node_archive -->|"saves changes"| node_dashboard
node_dashboard -->|"downloads project"| node_jsonfiles
node_jsonfiles -->|"checks imported data"| node_validation
node_projectmodel -.->|"uses lane definitions"| node_constants
node_utilities -->|"reads saved project"| node_storage

click node_entry "https://github.com/fiascko/zerofiascko/blob/main/index.html"
click node_entrylogic "https://github.com/fiascko/zerofiascko/blob/main/js/index.js"
click node_dashboard "https://github.com/fiascko/zerofiascko/blob/main/js/dashboard.js"
click node_board "https://github.com/fiascko/zerofiascko/blob/main/js/dashboard.js"
click node_cardactions "https://github.com/fiascko/zerofiascko/blob/main/js/dashboard.js"
click node_projectinfo "https://github.com/fiascko/zerofiascko/blob/main/js/features/project-info.js"
click node_notes "https://github.com/fiascko/zerofiascko/blob/main/js/features/notes.js"
click node_archive "https://github.com/fiascko/zerofiascko/blob/main/js/features/archive.js"
click node_statistics "https://github.com/fiascko/zerofiascko/blob/main/js/features/statistics.js"
click node_projectmodel "https://github.com/fiascko/zerofiascko/blob/main/js/core/project.js"
click node_validation "https://github.com/fiascko/zerofiascko/blob/main/js/core/validations.js"
click node_storage "https://github.com/fiascko/zerofiascko/blob/main/js/core/project.js"
click node_jsonfiles "https://github.com/fiascko/zerofiascko/blob/main/js/core/project.js"
click node_constants "https://github.com/fiascko/zerofiascko/blob/main/js/core/constants.js"
click node_utilities "https://github.com/fiascko/zerofiascko/blob/main/js/core/utils.js"

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_entry,node_entrylogic,node_user toneBlue
class node_dashboard,node_board,node_cardactions toneAmber
class node_projectinfo,node_notes,node_archive,node_statistics toneMint
class node_projectmodel,node_validation,node_storage,node_jsonfiles,node_constants,node_utilities toneRose
```

## Components

### Project entry

- [Project entry screen](https://github.com/fiascko/zerofiascko/blob/main/index.html): `index.html`
- [Create and open](https://github.com/fiascko/zerofiascko/blob/main/js/index.js): `js/index.js`

### Board workflow

- [Dashboard controller](https://github.com/fiascko/zerofiascko/blob/main/js/dashboard.js): `js/dashboard.js`
- [Kanban board](https://github.com/fiascko/zerofiascko/blob/main/js/dashboard.js): `js/dashboard.js`
- [Card actions](https://github.com/fiascko/zerofiascko/blob/main/js/dashboard.js): `js/dashboard.js`

### Project features

- [Project information](https://github.com/fiascko/zerofiascko/blob/main/js/features/project-info.js): `js/features/project-info.js`
- [Project notes](https://github.com/fiascko/zerofiascko/blob/main/js/features/notes.js): `js/features/notes.js`
- [Card archive](https://github.com/fiascko/zerofiascko/blob/main/js/features/archive.js): `js/features/archive.js`
- [Project statistics](https://github.com/fiascko/zerofiascko/blob/main/js/features/statistics.js): `js/features/statistics.js`

### Project data

- [Project model](https://github.com/fiascko/zerofiascko/blob/main/js/core/project.js): `js/core/project.js`
- [Project validation](https://github.com/fiascko/zerofiascko/blob/main/js/core/validations.js): `js/core/validations.js`
- [Browser storage](https://github.com/fiascko/zerofiascko/blob/main/js/core/project.js): `js/core/project.js`
- [JSON file transfer](https://github.com/fiascko/zerofiascko/blob/main/js/core/project.js): `js/core/project.js`
- [Project and lane definitions](https://github.com/fiascko/zerofiascko/blob/main/js/core/constants.js): `js/core/constants.js`
- [Project utilities](https://github.com/fiascko/zerofiascko/blob/main/js/core/utils.js): `js/core/utils.js`

### Other components

- **Project user**

## Connections

- Project user → Project entry screen: starts in (evidence: `README.md`)
- Project entry screen → Create and open: handles actions (evidence: `js/index.js`)
- Create and open → Project model: creates project (evidence: `js/index.js`)
- Create and open → JSON file transfer: loads file (evidence: `js/index.js`)
- Create and open → Browser storage: saves project (evidence: `js/index.js`)
- Create and open → Dashboard controller: opens dashboard (evidence: `js/index.js`)
- Dashboard controller → Browser storage: loads project (evidence: `js/dashboard.js`)
- Dashboard controller → Kanban board: renders board (evidence: `js/dashboard.js`)
- Dashboard controller → Project information: renders details (evidence: `js/dashboard.js`)
- Dashboard controller → Project statistics: renders statistics (evidence: `js/dashboard.js`)
- Dashboard controller → Project notes: renders notes (evidence: `js/dashboard.js`)
- Dashboard controller → Card archive: renders archive (evidence: `js/dashboard.js`)
- Kanban board → Card actions: offers card actions (evidence: `js/dashboard.js`)
- Card actions → Browser storage: saves changes (evidence: `js/dashboard.js`)
- Project information → Dashboard controller: saves edits (evidence: `js/features/project-info.js`)
- Project notes → Dashboard controller: saves edits (evidence: `js/features/notes.js`)
- Card archive → Dashboard controller: saves changes (evidence: `js/features/archive.js`)
- Dashboard controller → JSON file transfer: downloads project (evidence: `js/dashboard.js`)
- JSON file transfer → Project validation: checks imported data (evidence: `js/core/project.js`)
- Project model → Project and lane definitions: uses lane definitions
- Project utilities → Browser storage: reads saved project (evidence: `js/core/utils.js`)
