# evavic44/portfolio-ideas architecture

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

- Interactive diagram: https://gitdiagram.com/evavic44/portfolio-ideas
- Repository: https://github.com/evavic44/portfolio-ideas

## Overview

- Repository & Version Control: The source code is hosted on GitHub. Include elements such as the repository itself, the “.all-contributorsrc”, “.gitattributes”, “.gitignore”, and contribution documents (CODE_OF_CONDUCT, CONTRIBUTING, LICENSE).
- Documentation/Content Module: The “docs” directory holds the markdown content and the VitePress configuration (within docs/.vitepress). This is the “frontend” content component that renders the static site.
- Build Process & Static Site Generation: Indicate that VitePress is used to process the markdown into a static site. Show the “package.json”, “package-lock.json”, and an “extract.sh” script (which may be used to update or extract portfolio data) as parts of the build tools.
- CI/CD Pipeline: Represent GitHub Actions workflows (found under .github/workflows, for example, “autodeploy.yml”) that automatically build, test (using husky pre-commit hooks in the “.husky” folder), and deploy the site.

##### Relationships and data flow
- Commits and pull requests flowing from contributors into the GitHub repository.

##### Design principles and external integrations
- That a static site generation pattern is used, which separates content (markdown files and docs) from build and deployment.
- That the repository adopts community-driven contributions; label elements for issue/templates and all-contributors.
- If desired, include annotations for design patterns (e.g., “Documentation-as-Code”, “CI/CD Pipeline”, “Pull Request-Based Contributions”).

## Diagram (Mermaid)

```mermaid
graph TD
    %% External Actors
    Contributor("Contributor"):::external
    User("User"):::external

    %% Source Repository & Version Control Subgraph
    subgraph "Source Repository & Version Control"
        Repo("GitHub Repository"):::repo
        AC(".all-contributorsrc"):::repo_item
        GA(".gitattributes"):::repo_item
        CoC("CODE_OF_CONDUCT.md"):::repo_item
        Contrib("CONTRIBUTING.md"):::repo_item
        License("LICENSE"):::repo_item
    end

    %% Documentation/Content Module Subgraph
    subgraph "Documentation/Content Module"
        Docs("Docs Content"):::doc
        Vite("VitePress Config"):::doc
    end

    %% Build Process & Static Site Generation Subgraph
    subgraph "Build Process & Static Site Generation"
        Pkg("Package Config"):::build
        Extract("extract.sh"):::build
    end

    %% CI/CD Pipeline Subgraph
    subgraph "CI/CD Pipeline"
        Workflows("GitHub Workflows"):::cicd
        Husky("Husky Pre-commit"):::cicd
        Templates("Contribution Templates"):::cicd
    end

    %% Deployment Environment
    Deploy("Deployment Environment"):::deploy

    %% Relationships
    Contributor -->|"Commit/PR"| Repo
    Repo -->|"Triggers"| Workflows
    Repo -->|"Runs"| Husky
    Repo -->|"Includes"| Templates
    Repo -->|"Holds"| Docs
    Docs -->|"Processed by"| Pkg
    Vite -->|"Configures"| Pkg
    Workflows -->|"Executes build"| Pkg
    Pkg -->|"Builds Site"| Extract
    Extract -->|"Generates Static Site"| Deploy
    Deploy -->|"Serves"| User

    %% Styles
    classDef external fill:#e0e0e0,stroke:#333,stroke-width:2px;
    classDef repo fill:#a3c4f3,stroke:#333,stroke-width:2px;
    classDef repo_item fill:#c6e2ff,stroke:#333,stroke-width:1px;
    classDef doc fill:#b2f2bb,stroke:#333,stroke-width:2px;
    classDef build fill:#ffe5b4,stroke:#333,stroke-width:2px;
    classDef cicd fill:#dcb1ff,stroke:#333,stroke-width:2px;
    classDef deploy fill:#ffadad,stroke:#333,stroke-width:2px;

    %% Click Events
    click AC "https://github.com/evavic44/portfolio-ideas/blob/main/.all-contributorsrc"
    click GA "https://github.com/evavic44/portfolio-ideas/blob/main/.gitattributes"
    click CoC "https://github.com/evavic44/portfolio-ideas/blob/main/CODE_OF_CONDUCT.md"
    click Contrib "https://github.com/evavic44/portfolio-ideas/blob/main/CONTRIBUTING.md"
    click License "https://github.com/evavic44/portfolio-ideas/tree/main/LICENSE"
    click Docs "https://github.com/evavic44/portfolio-ideas/tree/main/docs/"
    click Vite "https://github.com/evavic44/portfolio-ideas/tree/main/docs/.vitepress/"
    click Pkg "https://github.com/evavic44/portfolio-ideas/blob/main/package.json"
    click Extract "https://github.com/evavic44/portfolio-ideas/blob/main/extract.sh"
    click Workflows "https://github.com/evavic44/portfolio-ideas/tree/main/.github/workflows/"
    click Husky "https://github.com/evavic44/portfolio-ideas/tree/main/.husky/"
    click Templates "https://github.com/evavic44/portfolio-ideas/tree/main/.github/ISSUE_TEMPLATE/"
```
