# shoutym/floodwatchsk_web architecture

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

- Interactive diagram: https://gitdiagram.com/shoutym/floodwatchsk_web
- Repository: https://github.com/shoutym/floodwatchsk_web

## Overview

1. This repository is a **static web export**, not a server app. The top-level `index.html`, `map.html`, `modal.html`, and `sensor/[id].html` pages, plus `404.html`, `+not-found.html`, and `_sitemap.html`, indicate a prebuilt site meant to be hosted on a static platform such as GitHub Pages.

2. The main application is built with **Expo / Expo Router**. The `_expo` directory, especially `_expo/.routes.json` and `_expo/static/js/web/entry-...js`, is generated output that maps route definitions to the web bundle used at runtime.

3. The routing model is **file-based and route-driven**. The presence of `sensor/[id].html` shows a dynamic route for sensor detail pages, while `index.html`, `map.html`, and `modal.html` are static route endpoints. This is the primary navigation boundary in the system.

4. The `(tabs)` directory represents a **route group / layout boundary** rather than a public URL segment. Its `index.html` and `map.html` pages suggest a tabbed section of the app with multiple views sharing a common layout or navigation shell.

5. The web runtime is a **single client-side JavaScript bundle** loaded by the exported HTML pages. The HTML files serve as entry shells; the `_expo/static/js/web/entry-...js` bundle contains the actual app logic that hydrates and drives navigation in the browser.

6. `assets/` is the repository’s **static resource layer**. Any images, icons, or other non-code assets referenced by the generated pages or the app bundle are expected to live here and are served directly by the static host.

7. `sensor/[id].html` is the clearest sign of a **data-driven UI boundary**. The app likely renders sensor-specific content based on the route parameter `id`, with the browser bundle responsible for reading that route and displaying the appropriate sensor view.

8. `404.html`, `+not-found.html`, and `_sitemap.html` are part of the **hosting and discoverability layer**. `404.html` supports static-host fallback behavior, `+not-found.html` covers app-level missing routes, and `_sitemap.html` helps search engines and route discovery.

9. `CNAME` and `.nojekyll` point to **GitHub Pages-style deployment constraints**. `CNAME` sets a custom domain, while `.nojekyll` disables Jekyll processing so the generated files and special route names are served as-is.

10. The overall data flow is simple: **static HTML shell → loaded Expo web bundle → client-side route handling → route-specific views**. There is no evidence here of a separate backend, API service, or database in this repository.

11. For an architecture diagram, the important boxes are: **static host**, **generated HTML route pages**, **Expo web bundle**, **route group/layout structure**, and **static assets**. The main boundary is between build-time generated artifacts and runtime browser execution.

12. The repository content is minimal, and the `README.md` only says `Test`, so the architecture should be treated as **exported frontend output** rather than a full source tree. Most of the interesting structure is encoded in the generated route files and the Expo artifacts.

