# miguotw/miguo-website architecture

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

- Interactive diagram: https://gitdiagram.com/miguotw/miguo-website
- Repository: https://github.com/miguotw/miguo-website

## Overview

Tarne is a Jekyll portfolio and blog theme. A visitor browses the generated portfolio, project and blog pages, then can use interactive features such as search, bookmarks, image zoom and pagination. The repository also supplies content collections, section data and reusable page components. The graph reflects README capabilities, tree paths and the sampled JavaScript; several template-to-data and third-party integration details are not shown in the excerpts, so those connections are omitted.

Main entry points: [`js/common.js`](https://github.com/miguotw/miguo-website/blob/main/js/common.js) (UI behaviors), [`_layouts`](https://github.com/miguotw/miguo-website/tree/main/_layouts) (Page layouts), [`_includes`](https://github.com/miguotw/miguo-website/tree/main/_includes) (Reusable sections), [`css`](https://github.com/miguotw/miguo-website/tree/main/css) (Responsive styling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Portfolio content"]
  node_posts["Blog posts"]
  node_projects["Projects"]
  node_pages["Pages"]
  node_section_data["Section data"]
end

subgraph group_templates["Page composition"]
  node_layouts["Page layouts"]
  node_includes["Reusable sections"]
  node_styles["Responsive styling"]
end

subgraph group_interaction["Browser interactions"]
  node_common_js["UI behaviors<br/>[common.js]"]
  node_scripts_js["Browser libraries<br/>[scripts.js]"]
  node_search_index["Search index<br/>[search.json]"]
  node_bookmark_store[("Bookmark storage<br/>[common.js]")]
  node_pagination["Post pagination<br/>[common.js]"]
end

subgraph group_integrations["Optional integrations"]
  node_formspree["Formspree"]
  node_mailchimp["MailChimp"]
  node_disqus["Disqus"]
  node_analytics["Google Analytics"]
end

node_visitor(("Visitor"))
node_site["Portfolio site"]

node_visitor -->|"browses"| node_site
node_site -.->|"runs interactions"| node_common_js
node_common_js -->|"reads and writes"| node_bookmark_store
node_common_js -->|"fetches next page"| node_pagination
node_common_js -.->|"searches content"| node_search_index
node_site -.->|"uses page layouts"| node_layouts
node_site -.->|"composes sections"| node_includes
node_site -.->|"styles pages"| node_styles
node_visitor -.->|"submits contact"| node_formspree
node_visitor -.->|"subscribes"| node_mailchimp
node_visitor -.->|"comments"| node_disqus
node_site -.->|"tracks visits"| node_analytics

click node_posts "https://github.com/miguotw/miguo-website/tree/main/_posts"
click node_projects "https://github.com/miguotw/miguo-website/tree/main/_projects"
click node_pages "https://github.com/miguotw/miguo-website/tree/main/_pages"
click node_section_data "https://github.com/miguotw/miguo-website/tree/main/_data"
click node_layouts "https://github.com/miguotw/miguo-website/tree/main/_layouts"
click node_includes "https://github.com/miguotw/miguo-website/tree/main/_includes"
click node_styles "https://github.com/miguotw/miguo-website/tree/main/css"
click node_common_js "https://github.com/miguotw/miguo-website/blob/main/js/common.js"
click node_scripts_js "https://github.com/miguotw/miguo-website/blob/main/js/scripts.js"
click node_search_index "https://github.com/miguotw/miguo-website/blob/main/search.json"
click node_bookmark_store "https://github.com/miguotw/miguo-website/blob/main/js/common.js"
click node_pagination "https://github.com/miguotw/miguo-website/blob/main/js/common.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_posts,node_projects,node_pages,node_section_data toneBlue
class node_layouts,node_includes,node_styles toneAmber
class node_common_js,node_scripts_js,node_search_index,node_bookmark_store,node_pagination toneMint
class node_formspree,node_mailchimp,node_disqus,node_analytics toneRose
class node_visitor,node_site toneIndigo
```

## Components

### Portfolio content

- [Blog posts](https://github.com/miguotw/miguo-website/tree/main/_posts): `_posts`
- [Projects](https://github.com/miguotw/miguo-website/tree/main/_projects): `_projects`
- [Pages](https://github.com/miguotw/miguo-website/tree/main/_pages): `_pages`
- [Section data](https://github.com/miguotw/miguo-website/tree/main/_data): `_data`

### Page composition

- [Page layouts](https://github.com/miguotw/miguo-website/tree/main/_layouts): `_layouts`
- [Reusable sections](https://github.com/miguotw/miguo-website/tree/main/_includes): `_includes`
- [Responsive styling](https://github.com/miguotw/miguo-website/tree/main/css): `css`

### Browser interactions

- [UI behaviors](https://github.com/miguotw/miguo-website/blob/main/js/common.js): `js/common.js`
- [Browser libraries](https://github.com/miguotw/miguo-website/blob/main/js/scripts.js): `js/scripts.js`
- [Search index](https://github.com/miguotw/miguo-website/blob/main/search.json): `search.json`
- [Bookmark storage](https://github.com/miguotw/miguo-website/blob/main/js/common.js): `js/common.js`
- [Post pagination](https://github.com/miguotw/miguo-website/blob/main/js/common.js): `js/common.js`

### Optional integrations

- **Formspree**
- **MailChimp**
- **Disqus**
- **Google Analytics**

### Other components

- **Visitor**
- **Portfolio site**

## Connections

- Visitor → Portfolio site: browses (evidence: `README.md`)
- Portfolio site → UI behaviors: runs interactions
- UI behaviors → Bookmark storage: reads and writes (evidence: `js/common.js`)
- UI behaviors → Post pagination: fetches next page (evidence: `js/common.js`)
- UI behaviors → Search index: searches content
- Portfolio site → Page layouts: uses page layouts
- Portfolio site → Reusable sections: composes sections
- Portfolio site → Responsive styling: styles pages
- Visitor → Formspree: submits contact (evidence: `README.md`)
- Visitor → MailChimp: subscribes (evidence: `README.md`)
- Visitor → Disqus: comments (evidence: `README.md`)
- Portfolio site → Google Analytics: tracks visits (evidence: `README.md`)
