# redward42/fauxllowers architecture

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

- Interactive diagram: https://gitdiagram.com/redward42/fauxllowers
- Repository: https://github.com/redward42/fauxllowers

## Overview

Fauxllowers is a browser-only tool for finding Instagram accounts the user follows that do not follow them back. The user supplies downloaded follower and following JSON files; the app reads them locally, compares account names, and displays a count and checklist. Checking an account marks it visually as handled, but does not unfollow it. The README documents the workflow; implementation details and relationships below are limited to the sampled `index.js`.

Main entry points: [`index.js`](https://github.com/RedWARd42/fauxllowers/blob/master/index.js) (JSON file loading), [`index.html`](https://github.com/RedWARd42/fauxllowers/blob/master/index.html) (App page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Browser interface"]
  node_app_page["App page<br/>[index.html]"]
end

subgraph group_processing["Local analysis"]
  node_file_loading["JSON file loading<br/>[index.js]"]
  node_name_comparison["Name comparison<br/>[index.js]"]
end

subgraph group_results["Review results"]
  node_results_list["Count and list<br/>[index.js]"]
  node_checklist["Review checklist<br/>[index.js]"]
end

node_user(("User"))
node_instagram_export["Instagram export files"]

node_user -->|"opens"| node_app_page
node_user -->|"uploads files"| node_file_loading
node_instagram_export -->|"provides JSON"| node_file_loading
node_app_page -->|"uses logic"| node_file_loading
node_file_loading -->|"sets data"| node_name_comparison
node_user -->|"clicks Analyze"| node_name_comparison
node_name_comparison -->|"renders matches"| node_results_list
node_user -->|"checks accounts"| node_checklist
node_checklist -->|"marks visually"| node_results_list

click node_app_page "https://github.com/RedWARd42/fauxllowers/blob/master/index.html"
click node_file_loading "https://github.com/RedWARd42/fauxllowers/blob/master/index.js"
click node_name_comparison "https://github.com/RedWARd42/fauxllowers/blob/master/index.js"
click node_results_list "https://github.com/RedWARd42/fauxllowers/blob/master/index.js"
click node_checklist "https://github.com/RedWARd42/fauxllowers/blob/master/index.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_app_page,node_user toneBlue
class node_file_loading,node_name_comparison toneAmber
class node_results_list,node_checklist toneMint
class node_instagram_export toneIndigo
```

## Components

### Browser interface

- [App page](https://github.com/RedWARd42/fauxllowers/blob/master/index.html): `index.html`

### Local analysis

- [JSON file loading](https://github.com/RedWARd42/fauxllowers/blob/master/index.js): `index.js`
- [Name comparison](https://github.com/RedWARd42/fauxllowers/blob/master/index.js): `index.js`

### Review results

- [Count and list](https://github.com/RedWARd42/fauxllowers/blob/master/index.js): `index.js`
- [Review checklist](https://github.com/RedWARd42/fauxllowers/blob/master/index.js): `index.js`

### Other components

- **User**
- **Instagram export files**

## Connections

- User → App page: opens (evidence: `README.md`)
- User → JSON file loading: uploads files (evidence: `index.js`)
- Instagram export files → JSON file loading: provides JSON (evidence: `README.md`)
- App page → JSON file loading: uses logic (evidence: `README.md`)
- JSON file loading → Name comparison: sets data (evidence: `index.js`)
- User → Name comparison: clicks Analyze (evidence: `index.js`)
- Name comparison → Count and list: renders matches (evidence: `index.js`)
- User → Review checklist: checks accounts (evidence: `index.js`)
- Review checklist → Count and list: marks visually (evidence: `index.js`)
