feat: DevSeed branding update and contributor network improvements (#28)

## What's Changed

### Branding
- Updated color scheme to DevSeed brand (Grenadier orange #CF3F02,
Aquamarine blue #2E86AB)
- Switched fonts to Roboto (from Atkinson Hyperlegible)

### New CLI Commands
- `discover`: Find repos where DevSeed employees contribute
- `list-contributors`: Show all configured contributors

### Data Improvements  
- Separated contributors into categories (devseed vs alumni)
- Added 30+ new repos from NASA-IMPACT, MAAP, EOEPCA, WRI, etc.
- Removed the central "DevSeed Team" pseudo-node from rendering

### Bug Fixes
- Fixed hover state getting stuck outside visualization bounds
- Added null safety checks for missing contributors/repos
- Improved hover performance by filtering artificial links

### Documentation
- Complete README rewrite with workflow instructions
- Added inline code documentation

Author: aboydnw

README.md

@@ -1,48 +1,134 @@
-# Development Seed contributor network
+# Development Seed Contributor Network
 
 The code behind <https://developmentseed.org/contributor-network>.
 
 ![A splash of the page](./img/site-image.jpg)
 
-This visual is derived from the excellent <https://github.com/nbremer/ORCA/tree/main/top-contributor-network>.
+This visual is derived from the excellent [ORCA top-contributor-network](https://github.com/nbremer/ORCA/tree/main/top-contributor-network) by Nadieh Bremer.
 
-## Rebuilding
+## Quick Start
 
-We use [workflow dispatch](https://github.com/developmentseed/contributor-network/actions/workflows/build.yml) to rebuild the source data.
-Right now this is manual, but eventually we'd like to set this up on a schedule: <https://github.com/developmentseed/contributor-network/issues/8>.
+### Prerequisites
 
-## Development
+- [uv](https://docs.astral.sh/uv/getting-started/installation/) for Python package management
+- A GitHub personal access token with `public_repo` scope
 
-To view things locally:
+### View Locally
 
 ```shell
-python -m http.server
+cd dist
+python -m http.server 8000
 ```
 
-This will open the page on <http://localhost:8000/>.
+Then open <http://localhost:8000/>.
+
+## CLI Commands
+
+All commands are run via `uv run contributor-network <command>`.
+
+### `list-contributors`
 
-To check the Python files, get [uv](https://docs.astral.sh/uv/getting-started/installation/), then:
+List all configured contributors by category:
 
 ```shell
-uv sync
-uv run ruff check --fix
-uv run ruff format
-uv run pytest
+uv run contributor-network list-contributors
 ```
 
-To add new repos or contributors, see [constants.py](src/devseed_contributor_network/constants.py)
+### `discover`
+
+Find new repositories that DevSeed employees contribute to:
 
-### Rebuilding locally
+```shell
+export GITHUB_TOKEN="your_token_here"
+uv run contributor-network discover --min-contributors 2 --limit 50
+```
 
-To build the data locally, set up [.netrc authentication for Github](https://pygithub.readthedocs.io/en/stable/examples/Authentication.html#netrc-authentication).
-Then:
+This queries GitHub to find repos where multiple DevSeed employees have contributed, which are not yet in the configuration.
+
+### `data`
+
+Fetch contribution data from GitHub for all configured repositories:
 
 ```shell
+export GITHUB_TOKEN="your_token_here"
 uv run contributor-network data data
+```
+
+Options:
+- `--all-contributors`: Include alumni/friends (not just current DevSeed employees)
+
+### `csvs`
+
+Generate CSV files from the fetched JSON data:
+
+```shell
 uv run contributor-network csvs data
+```
+
+### `build`
+
+Build the static site to the `dist/` folder:
+
+```shell
 uv run contributor-network build data dist
 ```
 
+## Full Workflow
+
+To update the visualization with new data:
+
+```shell
+# 1. Set your GitHub token
+export GITHUB_TOKEN="your_token_here"
+
+# 2. (Optional) Discover new repos to add
+uv run contributor-network discover --min-contributors 2
+
+# 3. Edit config.toml to add/remove repos or contributors
+
+# 4. Fetch data from GitHub
+uv run contributor-network data data
+
+# 5. Generate CSVs
+uv run contributor-network csvs data
+
+# 6. Build the site
+uv run contributor-network build data dist
+
+# 7. Preview locally
+cd dist && python -m http.server 8000
+```
+
+## Configuration
+
+Edit `config.toml` to configure:
+
+- **repositories**: List of GitHub repos to track (format: `"owner/repo"`)
+- **contributors.devseed**: Current DevSeed employees (format: `github_username = "Display Name"`)
+- **contributors.alumni**: Friends and alumni (commented out by default)
+
+## Development
+
+### Code Quality
+
+```shell
+uv sync
+uv run ruff check --fix
+uv run ruff format
+uv run pytest
+```
+
+### Automated Rebuilds
+
+We use [workflow dispatch](https://github.com/developmentseed/contributor-network/actions/workflows/build.yml) to rebuild the source data manually.
+
+## Branding
+
+This visualization uses the Development Seed brand colors:
+- **Grenadier** (#CF3F02): Primary orange accent
+- **Aquamarine** (#2E86AB): Secondary blue
+- **Base** (#443F3F): Text color
+
 ## License
 
 This work was copied-and-modified from <https://github.com/nbremer/ORCA> and is licensed under the same (MPL).

config.toml

@@ -1,7 +1,7 @@
 title = "The Development Seed Contributor Network"
 author = "Pete Gadomski"
 description = "An interactive visualization of contributors to Development Seed code and their connections to other repositories"
-central_repository = "Development Seed"
+central_repository = "DevSeed Team"
 repositories = [
     "developmentseed/titiler",
     "developmentseed/lonboard",
@@ -39,34 +39,66 @@ repositories = [
     "OSMCha/osmcha-frontend",
     "hotosm/tasking-manager",
     "hotosm/OpenAerialMap",
+    "developmentseed/openeo-studio",
+    "NASA-IMPACT/veda-backend",
+    "developmentseed/moz-proenergia-backend",
+    "wri/project-zeno-next",
+    "developmentseed/titiler-cmr",
+    "NASA-IMPACT/veda-ui",
+    "developmentseed/async-tiff",
+    "NASA-IMPACT/veda-deploy",
+    "wri/project-zeno-deploy",
+    "eopf-toolkit/eopf-101",
+    "NASA-IMPACT/veda-keycloak",
+    "NASA-IMPACT/veda-data-airflow",
+    "EOPF-Explorer/titiler-eopf",
+    "developmentseed/openeo-udp",
+    "developmentseed/stac-map",
+    "source-cooperative/source.coop",
+    "beatrizbsperes/eopf-101",
+    "NASA-IMPACT/csda-client",
+    "NASA-IMPACT/veda-config",
+    "developmentseed/eo-predictor",
+    "EOPF-Explorer/landing-page",
+    "EOPF-Explorer/narratives",
+    "developmentseed/deck.gl-raster",
+    "MAAP-Project/maap-eoapi",
+    "MAAP-Project/maap-documentation",
+    "EOEPCA/demo",
+    "EOEPCA/resource-discovery",
+    "virtual-zarr/obspec-utils",
+    "developmentseed/geotiff-test-data",
+    "GenericMappingTools/pygmt",
+    "developmentseed/pixelverse",
 ]
 
-[contributors]
-# Friends and alumni
-jsignell = "Julia Signell"
-geospatial-jeff = "Jeff Albrecht"
-cholmes = "Chris Holmes"
-m-mohr = "Matthias Mohr"
-matthewhanson = "Matthew Hanson"
-d-v-b = "Davis Bennett"
+# Friends and alumni - commented out but preserved for future use
+# Uncomment the [contributors.alumni] section to include these contributors
+# [contributors.alumni]
+# jsignell = "Julia Signell"
+# geospatial-jeff = "Jeff Albrecht"
+# cholmes = "Chris Holmes"
+# m-mohr = "Matthias Mohr"
+# matthewhanson = "Matthew Hanson"
+# d-v-b = "Davis Bennett"
 
-# Development Seed
+# Development Seed employees
+[contributors.devseed]
 AMSCamacho = "Angela Camacho"
 AliceR = "Alice Rühl"
 LanesGood = "Lane Goodman"
 abarciauskas-bgse = "Aimee Barciauskas"
 aboydnw = "Anthony Boyd"
-aliziel = "Ali Z."
+aliziel = "Ali Z"
 alukach = "Anthony Lukach"
 anayeaye = "Alexandra Kirk"
-aripaulg = "Ari Greenberg"
 batpad = "Sanjay Bhangar"
 beatrizbsperes = "Beatriz Peres"
 benbovy = "Benoît Bovy"
 bitner = "David Bitner"
 botanical = "Jennifer Tran"
-briannapagan = "Brianna Pagán"
-camillecroft = "camillecroft"
+briannacorremonte = "Brianna Corremonte"
+camillecroft = "Camille Croft"
 ceholden = "Chris Holden"
 chuckwondo = "Chuck Daniels"
 ciaransweet = "Ciaran Sweet"
@@ -98,7 +130,7 @@ olafveerman = "Olaf Veerman"
 omniajoe = "Omnia Joehar"
 pantierra = "xıʃǝɟ"
 ricardoduplos = "Ricardo Duplos"
-sandrahoang686 = "sandrahoang686"
+sandrahoang686 = "Sandra Hoang"
 sharkinsspatial = "Sean Harkins"
 sharonwanlu = "SharonLu"
 smohiudd = "Saadiq Mohiuddin"

css/style.css

@@ -3,18 +3,19 @@
 /*************************************/
 
 html {
-    --color-repo-main: #a682e8;
-    --color-repo: #64d6d3;
-    --color-owner: #f2a900;
-    --color-contributor: #ea9df5;
-    --color-text: #4d4950;
+    /* DevSeed Brand Colors */
+    --color-repo-main: #CF3F02;      /* Grenadier (signature orange) */
+    --color-repo: #2E86AB;           /* Aquamarine (secondary blue) */
+    --color-owner: #CF3F02;          /* Grenadier */
+    --color-contributor: #3A9BBF;    /* Lighter aquamarine for contributors */
+    --color-text: #443F3F;           /* Base dark gray */
     --color-background: #f7f7f7;
-    --color-gradient: linear-gradient(to right, var(--color-contributor), var(--color-repo-main), var(--color-repo)) 1;
+    --color-gradient: linear-gradient(to right, var(--color-repo), var(--color-repo-main)) 1;
 }
 
 body {
     margin: 0;
-    font-family: 'Atkinson Hyperlegible', sans-serif;
+    font-family: 'Roboto', 'Antarctica', sans-serif;
 }
 
 .central-repo {
@@ -92,14 +93,14 @@ p {
 
 .code {
     font-family: 'Fira Code', monospace;
-    background-color: #64d6d375;
+    background-color: #2E86AB30;    /* Aquamarine at ~20% opacity */
     font-size: 0.9em;
     padding: 0.2em 0.4em;
 }
 
 a {
     border-bottom: 3px solid var(--color-repo);
-    border-image: linear-gradient(to right, var(--color-repo), var(--color-contributor)) 1;
+    border-image: linear-gradient(to right, var(--color-repo), var(--color-repo-main)) 1;
     /* padding: 0.1em 0.3em; */
     font-weight: 700;
     cursor: pointer;
@@ -173,8 +174,7 @@ a {
 
 #explanation-link {
     border-bottom: 2px solid var(--color-repo-main);
-    border-image: linear-gradient(to right, var(--color-owner), var(--color-contributor), var(--color-repo)) 1;
-    /* border-image: var(--color-gradient); */
+    border-image: linear-gradient(to right, var(--color-repo-main), var(--color-repo)) 1;
     font-size: 0.9em;
     font-style: italic;
     color: var(--color-text);
@@ -267,7 +267,7 @@ li#item-remaining::before {
     font-size: 0.9em;
 
     border: 3px solid var(--color-repo);
-    border-image: linear-gradient(to right, var(--color-owner), var(--color-contributor), var(--color-repo)) 1;
+    border-image: linear-gradient(to right, var(--color-repo-main), var(--color-repo)) 1;
     padding: 0.8em 1.2em;
     margin-top: 0.5em;
     margin-bottom: 1.5em;
@@ -350,7 +350,7 @@ li#item-remaining::before {
 
 #dataviz-credit a {
     border-bottom: 3px solid var(--color-repo-main);
-    border-image: linear-gradient(to right, var(--color-contributor), var(--color-repo)) 1;
+    border-image: linear-gradient(to right, var(--color-repo), var(--color-repo-main)) 1;
     /* padding: 0.1em 0.3em; */
     font-weight: 700;
     cursor: pointer;