# penguinmod/penguinmod-home architecture

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

- Interactive diagram: https://gitdiagram.com/penguinmod/penguinmod-home
- Repository: https://github.com/penguinmod/penguinmod-home

## Overview

PenguinMod-Home is the community-facing site for discovering community-made projects and other content. The main page presents project categories and events; separate routes cover search, profiles, personal projects, messaging, uploads, and moderation. Shared authentication and project API modules support account and project operations, while localization is a cross-cutting layer. The repository also includes a VR rendering subsystem. Links reflect shown imports, rendered components, API calls, or documented product scope; unsampled route behavior is summarized without inferring its internal flow.

Main entry points: [`src/routes/+page.svelte`](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/%2Bpage.svelte) (Home feed), [`src/resources/authentication.js`](https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/authentication.js) (Authentication), [`src/resources/projectapi.js`](https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/projectapi.js) (Project API client), [`src/routes/profile/+page.svelte`](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/profile/%2Bpage.svelte) (User profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Project discovery"]
  node_home["Home feed<br/>[+page.svelte]"]
  node_search["Project search<br/>[+page.svelte]"]
  node_project_views["Project views<br/>[Project.svelte]"]
  node_events["Events"]
  node_editor["Project editor<br/>[+page.svelte]"]
end

subgraph group_community["Community and accounts"]
  node_profile["User profiles<br/>[+page.svelte]"]
  node_my_stuff["My projects<br/>[+page.svelte]"]
  node_messages["Messages<br/>[+page.svelte]"]
  node_signup["Account signup<br/>[+page.svelte]"]
  node_signin["Account sign-in<br/>[+page.svelte]"]
  node_upload["Project upload<br/>[+page.svelte]"]
end

subgraph group_operations["Site operations"]
  node_panel["Admin panel<br/>[+page.svelte]"]
  node_guidelines["Guidelines"]
  node_devposts["Developer posts"]
end

subgraph group_shared["Shared services"]
  node_authentication["Authentication<br/>[authentication.js]"]
  node_project_api["Project API client<br/>[projectapi.js]"]
  node_localization["Localization<br/>[translations.js]"]
  node_language["Language selection<br/>[language.js]"]
  node_vr["VR rendering<br/>[index.js]"]
  node_vr_html["HTML renderer<br/>[index.js]"]
end

node_visitor(("Site visitor"))
node_api_service["PenguinMod API"]

node_visitor -->|"opens"| node_home
node_visitor -->|"searches"| node_search
node_visitor -->|"views"| node_profile
node_visitor -->|"registers"| node_signup
node_visitor -->|"signs in"| node_signin
node_visitor -->|"uploads"| node_upload
node_home -->|"renders"| node_events
node_home -->|"shows projects"| node_project_views
node_home -->|"uses"| node_project_api
node_home -->|"uses"| node_authentication
node_home -->|"uses"| node_localization
node_home -->|"uses"| node_language
node_profile -->|"uses"| node_project_api
node_profile -->|"uses"| node_authentication
node_messages -->|"uses"| node_project_api
node_messages -->|"uses"| node_authentication
node_upload -->|"loads project metadata"| node_project_api
node_upload -->|"uses"| node_authentication
node_signup -->|"uses"| node_authentication
node_panel -->|"uses"| node_project_api
node_panel -->|"uses"| node_authentication
node_authentication -->|"gets API origin"| node_project_api
node_project_api -->|"sends API requests"| node_api_service
node_language -->|"resolves translations"| node_localization
node_vr -->|"uses renderer"| node_vr_html

click node_home "https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/%2Bpage.svelte"
click node_search "https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/search/%2Bpage.svelte"
click node_project_views "https://github.com/penguinmod/penguinmod-home/blob/main/src/lib/Project/Project.svelte"
click node_events "https://github.com/penguinmod/penguinmod-home/tree/main/src/routes/events"
click node_editor "https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/edit/%2Bpage.svelte"
click node_profile "https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/profile/%2Bpage.svelte"
click node_my_stuff "https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/mystuff/%2Bpage.svelte"
click node_messages "https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/messages/%2Bpage.svelte"
click node_signup "https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/signup/%2Bpage.svelte"
click node_signin "https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/signin/%2Bpage.svelte"
click node_upload "https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/upload/%2Bpage.svelte"
click node_panel "https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/panel/%2Bpage.svelte"
click node_guidelines "https://github.com/penguinmod/penguinmod-home/tree/main/src/routes/guidelines"
click node_devposts "https://github.com/penguinmod/penguinmod-home/tree/main/src/routes/devposts"
click node_authentication "https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/authentication.js"
click node_project_api "https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/projectapi.js"
click node_localization "https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/translations.js"
click node_language "https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/language.js"
click node_vr "https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/vr/index.js"
click node_vr_html "https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/vr/htmlrenderer/index.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_home,node_search,node_project_views,node_events,node_editor toneBlue
class node_profile,node_my_stuff,node_messages,node_signup,node_signin,node_upload toneAmber
class node_panel,node_guidelines,node_devposts,node_api_service toneMint
class node_authentication,node_project_api,node_localization,node_language,node_vr,node_vr_html toneRose
class node_visitor toneIndigo
```

## Components

### Project discovery

- [Home feed](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/%2Bpage.svelte): `src/routes/+page.svelte`
- [Project search](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/search/%2Bpage.svelte): `src/routes/search/+page.svelte`
- [Project views](https://github.com/penguinmod/penguinmod-home/blob/main/src/lib/Project/Project.svelte): `src/lib/Project/Project.svelte`
- [Events](https://github.com/penguinmod/penguinmod-home/tree/main/src/routes/events): `src/routes/events`
- [Project editor](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/edit/%2Bpage.svelte): `src/routes/edit/+page.svelte`

### Community and accounts

- [User profiles](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/profile/%2Bpage.svelte): `src/routes/profile/+page.svelte`
- [My projects](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/mystuff/%2Bpage.svelte): `src/routes/mystuff/+page.svelte`
- [Messages](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/messages/%2Bpage.svelte): `src/routes/messages/+page.svelte`
- [Account signup](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/signup/%2Bpage.svelte): `src/routes/signup/+page.svelte`
- [Account sign-in](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/signin/%2Bpage.svelte): `src/routes/signin/+page.svelte`
- [Project upload](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/upload/%2Bpage.svelte): `src/routes/upload/+page.svelte`

### Site operations

- [Admin panel](https://github.com/penguinmod/penguinmod-home/blob/main/src/routes/panel/%2Bpage.svelte): `src/routes/panel/+page.svelte`
- [Guidelines](https://github.com/penguinmod/penguinmod-home/tree/main/src/routes/guidelines): `src/routes/guidelines`
- [Developer posts](https://github.com/penguinmod/penguinmod-home/tree/main/src/routes/devposts): `src/routes/devposts`

### Shared services

- [Authentication](https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/authentication.js): `src/resources/authentication.js`
- [Project API client](https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/projectapi.js): `src/resources/projectapi.js`
- [Localization](https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/translations.js): `src/resources/translations.js`
- [Language selection](https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/language.js): `src/resources/language.js`
- [VR rendering](https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/vr/index.js): `src/resources/vr/index.js`
- [HTML renderer](https://github.com/penguinmod/penguinmod-home/blob/main/src/resources/vr/htmlrenderer/index.js): `src/resources/vr/htmlrenderer/index.js`

### Other components

- **Site visitor**
- **PenguinMod API**

## Connections

- Site visitor → Home feed: opens
- Site visitor → Project search: searches
- Site visitor → User profiles: views
- Site visitor → Account signup: registers
- Site visitor → Account sign-in: signs in
- Site visitor → Project upload: uploads
- Home feed → Events: renders (evidence: `src/routes/+page.svelte`)
- Home feed → Project views: shows projects (evidence: `src/routes/+page.svelte`)
- Home feed → Project API client: uses (evidence: `src/routes/+page.svelte`)
- Home feed → Authentication: uses (evidence: `src/routes/+page.svelte`)
- Home feed → Localization: uses (evidence: `src/routes/+page.svelte`)
- Home feed → Language selection: uses (evidence: `src/routes/+page.svelte`)
- User profiles → Project API client: uses (evidence: `src/routes/profile/+page.svelte`)
- User profiles → Authentication: uses (evidence: `src/routes/profile/+page.svelte`)
- Messages → Project API client: uses (evidence: `src/routes/messages/+page.svelte`)
- Messages → Authentication: uses (evidence: `src/routes/messages/+page.svelte`)
- Project upload → Project API client: loads project metadata (evidence: `src/routes/upload/+page.svelte`)
- Project upload → Authentication: uses (evidence: `src/routes/upload/+page.svelte`)
- Account signup → Authentication: uses (evidence: `src/routes/signup/+page.svelte`)
- Admin panel → Project API client: uses (evidence: `src/routes/panel/+page.svelte`)
- Admin panel → Authentication: uses (evidence: `src/routes/panel/+page.svelte`)
- Authentication → Project API client: gets API origin (evidence: `src/resources/authentication.js`)
- Project API client → PenguinMod API: sends API requests (evidence: `src/resources/projectapi.js`)
- Language selection → Localization: resolves translations (evidence: `src/resources/language.js`)
- VR rendering → HTML renderer: uses renderer (evidence: `src/resources/vr/index.js`)
