# paperswithcode/ai-deadlines architecture

> Architecture diagram of the GitHub repository paperswithcode/ai-deadlines, 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/paperswithcode/ai-deadlines
- Repository: https://github.com/paperswithcode/ai-deadlines

## Overview

AI Deadlines is a Jekyll site for tracking AI conference deadlines. Visitors browse deadlines and conference dates in a calendar, filter by subject, and can open conference details; the README describes countdown timers and conference records maintained in YAML. The repository also includes a Jekyll data-page generator and an iCalendar layout. The shown source supports the calendar’s data construction, filtering, and navigation; connections for unsampled templates and calendar export are not asserted.

Main entry points: [`_includes/calendar.js`](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/calendar.js) (Calendar data and events), [`_data/types.yml`](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_data/types.yml) (Subject types), [`_includes/multiselect_handler.js`](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/multiselect_handler.js) (Subject filtering), [`_data/conferences.yml`](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_data/conferences.yml) (Conference records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Conference data"]
  node_conference_data[("Conference records<br/>[conferences.yml]")]
  node_subject_data[("Subject types<br/>[types.yml]")]
end

subgraph group_site["Site pages"]
  node_site_home["Deadline listing<br/>[index.html]"]
  node_conference_page["Conference details<br/>[conference.html]"]
  node_page_filter["Listing filters<br/>[utils.js]"]
end

subgraph group_calendar["Calendar experience"]
  node_calendar_page["Calendar page<br/>[calendar.html]"]
  node_calendar_logic["Calendar data and events<br/>[calendar.js]"]
  node_calendar_library["Calendar renderer"]
  node_subject_loader["Subject loader<br/>[load_data.js]"]
  node_subject_filter["Subject filtering"]
  node_filter_state["URL selection restore"]
end

subgraph group_generation["Page generation"]
  node_page_generator["Data page generator"]
  node_ical_layout["iCalendar layout<br/>[calendar.ics]"]
  node_ical_file["Calendar feed<br/>[ai-deadlines.ics]"]
end

node_visitor(("Visitor"))

node_visitor -->|"browses"| node_site_home
node_visitor -->|"views"| node_calendar_page
node_conference_data -->|"templates events"| node_calendar_logic
node_subject_data -->|"sets event colors"| node_calendar_logic
node_calendar_logic -->|"configures"| node_calendar_library
node_calendar_logic -->|"opens details"| node_conference_page
node_subject_data -->|"loads subjects"| node_subject_loader
node_subject_filter -->|"updates filters"| node_calendar_logic
node_filter_state -->|"restores selection"| node_calendar_logic
node_subject_filter -.->|"filters listing"| node_page_filter
node_page_generator -->|"reads records"| node_conference_data
node_visitor -->|"opens conference"| node_conference_page

click node_conference_data "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_data/conferences.yml"
click node_subject_data "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_data/types.yml"
click node_site_home "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/index.html"
click node_conference_page "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_pages/conference.html"
click node_calendar_page "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/calendar.html"
click node_calendar_logic "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/calendar.js"
click node_calendar_library "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/static/js/js-year-calendar.js"
click node_subject_loader "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/load_data.js"
click node_subject_filter "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/multiselect_handler.js"
click node_filter_state "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/handle_url_retrieval.js"
click node_page_filter "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/utils.js"
click node_page_generator "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_plugins/data_page_generator.rb"
click node_ical_layout "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_layouts/calendar.ics"
click node_ical_file "https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/ai-deadlines.ics"

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_conference_data,node_subject_data toneBlue
class node_site_home,node_conference_page,node_page_filter toneAmber
class node_calendar_page,node_calendar_logic,node_calendar_library,node_subject_loader,node_subject_filter,node_filter_state toneMint
class node_page_generator,node_ical_layout,node_ical_file toneRose
class node_visitor toneIndigo
```

## Components

### Conference data

- [Conference records](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_data/conferences.yml): `_data/conferences.yml`
- [Subject types](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_data/types.yml): `_data/types.yml`

### Site pages

- [Deadline listing](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/index.html): `index.html`
- [Conference details](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_pages/conference.html): `_pages/conference.html`
- [Listing filters](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/utils.js): `_includes/utils.js`

### Calendar experience

- [Calendar page](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/calendar.html): `calendar.html`
- [Calendar data and events](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/calendar.js): `_includes/calendar.js`
- [Calendar renderer](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/static/js/js-year-calendar.js): `static/js/js-year-calendar.js`
- [Subject loader](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/load_data.js): `_includes/load_data.js`
- [Subject filtering](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/multiselect_handler.js): `_includes/multiselect_handler.js`
- [URL selection restore](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_includes/handle_url_retrieval.js): `_includes/handle_url_retrieval.js`

### Page generation

- [Data page generator](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_plugins/data_page_generator.rb): `_plugins/data_page_generator.rb`
- [iCalendar layout](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/_layouts/calendar.ics): `_layouts/calendar.ics`
- [Calendar feed](https://github.com/paperswithcode/ai-deadlines/blob/gh-pages/ai-deadlines.ics): `ai-deadlines.ics`

### Other components

- **Visitor**

## Connections

- Visitor → Deadline listing: browses (evidence: `README.md`)
- Visitor → Calendar page: views (evidence: `README.md`)
- Conference records → Calendar data and events: templates events (evidence: `_includes/calendar.js`)
- Subject types → Calendar data and events: sets event colors (evidence: `_includes/calendar.js`)
- Calendar data and events → Calendar renderer: configures (evidence: `_includes/calendar.js`)
- Calendar data and events → Conference details: opens details (evidence: `_includes/calendar.js`)
- Subject types → Subject loader: loads subjects (evidence: `_includes/load_data.js`)
- Subject filtering → Calendar data and events: updates filters (evidence: `_includes/multiselect_handler.js`)
- URL selection restore → Calendar data and events: restores selection (evidence: `_includes/handle_url_retrieval.js`)
- Subject filtering → Listing filters: filters listing
- Data page generator → Conference records: reads records (evidence: `_plugins/data_page_generator.rb`)
- Visitor → Conference details: opens conference
