# zandercowboy/mywebsite architecture

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

- Interactive diagram: https://gitdiagram.com/zandercowboy/mywebsite
- Repository: https://github.com/zandercowboy/mywebsite

## Overview

##### Project type and purpose
- This is a cross-platform, client-side “personal website” built entirely in Flutter and Dart.
- There is no custom backend or API server; instead the Flutter app is compiled to multiple targets (Android, iOS, Web, Linux, Windows).
- Its primary job is to display static content (images, links, text) and launch external URLs (social profiles, email clients).

##### File structure
- Top-level:
– platform folders: android/, ios/, web/, linux/, windows/
– lib/ – the heart of your code (widgets, services, utils)
– assets/, images/, fonts/ – all static resources
– configuration: pubspec.yaml, Dockerfile, CI/CD workflows, .devcontainer
- lib/ breakdown:
– main.dart & app.dart – entrypoints
– components/ – reusable UI widgets (LinkButton, AppVersion)
– views/ – page-specific layouts (home_page, personal_page)
– services/ – platform-specific services (app_info_service)
– util/ – constants, URL launcher, UI styling

##### README for additional insights
- Confirms this is a static, Flutter-based personal website
- No mention of a backend or server-side logic

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Static Assets
    Assets["Assets (images/, fonts/)"]:::asset
    click Assets "https://github.com/zandercowboy/mywebsite/tree/main/assets/images/"

    %% Flutter Application
    subgraph "Flutter App (lib/)"
        direction TB
        Entrypoints["Entry Points\nmain.dart, app.dart"]:::app
        click Entrypoints "https://github.com/zandercowboy/mywebsite/blob/main/lib/main.dart"
        click Entrypoints "https://github.com/zandercowboy/mywebsite/blob/main/lib/app.dart"

        subgraph "Presentation Layer" 
            direction TB
            Components["Components\napp_version, copyright,\nlink_button"]:::presentation
            click Components "https://github.com/zandercowboy/mywebsite/blob/main/lib/components/app_version.dart"
            click Components "https://github.com/zandercowboy/mywebsite/blob/main/lib/components/copyright.dart"
            click Components "https://github.com/zandercowboy/mywebsite/blob/main/lib/components/link_button.dart"
            Views["Views\nhome_page, personal_page"]:::presentation
            click Views "https://github.com/zandercowboy/mywebsite/blob/main/lib/views/home/home_page.dart"
            click Views "https://github.com/zandercowboy/mywebsite/blob/main/lib/views/home/widgets/buttons.dart"
            click Views "https://github.com/zandercowboy/mywebsite/blob/main/lib/views/home/widgets/footer.dart"
            click Views "https://github.com/zandercowboy/mywebsite/blob/main/lib/views/home/widgets/header.dart"
            click Views "https://github.com/zandercowboy/mywebsite/blob/main/lib/views/personal/personal_page.dart"
            click Views "https://github.com/zandercowboy/mywebsite/blob/main/lib/views/personal/personalpagecopy.dart"
        end

        subgraph "Service Layer"
            direction TB
            AppInfo["AppInfoService"]:::service
            click AppInfo "https://github.com/zandercowboy/mywebsite/blob/main/lib/services/app_info_service.dart"
        end

        subgraph "Utility Layer"
            direction TB
            Utils["Utilities\nconstants, launcher, ui_constants"]:::utility
            click Utils "https://github.com/zandercowboy/mywebsite/blob/main/lib/util/constants.dart"
            click Utils "https://github.com/zandercowboy/mywebsite/blob/main/lib/util/launcher.dart"
            click Utils "https://github.com/zandercowboy/mywebsite/blob/main/lib/util/ui_constants.dart"
        end
    end

    %% Build & Deployment
    Entrypoints -->|uses| Components
    Entrypoints -->|uses| Views
    Components -->|calls| AppInfo
    Views -->|calls| Utils
    Assets -->|loaded by| Entrypoints

    %% Flutter Engine to Platforms
    Entrypoints -->|"Compiled by Flutter Engine"| Android
    Entrypoints -->|"Compiled by Flutter Engine"| iOS
    Entrypoints -->|"Compiled by Flutter Engine"| Web
    Entrypoints -->|"Compiled by Flutter Engine"| Linux
    Entrypoints -->|"Compiled by Flutter Engine"| Windows

    %% Platform Embedders
    Android["Android Embedder"]:::embedder
    click Android "https://github.com/zandercowboy/mywebsite/tree/main/android/"

    iOS["iOS Embedder"]:::embedder
    click iOS "https://github.com/zandercowboy/mywebsite/tree/main/ios/"

    Web["Web Renderer"]:::embedder
    click Web "https://github.com/zandercowboy/mywebsite/tree/main/web/"

    Linux["Linux Embedder"]:::embedder
    click Linux "https://github.com/zandercowboy/mywebsite/tree/main/linux/"

    Windows["Windows Embedder"]:::embedder
    click Windows "https://github.com/zandercowboy/mywebsite/tree/main/windows/runner"

    %% Configuration & CI/CD
    Config["Configuration & CI/CD"]:::config
    click Config "https://github.com/zandercowboy/mywebsite/blob/main/pubspec.yaml"
    click Config "https://github.com/zandercowboy/mywebsite/tree/main/Dockerfile"
    click Config "https://github.com/zandercowboy/mywebsite/tree/main/.devcontainer/"
    click Config "https://github.com/zandercowboy/mywebsite/blob/main/.github/workflows/cicd.yml"

    Entrypoints -->|configured by| Config

    classDef app fill:#FFD580,stroke:#D48E00,color:#000;
    classDef presentation fill:#FFCCBA,stroke:#C85C4D,color:#000;
    classDef service fill:#BAE1FF,stroke:#4D8EC8,color:#000;
    classDef utility fill:#D5FFBA,stroke:#70C84D,color:#000;
    classDef asset fill:#E0BBE4,stroke:#957DAD,color:#000;
    classDef embedder fill:#FFDFBA,stroke:#C87D4D,color:#000;
    classDef config fill:#BFFCC6,stroke:#4DC87A,color:#000;
```
