# emmabostian/developer-portfolios architecture

> Architecture diagram of the GitHub repository emmabostian/developer-portfolios, 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/emmabostian/developer-portfolios
- Repository: https://github.com/emmabostian/developer-portfolios

## Overview

Developer Portfolios is a curated, alphabetized directory of developer portfolio links, with a documented companion website and a generated JSON feed. The main workflow is contributors adding portfolio entries, readers browsing the README or website, and maintainers generating structured feed data or checking and cleaning the list. The repository also includes duplicate reporting and parking-redirect detection. The source excerpts show the feed, cleanup, reporting, and scan behavior; relationships involving the documented website are based only on the README.

Main entry points: [`README.md`](https://github.com/emmabostian/developer-portfolios/blob/master/README.md) (Portfolio list), [`src/alphabetical.py`](https://github.com/emmabostian/developer-portfolios/blob/master/src/alphabetical.py) (List cleanup), [`src/run_dup_report.py`](https://github.com/emmabostian/developer-portfolios/blob/master/src/run_dup_report.py) (Duplicate report), [`src/check_parking_redirects.py`](https://github.com/emmabostian/developer-portfolios/blob/master/src/check_parking_redirects.py) (Parking-link scan)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_directory["Portfolio directory"]
  node_readme["Portfolio list<br/>[README.md]"]
end

subgraph group_maintenance["List maintenance"]
  node_alphabetical["List cleanup<br/>[alphabetical.py]"]
  node_emoji_cleanup["Emoji cleanup"]
  node_duplicate_report["Duplicate report<br/>[run_dup_report.py]"]
  node_parking_check["Parking-link scan"]
end

subgraph group_outputs["Published outputs"]
  node_portfolio_web["Portfolio website"]
  node_feed_generator["Feed generator<br/>[generate_feed.py]"]
  node_feed["JSON feed<br/>[feed.json]"]
end

node_contributors(("Contributors"))
node_readers(("Readers"))
node_portfolio_sites(("Portfolio sites"))
node_external_sites(("External websites"))

node_contributors -->|"submit entries"| node_readme
node_readers -->|"browse list"| node_readme
node_readme -->|"links to"| node_portfolio_sites
node_readers -->|"browse portfolios"| node_portfolio_web
node_readme -->|"presented by"| node_portfolio_web
node_alphabetical -->|"reads and updates"| node_readme
node_emoji_cleanup -->|"uses cleanup"| node_alphabetical
node_duplicate_report -->|"uses URL rules"| node_alphabetical
node_duplicate_report -->|"reads entries"| node_readme
node_parking_check -->|"reads links"| node_readme
node_parking_check -->|"checks URLs"| node_external_sites
node_feed_generator -->|"extracts entries"| node_readme
node_feed_generator -->|"writes feed"| node_feed

click node_readme "https://github.com/emmabostian/developer-portfolios/blob/master/README.md"
click node_alphabetical "https://github.com/emmabostian/developer-portfolios/blob/master/src/alphabetical.py"
click node_emoji_cleanup "https://github.com/emmabostian/developer-portfolios/blob/master/src/remove_emoji_in_readme.py"
click node_duplicate_report "https://github.com/emmabostian/developer-portfolios/blob/master/src/run_dup_report.py"
click node_parking_check "https://github.com/emmabostian/developer-portfolios/blob/master/src/check_parking_redirects.py"
click node_feed_generator "https://github.com/emmabostian/developer-portfolios/blob/master/src/generate_feed.py"
click node_feed "https://github.com/emmabostian/developer-portfolios/blob/master/feed.json"

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_readme toneBlue
class node_alphabetical,node_emoji_cleanup,node_duplicate_report,node_parking_check toneAmber
class node_portfolio_web,node_feed_generator,node_feed toneMint
class node_contributors,node_readers,node_portfolio_sites,node_external_sites toneIndigo
```

## Components

### Portfolio directory

- [Portfolio list](https://github.com/emmabostian/developer-portfolios/blob/master/README.md): `README.md`

### List maintenance

- [List cleanup](https://github.com/emmabostian/developer-portfolios/blob/master/src/alphabetical.py): `src/alphabetical.py`
- [Emoji cleanup](https://github.com/emmabostian/developer-portfolios/blob/master/src/remove_emoji_in_readme.py): `src/remove_emoji_in_readme.py`
- [Duplicate report](https://github.com/emmabostian/developer-portfolios/blob/master/src/run_dup_report.py): `src/run_dup_report.py`
- [Parking-link scan](https://github.com/emmabostian/developer-portfolios/blob/master/src/check_parking_redirects.py): `src/check_parking_redirects.py`

### Published outputs

- **Portfolio website**
- [Feed generator](https://github.com/emmabostian/developer-portfolios/blob/master/src/generate_feed.py): `src/generate_feed.py`
- [JSON feed](https://github.com/emmabostian/developer-portfolios/blob/master/feed.json): `feed.json`

### Other components

- **Contributors**
- **Readers**
- **Portfolio sites**
- **External websites**

## Connections

- Contributors → Portfolio list: submit entries (evidence: `README.md`)
- Readers → Portfolio list: browse list (evidence: `README.md`)
- Portfolio list → Portfolio sites: links to (evidence: `README.md`)
- Readers → Portfolio website: browse portfolios (evidence: `README.md`)
- Portfolio list → Portfolio website: presented by (evidence: `README.md`)
- List cleanup → Portfolio list: reads and updates (evidence: `src/alphabetical.py`)
- Emoji cleanup → List cleanup: uses cleanup (evidence: `src/remove_emoji_in_readme.py`)
- Duplicate report → List cleanup: uses URL rules (evidence: `src/run_dup_report.py`)
- Duplicate report → Portfolio list: reads entries (evidence: `src/run_dup_report.py`)
- Parking-link scan → Portfolio list: reads links (evidence: `src/check_parking_redirects.py`)
- Parking-link scan → External websites: checks URLs (evidence: `src/check_parking_redirects.py`)
- Feed generator → Portfolio list: extracts entries (evidence: `src/generate_feed.py`)
- Feed generator → JSON feed: writes feed (evidence: `src/generate_feed.py`)