Main entry points: [`_expo/static/js/web/entry-6fadacdbe3c40517a66130fb265f192f.js`](https://github.com/shoutym/floodwatchsk_web/blob/main/_expo/static/js/web/entry-6fadacdbe3c40517a66130fb265f192f.js) (Web bundle), [`index.html`](https://github.com/shoutym/floodwatchsk_web/blob/main/index.html) (Home page), [`map.html`](https://github.com/shoutym/floodwatchsk_web/blob/main/map.html) (Map page), [`sensor/[id].html`](https://github.com/shoutym/floodwatchsk_web/blob/main/sensor/[id].html) (Sensor detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deployment["Deployment"]
  node_static_host[("Static host<br/>hosting")]
  node_cname["Custom domain<br/>deploy-config"]
  node_nojekyll["No Jekyll<br/>deploy-config<br/>[.nojekyll]"]
end

subgraph group_routes["Routes"]
  node_home_shell["Home page<br/>html entry<br/>[index.html]"]
  node_map_shell["Map page<br/>html entry<br/>[map.html]"]
  node_modal_shell["Modal page<br/>html entry<br/>[modal.html]"]
  node_tab_home["Tabs home<br/>route page<br/>[index.html]"]
  node_tab_map["Tabs map<br/>route page<br/>[map.html]"]
  node_sensor_detail["Sensor detail<br/>dynamic route<br/>[[id].html]"]
  node_not_found_app["App 404<br/>route fallback<br/>[+not-found.html]"]
  node_not_found_host["Host 404<br/>fallback page<br/>[404.html]"]
  node_sitemap["Sitemap<br/>discovery<br/>[_sitemap.html]"]
end

subgraph group_runtime["Runtime"]
  node_route_manifest["Route map<br/>expo metadata<br/>[.routes.json]"]
  node_web_bundle["Web bundle<br/>expo client"]
  node_route_group{{"Tabs layout<br/>route group"}}
end

subgraph group_assets["Assets"]
  node_assets_root[("Assets<br/>static resources")]
end

node_static_host -->|"serves"| node_cname
node_static_host -->|"serves"| node_nojekyll
node_static_host -->|"serves"| node_home_shell
node_static_host -->|"serves"| node_map_shell
node_static_host -->|"serves"| node_modal_shell
node_static_host -->|"serves"| node_tab_home
node_static_host -->|"serves"| node_tab_map
node_static_host -->|"serves"| node_sensor_detail
node_static_host -->|"serves"| node_not_found_app
node_static_host -->|"serves"| node_not_found_host
node_static_host -->|"serves"| node_sitemap
node_home_shell -->|"loads"| node_web_bundle
node_map_shell -->|"loads"| node_web_bundle
node_modal_shell -->|"loads"| node_web_bundle
node_tab_home -->|"loads"| node_web_bundle
node_tab_map -->|"loads"| node_web_bundle
node_sensor_detail -->|"loads"| node_web_bundle
node_route_manifest -->|"drives"| node_web_bundle
node_route_group -->|"organizes"| node_tab_home
node_route_group -->|"organizes"| node_tab_map
node_web_bundle -->|"renders"| node_route_group
node_web_bundle -->|"resolves"| node_sensor_detail
node_web_bundle -->|"hydrates"| node_home_shell
node_web_bundle -->|"hydrates"| node_map_shell
node_web_bundle -->|"hydrates"| node_modal_shell
node_assets_root -->|"referenced by"| node_web_bundle
node_assets_root -->|"referenced by"| node_home_shell
node_assets_root -->|"referenced by"| node_map_shell
node_assets_root -->|"referenced by"| node_sensor_detail
node_not_found_app -->|"fallback"| node_not_found_host
node_sitemap -->|"indexes"| node_home_shell
node_sitemap -->|"indexes"| node_map_shell
node_sitemap -->|"indexes"| node_sensor_detail

click node_cname "https://github.com/shoutym/floodwatchsk_web/tree/main/CNAME"
click node_nojekyll "https://github.com/shoutym/floodwatchsk_web/blob/main/.nojekyll"
click node_home_shell "https://github.com/shoutym/floodwatchsk_web/blob/main/index.html"
click node_map_shell "https://github.com/shoutym/floodwatchsk_web/blob/main/map.html"
click node_modal_shell "https://github.com/shoutym/floodwatchsk_web/blob/main/modal.html"
click node_tab_home "https://github.com/shoutym/floodwatchsk_web/blob/main/(tabs)/index.html"
click node_tab_map "https://github.com/shoutym/floodwatchsk_web/blob/main/(tabs)/map.html"
click node_sensor_detail "https://github.com/shoutym/floodwatchsk_web/blob/main/sensor/[id].html"
click node_not_found_app "https://github.com/shoutym/floodwatchsk_web/blob/main/+not-found.html"
click node_not_found_host "https://github.com/shoutym/floodwatchsk_web/blob/main/404.html"
click node_sitemap "https://github.com/shoutym/floodwatchsk_web/blob/main/_sitemap.html"
click node_route_manifest "https://github.com/shoutym/floodwatchsk_web/blob/main/_expo/.routes.json"
click node_web_bundle "https://github.com/shoutym/floodwatchsk_web/blob/main/_expo/static/js/web/entry-6fadacdbe3c40517a66130fb265f192f.js"
click node_route_group "https://github.com/shoutym/floodwatchsk_web/tree/main/(tabs)"
click node_assets_root "https://github.com/shoutym/floodwatchsk_web/tree/main/assets"

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_static_host,node_cname,node_nojekyll toneBlue
class node_home_shell,node_map_shell,node_modal_shell,node_tab_home,node_tab_map,node_sensor_detail,node_not_found_app,node_not_found_host,node_sitemap toneAmber
class node_route_manifest,node_web_bundle,node_route_group toneMint
class node_assets_root toneRose
```

## Components

### Deployment

Static hosting and publish-time constraints

- **Static host**: hosting · Static platform serving prebuilt pages and assets
- [Custom domain](https://github.com/shoutym/floodwatchsk_web/tree/main/CNAME): deploy-config · GitHub Pages domain binding · `CNAME`
- [No Jekyll](https://github.com/shoutym/floodwatchsk_web/blob/main/.nojekyll): deploy-config · Prevents host-side rewriting of generated files · `.nojekyll`

### Routes

Generated HTML entry points and route boundary pages

- [Home page](https://github.com/shoutym/floodwatchsk_web/blob/main/index.html): html entry · Top-level exported landing page · `index.html`
- [Map page](https://github.com/shoutym/floodwatchsk_web/blob/main/map.html): html entry · Top-level exported map route · `map.html`
- [Modal page](https://github.com/shoutym/floodwatchsk_web/blob/main/modal.html): html entry · Exported modal route shell · `modal.html`
- [Tabs home](https://github.com/shoutym/floodwatchsk_web/blob/main/(tabs)/index.html): route page · Route-group index inside the tabs layout · `(tabs)/index.html`
- [Tabs map](https://github.com/shoutym/floodwatchsk_web/blob/main/(tabs)/map.html): route page · Route-group map view inside the tabs layout · `(tabs)/map.html`
- [Sensor detail](https://github.com/shoutym/floodwatchsk_web/blob/main/sensor/[id].html): dynamic route · Parameterised sensor page for sensor id · `sensor/[id].html`
- [App 404](https://github.com/shoutym/floodwatchsk_web/blob/main/+not-found.html): route fallback · Application-level missing route page · `+not-found.html`
- [Host 404](https://github.com/shoutym/floodwatchsk_web/blob/main/404.html): fallback page · Static host fallback page · `404.html`
- [Sitemap](https://github.com/shoutym/floodwatchsk_web/blob/main/_sitemap.html): discovery · Generated sitemap for crawlers and route discovery · `_sitemap.html`

### Runtime

Expo Router web bundle and routing metadata

- [Route map](https://github.com/shoutym/floodwatchsk_web/blob/main/_expo/.routes.json): expo metadata · Generated route mapping used by the web export · `_expo/.routes.json`
- [Web bundle](https://github.com/shoutym/floodwatchsk_web/blob/main/_expo/static/js/web/entry-6fadacdbe3c40517a66130fb265f192f.js): expo client · Single browser bundle that hydrates and drives navigation · `_expo/static/js/web/entry-6fadacdbe3c40517a66130fb265f192f.js`
- [Tabs layout](https://github.com/shoutym/floodwatchsk_web/tree/main/(tabs)): route group · Shared layout boundary for tabbed views · `(tabs)`

### Assets

Static resources served by the host

- [Assets](https://github.com/shoutym/floodwatchsk_web/tree/main/assets): static resources · Static files referenced by the exported app · `assets`

## Connections

- Static host → Custom domain: serves · Custom domain configuration is part of deployment
- Static host → No Jekyll: serves · Host must expose generated files without Jekyll processing
- Static host → Home page: serves · Entry shell loaded by the browser
- Static host → Map page: serves · Entry shell loaded by the browser
- Static host → Modal page: serves · Entry shell loaded by the browser
- Static host → Tabs home: serves · Route-group page served as a static endpoint
- Static host → Tabs map: serves · Route-group page served as a static endpoint
- Static host → Sensor detail: serves · Dynamic route exported as HTML
- Static host → App 404: serves · App-level fallback page
- Static host → Host 404: serves · Static host fallback page
- Static host → Sitemap: serves · Search/discovery artifact
- Home page → Web bundle: loads · HTML shell bootstraps the client bundle
- Map page → Web bundle: loads · HTML shell bootstraps the client bundle
- Modal page → Web bundle: loads · HTML shell bootstraps the client bundle
- Tabs home → Web bundle: loads · Route-group page bootstraps the client bundle
- Tabs map → Web bundle: loads · Route-group page bootstraps the client bundle
- Sensor detail → Web bundle: loads · Dynamic route page bootstraps the client bundle
- Route map → Web bundle: drives · Generated route metadata informs the runtime router
- Tabs layout → Tabs home: organizes · Shared layout boundary for tabbed routes
- Tabs layout → Tabs map: organizes · Shared layout boundary for tabbed routes
- Web bundle → Tabs layout: renders · Client runtime activates the tabbed layout
- Web bundle → Sensor detail: resolves · Client-side routing selects the sensor view by id
- Web bundle → Home page: hydrates · Browser runtime takes over the exported shell
- Web bundle → Map page: hydrates · Browser runtime takes over the exported shell
- Web bundle → Modal page: hydrates · Browser runtime takes over the exported shell
- Assets → Web bundle: referenced by · Bundle can reference static assets at runtime
- Assets → Home page: referenced by · Pages may reference exported assets
- Assets → Map page: referenced by · Pages may reference exported assets
- Assets → Sensor detail: referenced by · Sensor pages may reference static assets
- App 404 → Host 404: fallback · App fallback complements host fallback behavior
- Sitemap → Home page: indexes · Sitemap enumerates public route pages
- Sitemap → Map page: indexes · Sitemap enumerates public route pages
- Sitemap → Sensor detail: indexes · Sitemap enumerates public route pages
