# chaitanyap28/writeupctf architecture

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

- Interactive diagram: https://gitdiagram.com/chaitanyap28/writeupctf
- Repository: https://github.com/chaitanyap28/writeupctf

## Overview

##### Project type and purpose
- There are no backend services, databases, or dynamic code. All content is delivered as static HTML and markdown-based write-ups.
- The directory “WriteUps” holds the actual challenge solutions; “v1” and “v2” appear to be versioned snapshots or releases of the site’s frontend.

##### File structure
- Top-level files:
- CTFs.json – likely a metadata index for challenges.
- index.html – the current site entry point.
- v1/index.html, v2/index.html – historical versions.
- Logo – static asset (image or folder).
- README.md – project description.
- Directory “WriteUps”:
- Subdirectories per CTF event, each containing writeup.md (markdown) and any embedded assets (e.g., tmp1.pdf).
- There are no server configurations (no .env, no package.json, no build scripts). This is pure static content.

##### README for additional insights
- The README is minimal and simply names the project. No architectural details are provided.
- We deduce that content is maintained by hand and published as HTML.

##### Elements
- Clear labels:
- “User Browser”
- “Static File Hosting (CDN/Nginx)”
- “Git Repository (WriteUps + site files)”
- “Content Folder” and “Versioned Releases”
- User request → CDN → Serve HTML/CSS
- Git commit → (optional) CI/CD pipeline → CDN
- Yellow for actors (User, Contributor)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    User["User Browser"]:::actor
    Contributor["CTF Contributor"]:::actor

    %% CI/CD
    CI["CI/CD Pipeline"]:::process

    %% Hosting
    CDN["Static File Hosting (CDN/Nginx)"]:::storage

    %% Git Repository and content
    subgraph "Git Repository"
        direction TB
        CTFs["CTF Metadata Index"]:::content
        Readme["Project Description (README)"]:::content
        Logo["Logo Asset"]:::asset
        SiteIndex["Current Site Entry Point"]:::content
        V1["Version v1"]:::content
        V2["Version v2"]:::content

        subgraph "Write-Ups Directory"
            direction TB
            WriteUpsDir["Write-Ups Directory"]:::content
            BreakWriteUp["Break_the_Syntax_2025 Write-Up"]:::content
            tmp1["Break_the_Syntax_2025 Embedded Asset"]:::asset
            CaptureWriteUp["Capturepoint5353_3.0 Write-Up"]:::content
            DawgWriteUp["Dawg_CTF Write-Up"]:::content
        end
    end

    %% Flows
    Contributor -->|commits content| CTFs
    Contributor --> Readme
    Contributor --> Logo
    Contributor --> SiteIndex
    Contributor --> V1
    Contributor --> V2
    Contributor --> WriteUpsDir

    CTFs & Readme & Logo & SiteIndex & V1 & V2 & WriteUpsDir -->|updates trigger| CI
    CI -->|deploys static files| CDN
    User -->|requests site| CDN
    CDN -->|serves content| User

    %% Click Events
    click CTFs "https://github.com/chaitanyap28/writeupctf/blob/main/CTFs.json"
    click Readme "https://github.com/chaitanyap28/writeupctf/blob/main/README.md"
    click Logo "https://github.com/chaitanyap28/writeupctf/tree/main/Logo"
    click SiteIndex "https://github.com/chaitanyap28/writeupctf/blob/main/index.html"
    click V1 "https://github.com/chaitanyap28/writeupctf/blob/main/v1/index.html"
    click V2 "https://github.com/chaitanyap28/writeupctf/blob/main/v2/index.html"
    click WriteUpsDir "https://github.com/chaitanyap28/writeupctf/tree/main/WriteUps/"
    click BreakWriteUp "https://github.com/chaitanyap28/writeupctf/blob/main/WriteUps/Break_the_Syntax_2025/writeup.md"
    click tmp1 "https://github.com/chaitanyap28/writeupctf/blob/main/WriteUps/Break_the_Syntax_2025/tmp1.pdf"
    click CaptureWriteUp "https://github.com/chaitanyap28/writeupctf/blob/main/WriteUps/Capturepoint5353_3.0/writeup.md"
    click DawgWriteUp "https://github.com/chaitanyap28/writeupctf/blob/main/WriteUps/Dawg_CTF/writeup.md"

    %% Styles
    classDef actor fill:#f9f,stroke:#333,stroke-width:1px
    classDef storage fill:#cff,stroke:#333,stroke-width:1px
    classDef content fill:#cfc,stroke:#333,stroke-width:1px
    classDef asset fill:#efe,stroke:#333,stroke-width:1px
    classDef process fill:#fcf,stroke:#333,stroke-width:1px
```
