# remoteintech/remote-jobs architecture

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

- Interactive diagram: https://gitdiagram.com/remoteintech/remote-jobs
- Repository: https://github.com/remoteintech/remote-jobs

## Overview

Remote In Tech is a community-maintained directory of remote-friendly technology companies, published as a static website. A visitor browses company profiles and grouped listings; the site also publishes blog content, tags, and feeds. Company and blog Markdown are organized into Eleventy collections, then rendered through layouts and shared templates into pages. The graph includes documented features and major source-index modules; some template-to-collection wiring is inferred from the site structure and is marked unverified because those templates were not excerpted.

Main entry points: [`src/_config/collections.js`](https://github.com/remoteintech/remote-jobs/blob/main/src/_config/collections.js) (Content Collections), [`src/_layouts`](https://github.com/remoteintech/remote-jobs/tree/main/src/_layouts) (Page Layouts), [`eleventy.config.js`](https://github.com/remoteintech/remote-jobs/blob/main/eleventy.config.js) (Site Configuration), [`src/companies`](https://github.com/remoteintech/remote-jobs/tree/main/src/companies) (Directory Views)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Site Content"]
  node_company_content["Company Profiles"]
  node_blog_content["Blog Posts"]
end

subgraph group_domain["Directory Data"]
  node_company_metadata["Company Metadata"]
  node_company_helpers["Company Labels<br/>[companyHelpers.js]"]
  node_labels["Browse Labels<br/>[labels.js]"]
  node_site_metadata["Site Metadata<br/>[meta.js]"]
end

subgraph group_generation["Eleventy Generation"]
  node_collections["Content Collections<br/>[collections.js]"]
  node_site_config["Site Configuration<br/>[eleventy.config.js]"]
  node_markdown["Markdown Processing<br/>[markdown.js]"]
  node_filters["Template Filters<br/>[filters.js]"]
  node_shortcodes["Image Shortcode<br/>[image.js]"]
end

subgraph group_experience["Site Experience"]
  node_page_layouts["Page Layouts"]
  node_shared_templates["Shared Templates"]
  node_directory_views["Directory Views"]
  node_blog_views["Blog Views"]
  node_tag_views["Tag Browsing<br/>[tags.njk]"]
  node_feeds["Content Feeds"]
end

node_visitor(("Visitor"))
node_published_site["Generated Website"]

node_visitor -.->|"browses directory"| node_directory_views
node_company_content -->|"feeds company lists"| node_collections
node_blog_content -->|"feeds post lists"| node_collections
node_company_helpers -->|"supplies labels"| node_collections
node_company_content -.->|"uses metadata"| node_company_metadata
node_labels -->|"defines labels"| node_company_helpers
node_site_config -->|"registers collections"| node_collections
node_site_config -->|"sets Markdown"| node_markdown
node_site_config -->|"registers filters"| node_filters
node_site_config -->|"registers shortcode"| node_shortcodes
node_collections -.->|"supplies listings"| node_directory_views
node_collections -.->|"supplies tag data"| node_tag_views
node_collections -.->|"supplies posts"| node_blog_views
node_directory_views -.->|"renders through"| node_page_layouts
node_blog_views -.->|"renders through"| node_page_layouts
node_tag_views -.->|"renders through"| node_page_layouts
node_shared_templates -.->|"supports rendering"| node_page_layouts
node_site_metadata -.->|"provides site data"| node_shared_templates
node_blog_content -.->|"supplies feed content"| node_feeds
node_page_layouts -.->|"renders pages"| node_published_site
node_visitor -->|"reads published site"| node_published_site

click node_company_content "https://github.com/remoteintech/remote-jobs/tree/main/src/companies"
click node_blog_content "https://github.com/remoteintech/remote-jobs/tree/main/src/blog"
click node_company_metadata "https://github.com/remoteintech/remote-jobs/blob/main/src/companies/companies.11tydata.js"
click node_company_helpers "https://github.com/remoteintech/remote-jobs/blob/main/src/_data/companyHelpers.js"
click node_labels "https://github.com/remoteintech/remote-jobs/blob/main/src/_data/labels.js"
click node_collections "https://github.com/remoteintech/remote-jobs/blob/main/src/_config/collections.js"
click node_site_config "https://github.com/remoteintech/remote-jobs/blob/main/eleventy.config.js"
click node_markdown "https://github.com/remoteintech/remote-jobs/blob/main/src/_config/plugins/markdown.js"
click node_filters "https://github.com/remoteintech/remote-jobs/blob/main/src/_config/filters.js"
click node_shortcodes "https://github.com/remoteintech/remote-jobs/blob/main/src/_config/shortcodes/image.js"
click node_page_layouts "https://github.com/remoteintech/remote-jobs/tree/main/src/_layouts"
click node_shared_templates "https://github.com/remoteintech/remote-jobs/tree/main/src/_includes"
click node_directory_views "https://github.com/remoteintech/remote-jobs/tree/main/src/companies"
click node_blog_views "https://github.com/remoteintech/remote-jobs/tree/main/src/blog"
click node_tag_views "https://github.com/remoteintech/remote-jobs/blob/main/src/common/tags.njk"
click node_feeds "https://github.com/remoteintech/remote-jobs/tree/main/src/common"
click node_site_metadata "https://github.com/remoteintech/remote-jobs/blob/main/src/_data/meta.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_company_content,node_blog_content toneBlue
class node_company_metadata,node_company_helpers,node_labels,node_site_metadata toneAmber
class node_collections,node_site_config,node_markdown,node_filters,node_shortcodes toneMint
class node_page_layouts,node_shared_templates,node_directory_views,node_blog_views,node_tag_views,node_feeds toneRose
class node_visitor,node_published_site toneIndigo
```

## Components

### Site Content

- [Company Profiles](https://github.com/remoteintech/remote-jobs/tree/main/src/companies): `src/companies`
- [Blog Posts](https://github.com/remoteintech/remote-jobs/tree/main/src/blog): `src/blog`

### Directory Data

- [Company Metadata](https://github.com/remoteintech/remote-jobs/blob/main/src/companies/companies.11tydata.js): `src/companies/companies.11tydata.js`
- [Company Labels](https://github.com/remoteintech/remote-jobs/blob/main/src/_data/companyHelpers.js): `src/_data/companyHelpers.js`
- [Browse Labels](https://github.com/remoteintech/remote-jobs/blob/main/src/_data/labels.js): `src/_data/labels.js`
- [Site Metadata](https://github.com/remoteintech/remote-jobs/blob/main/src/_data/meta.js): `src/_data/meta.js`

### Eleventy Generation

- [Content Collections](https://github.com/remoteintech/remote-jobs/blob/main/src/_config/collections.js): `src/_config/collections.js`
- [Site Configuration](https://github.com/remoteintech/remote-jobs/blob/main/eleventy.config.js): `eleventy.config.js`
- [Markdown Processing](https://github.com/remoteintech/remote-jobs/blob/main/src/_config/plugins/markdown.js): `src/_config/plugins/markdown.js`
- [Template Filters](https://github.com/remoteintech/remote-jobs/blob/main/src/_config/filters.js): `src/_config/filters.js`
- [Image Shortcode](https://github.com/remoteintech/remote-jobs/blob/main/src/_config/shortcodes/image.js): `src/_config/shortcodes/image.js`

### Site Experience

- [Page Layouts](https://github.com/remoteintech/remote-jobs/tree/main/src/_layouts): `src/_layouts`
- [Shared Templates](https://github.com/remoteintech/remote-jobs/tree/main/src/_includes): `src/_includes`
- [Directory Views](https://github.com/remoteintech/remote-jobs/tree/main/src/companies): `src/companies`
- [Blog Views](https://github.com/remoteintech/remote-jobs/tree/main/src/blog): `src/blog`
- [Tag Browsing](https://github.com/remoteintech/remote-jobs/blob/main/src/common/tags.njk): `src/common/tags.njk`
- [Content Feeds](https://github.com/remoteintech/remote-jobs/tree/main/src/common): `src/common`

### Other components

- **Visitor**
- **Generated Website**

## Connections

- Visitor → Directory Views: browses directory (evidence: `README.md`)
- Company Profiles → Content Collections: feeds company lists (evidence: `src/_config/collections.js`)
- Blog Posts → Content Collections: feeds post lists (evidence: `src/_config/collections.js`)
- Company Labels → Content Collections: supplies labels (evidence: `src/_config/collections.js`)
- Company Profiles → Company Metadata: uses metadata
- Browse Labels → Company Labels: defines labels (evidence: `src/_data/companyHelpers.js`)
- Site Configuration → Content Collections: registers collections (evidence: `eleventy.config.js`)
- Site Configuration → Markdown Processing: sets Markdown (evidence: `eleventy.config.js`)
- Site Configuration → Template Filters: registers filters (evidence: `eleventy.config.js`)
- Site Configuration → Image Shortcode: registers shortcode (evidence: `eleventy.config.js`)
- Content Collections → Directory Views: supplies listings
- Content Collections → Tag Browsing: supplies tag data
- Content Collections → Blog Views: supplies posts
- Directory Views → Page Layouts: renders through
- Blog Views → Page Layouts: renders through
- Tag Browsing → Page Layouts: renders through
- Shared Templates → Page Layouts: supports rendering
- Site Metadata → Shared Templates: provides site data
- Blog Posts → Content Feeds: supplies feed content
- Page Layouts → Generated Website: renders pages (evidence: `README.md`)
- Visitor → Generated Website: reads published site (evidence: `README.md`)
