# quirky1869/purple-spells architecture

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

- Interactive diagram: https://gitdiagram.com/quirky1869/purple-spells
- Repository: https://github.com/quirky1869/purple-spells

## Overview

Purple Spells is a locally usable offensive-security cheatsheet and interactive command tool. Users browse its topic tabs, enter target variables, and use generated, substituted commands; supporting workflows include search, favorites, notes, credentials, and tool-install references. The README documents major features not fully visible in the sampled JavaScript, so those branches are represented from that documentation; unsampled implementation details and connections are omitted.

Main entry points: [`purple-spells/Purple-Spells.html`](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/Purple-Spells.html) (Web Interface), [`purple-spells/script.js`](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js) (Credentials Vault)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Cheatsheet"]
  node_topics["Security Topics<br/>[Purple-Spells.html]"]
  node_arraytools["Array Tools<br/>[Purple-Spells.html]"]
end

subgraph group_interaction["Command Interface"]
  node_webapp["Web Interface<br/>[Purple-Spells.html]"]
  node_tabnav["Tab Navigation<br/>[script.js]"]
  node_targetvars["Target Variables<br/>[script.js]"]
  node_substitution["Command Substitution<br/>[script.js]"]
  node_search["Topic Search<br/>[script.js]"]
  node_clipboard["Command Clipboard<br/>[script.js]"]
end

subgraph group_workspace["User Workspace"]
  node_favorites["Favorites<br/>[script.js]"]
  node_notes["Notes Panel<br/>[script.js]"]
  node_vault["Credentials Vault<br/>[script.js]"]
  node_localstorage[("Browser Storage")]
end

subgraph group_generators["Generators"]
  node_hydra["Hydra Generator<br/>[script.js]"]
  node_msfvenom["MSFvenom Generator<br/>[script.js]"]
  node_hashcat["Hashcat Generator<br/>[script.js]"]
  node_revshells["RevShells Embed<br/>[Purple-Spells.html]"]
end

node_user(("Pentester"))
node_revshellservice["RevShells Service"]

node_user -->|"opens"| node_webapp
node_webapp -->|"presents tabs"| node_topics
node_webapp -->|"uses navigation"| node_tabnav
node_user -->|"enters targets"| node_targetvars
node_targetvars -->|"updates commands"| node_substitution
node_user -->|"searches topics"| node_search
node_user -->|"bookmarks topics"| node_favorites
node_favorites -->|"persists"| node_localstorage
node_user -->|"writes notes"| node_notes
node_notes -->|"persists"| node_localstorage
node_user -->|"stores credentials"| node_vault
node_vault -->|"injects credentials"| node_targetvars
node_vault -->|"persists"| node_localstorage
node_user -->|"opens tools"| node_arraytools
node_user -->|"configures command"| node_hydra
node_user -->|"configures payload"| node_msfvenom
node_user -->|"configures cracking"| node_hashcat
node_user -->|"opens embed"| node_revshells
node_revshells -.->|"loads remotely"| node_revshellservice
node_user -->|"copies commands"| node_clipboard

click node_webapp "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/Purple-Spells.html"
click node_topics "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/Purple-Spells.html"
click node_tabnav "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js"
click node_targetvars "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js"
click node_substitution "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js"
click node_search "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js"
click node_favorites "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js"
click node_notes "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js"
click node_vault "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js"
click node_arraytools "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/Purple-Spells.html"
click node_hydra "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js"
click node_msfvenom "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js"
click node_hashcat "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js"
click node_revshells "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/Purple-Spells.html"
click node_clipboard "https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.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_topics,node_arraytools toneBlue
class node_webapp,node_tabnav,node_targetvars,node_substitution,node_search,node_clipboard toneAmber
class node_favorites,node_notes,node_vault,node_localstorage toneMint
class node_hydra,node_msfvenom,node_hashcat,node_revshells toneRose
class node_user,node_revshellservice toneIndigo
```

## Components

### Cheatsheet

- [Security Topics](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/Purple-Spells.html): `purple-spells/Purple-Spells.html`
- [Array Tools](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/Purple-Spells.html): `purple-spells/Purple-Spells.html`

### Command Interface

- [Web Interface](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/Purple-Spells.html): `purple-spells/Purple-Spells.html`
- [Tab Navigation](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`
- [Target Variables](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`
- [Command Substitution](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`
- [Topic Search](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`
- [Command Clipboard](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`

### User Workspace

- [Favorites](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`
- [Notes Panel](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`
- [Credentials Vault](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`
- **Browser Storage**

### Generators

- [Hydra Generator](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`
- [MSFvenom Generator](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`
- [Hashcat Generator](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/script.js): `purple-spells/script.js`
- [RevShells Embed](https://github.com/quirky1869/purple-spells/blob/main/purple-spells/Purple-Spells.html): `purple-spells/Purple-Spells.html`

### Other components

- **Pentester**
- **RevShells Service**

## Connections

- Pentester → Web Interface: opens (evidence: `README.md`)
- Web Interface → Security Topics: presents tabs (evidence: `README.md`)
- Web Interface → Tab Navigation: uses navigation (evidence: `README.md`)
- Pentester → Target Variables: enters targets (evidence: `README.md`)
- Target Variables → Command Substitution: updates commands (evidence: `purple-spells/script.js`)
- Pentester → Topic Search: searches topics (evidence: `README.md`)
- Pentester → Favorites: bookmarks topics (evidence: `README.md`)
- Favorites → Browser Storage: persists (evidence: `README.md`)
- Pentester → Notes Panel: writes notes (evidence: `README.md`)
- Notes Panel → Browser Storage: persists (evidence: `README.md`)
- Pentester → Credentials Vault: stores credentials (evidence: `README.md`)
- Credentials Vault → Target Variables: injects credentials (evidence: `purple-spells/script.js`)
- Credentials Vault → Browser Storage: persists (evidence: `README.md`)
- Pentester → Array Tools: opens tools (evidence: `README.md`)
- Pentester → Hydra Generator: configures command (evidence: `README.md`)
- Pentester → MSFvenom Generator: configures payload (evidence: `README.md`)
- Pentester → Hashcat Generator: configures cracking (evidence: `README.md`)
- Pentester → RevShells Embed: opens embed (evidence: `README.md`)
- RevShells Embed → RevShells Service: loads remotely (evidence: `README.md`)
- Pentester → Command Clipboard: copies commands (evidence: `README.md`)
