# cedarcu/superguidejapan architecture

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

- Interactive diagram: https://gitdiagram.com/cedarcu/superguidejapan
- Repository: https://github.com/cedarcu/superguidejapan

## Overview

Super Guide Japan is a multilingual static portal for travel, living, shopping, learning, earning and professional services in Japan. Visitors browse the HTML hubs and guides; the browser runtime translates content and enhances affiliate links, contact details, forms and ads. Forms can submit leads/newsletter signups to the optional Apps Script backend, which writes to Sheets and sends email. Major page capabilities are represented from the README and file tree; unsampled page internals and backend implementation details are not inferred.

Main entry points: [`js/site.js`](https://github.com/cedarcu/superguidejapan/blob/main/js/site.js) (Site enhancements), [`js/i18n.js`](https://github.com/cedarcu/superguidejapan/blob/main/js/i18n.js) (Language switcher), [`index.html`](https://github.com/cedarcu/superguidejapan/blob/main/index.html) (Portal home), [`travel.html`](https://github.com/cedarcu/superguidejapan/blob/main/travel.html) (Travel bookings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Guides and hubs"]
  node_home["Portal home<br/>[index.html]"]
  node_travel["Travel bookings<br/>[travel.html]"]
  node_shop["Japan shopping<br/>[shop.html]"]
  node_learn["Japanese learning<br/>[learn.html]"]
  node_earn["Points and income<br/>[earn.html]"]
  node_services["Professional services<br/>[services.html]"]
  node_guides["Living and travel guides"]
end

subgraph group_runtime["Browser runtime"]
  node_config["Site configuration<br/>[config.js]"]
  node_i18n["Language switcher<br/>[i18n.js]"]
  node_site["Site enhancements<br/>[site.js]"]
end

subgraph group_leads["Lead capture"]
  node_formbackend["Forms backend<br/>[Code.gs]"]
end

node_visitor(("Visitor"))
node_analytics["Analytics providers"]
node_affiliate["Affiliate partners"]
node_adsense["Ad network"]
node_contact["Contact channels"]
node_sheets[("Lead spreadsheet")]
node_email["Email service"]

node_visitor -->|"browses"| node_home
node_visitor -->|"browses"| node_travel
node_visitor -->|"browses"| node_shop
node_visitor -->|"browses"| node_learn
node_visitor -->|"browses"| node_earn
node_visitor -->|"browses"| node_services
node_visitor -->|"browses"| node_guides
node_home -->|"loads"| node_i18n
node_travel -->|"loads"| node_i18n
node_shop -->|"loads"| node_i18n
node_learn -->|"loads"| node_i18n
node_earn -->|"loads"| node_i18n
node_services -->|"loads"| node_i18n
node_guides -->|"loads"| node_i18n
node_home -->|"loads"| node_site
node_travel -->|"loads"| node_site
node_shop -->|"loads"| node_site
node_learn -->|"loads"| node_site
node_earn -->|"loads"| node_site
node_services -->|"loads"| node_site
node_guides -->|"loads"| node_site
node_site -->|"reads settings"| node_config
node_i18n -->|"updates language"| node_visitor
node_site -->|"resolves links"| node_affiliate
node_site -.->|"sends events"| node_analytics
node_site -.->|"loads ads"| node_adsense
node_site -->|"hydrates details"| node_contact
node_visitor -->|"submits forms"| node_site
node_site -.->|"posts submissions"| node_formbackend
node_formbackend -->|"writes leads"| node_sheets
node_formbackend -->|"sends replies"| node_email

click node_home "https://github.com/cedarcu/superguidejapan/blob/main/index.html"
click node_travel "https://github.com/cedarcu/superguidejapan/blob/main/travel.html"
click node_shop "https://github.com/cedarcu/superguidejapan/blob/main/shop.html"
click node_learn "https://github.com/cedarcu/superguidejapan/blob/main/learn.html"
click node_earn "https://github.com/cedarcu/superguidejapan/blob/main/earn.html"
click node_services "https://github.com/cedarcu/superguidejapan/blob/main/services.html"
click node_guides "https://github.com/cedarcu/superguidejapan/tree/main/guides"
click node_config "https://github.com/cedarcu/superguidejapan/blob/main/js/config.js"
click node_i18n "https://github.com/cedarcu/superguidejapan/blob/main/js/i18n.js"
click node_site "https://github.com/cedarcu/superguidejapan/blob/main/js/site.js"
click node_formbackend "https://github.com/cedarcu/superguidejapan/blob/main/google-apps-script/Code.gs"

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_home,node_travel,node_shop,node_learn,node_earn,node_services,node_guides toneBlue
class node_config,node_i18n,node_site,node_sheets toneAmber
class node_formbackend toneMint
class node_visitor,node_analytics,node_affiliate,node_adsense,node_contact,node_email toneIndigo
```

## Components

### Guides and hubs

- [Portal home](https://github.com/cedarcu/superguidejapan/blob/main/index.html): `index.html`
- [Travel bookings](https://github.com/cedarcu/superguidejapan/blob/main/travel.html): `travel.html`
- [Japan shopping](https://github.com/cedarcu/superguidejapan/blob/main/shop.html): `shop.html`
- [Japanese learning](https://github.com/cedarcu/superguidejapan/blob/main/learn.html): `learn.html`
- [Points and income](https://github.com/cedarcu/superguidejapan/blob/main/earn.html): `earn.html`
- [Professional services](https://github.com/cedarcu/superguidejapan/blob/main/services.html): `services.html`
- [Living and travel guides](https://github.com/cedarcu/superguidejapan/tree/main/guides): `guides`

### Browser runtime

- [Site configuration](https://github.com/cedarcu/superguidejapan/blob/main/js/config.js): `js/config.js`
- [Language switcher](https://github.com/cedarcu/superguidejapan/blob/main/js/i18n.js): `js/i18n.js`
- [Site enhancements](https://github.com/cedarcu/superguidejapan/blob/main/js/site.js): `js/site.js`

### Lead capture

- [Forms backend](https://github.com/cedarcu/superguidejapan/blob/main/google-apps-script/Code.gs): `google-apps-script/Code.gs`

### Other components

- **Visitor**
- **Analytics providers**
- **Affiliate partners**
- **Ad network**
- **Contact channels**
- **Lead spreadsheet**
- **Email service**

## Connections

- Visitor → Portal home: browses
- Visitor → Travel bookings: browses
- Visitor → Japan shopping: browses
- Visitor → Japanese learning: browses
- Visitor → Points and income: browses
- Visitor → Professional services: browses
- Visitor → Living and travel guides: browses
- Portal home → Language switcher: loads
- Travel bookings → Language switcher: loads
- Japan shopping → Language switcher: loads
- Japanese learning → Language switcher: loads
- Points and income → Language switcher: loads
- Professional services → Language switcher: loads
- Living and travel guides → Language switcher: loads
- Portal home → Site enhancements: loads
- Travel bookings → Site enhancements: loads
- Japan shopping → Site enhancements: loads
- Japanese learning → Site enhancements: loads
- Points and income → Site enhancements: loads
- Professional services → Site enhancements: loads
- Living and travel guides → Site enhancements: loads
- Site enhancements → Site configuration: reads settings
- Language switcher → Visitor: updates language
- Site enhancements → Affiliate partners: resolves links
- Site enhancements → Analytics providers: sends events
- Site enhancements → Ad network: loads ads
- Site enhancements → Contact channels: hydrates details
- Visitor → Site enhancements: submits forms
- Site enhancements → Forms backend: posts submissions
- Forms backend → Lead spreadsheet: writes leads
- Forms backend → Email service: sends replies