# rs-labhub/ask-her-out architecture

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

- Interactive diagram: https://gitdiagram.com/rs-labhub/ask-her-out
- Repository: https://github.com/rs-labhub/ask-her-out

## Overview

##### Main Components

a. Client-Side Components:
- Static Asset Layer
- HTML Pages (8 different interactive pages)
- CSS Styles (global and page-specific)
- JavaScript Modules (animation and interaction handlers)
- Media Assets (videos and images in Pages/Assets and Previews)

b. External Services:
- Flagsmith Feature Management
- Bootstrap 5 CDN

**┌─────────────────────────────────────────────┐**
- Client Browser              │
- ┘
- ↓
**┌─────────────────────────────────────────────┐**
- Static Asset Server            │
- ┬─────────────────────┬─┤
- HTML Pages      │    CSS Styles       │ │
- index.html       │  - style.css        │ │
- secondPage.html  │  - page-specific    │ │
- thirdPage.html   │    CSS files        │ │
- etc...            │                     │ │
- ┼─────────────────────┤ │
- JavaScript        │     Media Assets    │ │
- firstPage.js     │  - Videos          │ │
- page-specific    │  - Images          │ │
- JS files         │                     │ │
- ┴─────────────────────┴─┘
- ↑                    ↑
**┌───────────────────┐  ┌──────────────────┐**
- Flagsmith API   │  │   Bootstrap 5    │
- Feature Flags    │  │     CDN          │
- ┘  └──────────────────┘

##### Important Details to Highlight

a. Page Flow:
- Sequential nature of the pages (Page 1 → Page 2 → etc.)
- Branching paths based on user choices (Yes/No responses)

b. Asset Organization:
- Assets by type (CSS, JS, Media)
- Relationship between paired files (HTML, CSS, JS for each page)

c. External Dependencies:
- Bootstrap 5 integration
- Flagsmith feature flag implementation

##### Implementation Notes

- Maintain consistent spacing and alignment
- Version information for major dependencies
- Annotations for future planned features (mobile responsiveness, app conversion)

Remember to include a small section about scalability and future improvements, such as:
- Mobile responsiveness implementation
- Conversion to mobile app
- Additional features like date reminders and virtual gifts
- Performance optimization for media assets

This will provide a complete picture of both the current architecture and the planned evolution of the system.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Web Browser"]
    end

    subgraph "Static Assets"
        MainEntry["Main Entry Point"]:::html
        GlobalStyles["Global Styles"]:::css

        subgraph "Page Components"
            FirstPage["First Page"]:::page
            SecondPage["Second Page"]:::page
            ThirdPage["Third Page"]:::page
            AskPage["Ask Page"]:::page
            
            subgraph "Response Pages"
                YesPath["Yes Path"]:::page
                NoPath1["No Path 1"]:::page
                NoPath2["No Path 2"]:::page
                NoPath3["No Path 3"]:::page
            end
        end

        subgraph "Media Assets"
            Videos["Videos"]:::media
            Screenshots["Screenshots"]:::media
        end
    end

    subgraph "External Services"
        Bootstrap["Bootstrap 5 CDN"]:::external
        Flagsmith["Flagsmith Feature Management"]:::external
    end

    Browser --> MainEntry
    MainEntry --> FirstPage
    FirstPage --> SecondPage
    SecondPage --> ThirdPage
    ThirdPage --> AskPage
    AskPage --> YesPath
    AskPage --> NoPath1
    NoPath1 --> NoPath2
    NoPath2 --> NoPath3

    Browser --> GlobalStyles
    Browser --> Videos
    Browser --> Screenshots
    Browser --> Bootstrap
    Browser --> Flagsmith

    %% Click Events
    click MainEntry "https://github.com/RS-labhub/ask-her-out/blob/main/index.html"
    click GlobalStyles "https://github.com/RS-labhub/ask-her-out/blob/main/style.css"
    click FirstPage "https://github.com/RS-labhub/ask-her-out/blob/main/firstPage.js"
    click SecondPage "https://github.com/RS-labhub/ask-her-out/blob/main/Pages/Page 1/secondPage.js"
    click ThirdPage "https://github.com/RS-labhub/ask-her-out/blob/main/Pages/Page 2/thirdPage.js"
    click AskPage "https://github.com/RS-labhub/ask-her-out/blob/main/Pages/Page 4/ask.js"
    click YesPath "https://github.com/RS-labhub/ask-her-out/tree/main/Pages/Page 5"
    click NoPath1 "https://github.com/RS-labhub/ask-her-out/tree/main/Pages/Page 6"
    click NoPath2 "https://github.com/RS-labhub/ask-her-out/tree/main/Pages/Page 7"
    click NoPath3 "https://github.com/RS-labhub/ask-her-out/tree/main/Pages/Page 8"
    click Videos "https://github.com/RS-labhub/ask-her-out/tree/main/Previews"
    click Screenshots "https://github.com/RS-labhub/ask-her-out/tree/main/Screenshots"

    %% Styles
    classDef html fill:#f96,stroke:#333
    classDef css fill:#6c9,stroke:#333
    classDef page fill:#69f,stroke:#333
    classDef media fill:#c9f,stroke:#333
    classDef external fill:#9c6,stroke:#333

    %% Legend
    subgraph Legend
        HTML["HTML Files"]:::html
        CSS["CSS Files"]:::css
        Pages["Page Components"]:::page
        Media["Media Files"]:::media
        External["External Services"]:::external
    end
```
