# santanu-p/ai-tools architecture

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

- Interactive diagram: https://gitdiagram.com/santanu-p/ai-tools
- Repository: https://github.com/santanu-p/ai-tools

## Overview

##### Project type and purpose
- This is a lightweight, front-end–only, static website “AI Tools Directory” that aggregates and compares 100+ AI applications.
- It’s deployed to GitHub Pages, built with HTML5, Tailwind CSS, and vanilla JavaScript, and uses the browser’s LocalStorage API to persist like/view counts. Affiliate links drive monetization.

##### File structure
- Top-level assets: index.html, affiliate.html, other-affiliate.html, script.js
- No backend code—pure static hosting; no server-side components.
- script.js contains filtering/search logic and LocalStorage integration.

##### Key architectural insights from the README
- Smart Search & compare logic lives in the client.
- SEO via meta tags, Open Graph, Twitter cards in the HTML.
- Responsive UI powered by Tailwind CSS.
- “Affiliate Ready”—clicking links directs users to external affiliate partners.
- Deployment on GitHub Pages means a simple static file host.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Static Hosting Layer
    subgraph "Static Hosting (GitHub Pages)"
        direction TB
        LICENSE["LICENSE"]:::frontend
        README["README.md"]:::frontend
        IDX["index.html"]:::frontend
        AFF["affiliate.html"]:::frontend
        OAF["other-affiliate.html"]:::frontend
        SITEMAP["sitemap.xml"]:::frontend
        GVER["google8c375ed03477c2e3.html"]:::frontend
        FAVICO["favicon_io/"]:::frontend
    end

    %% Client Layer
    subgraph "Browser (Client)"
        direction TB
        BUI["Browser UI"]:::frontend
        SCRIPT["Client-Side Logic (script.js)"]:::frontend
        STORAGE["LocalStorage"]:::storage
    end

    %% External Integrations
    subgraph "External Services"
        direction TB
        AFFSERV["Affiliate Partner"]:::external
        SEOBOT["SEO Bot / Crawler"]:::external
    end

    %% Interactions
    BUI -->|"GET static assets"| IDX
    BUI -->|"GET static assets"| AFF
    BUI -->|"GET static assets"| OAF
    BUI -->|"GET static assets"| SITEMAP
    BUI -->|"GET static assets"| GVER
    BUI -->|"GET static assets"| FAVICO

    BUI -->|"render & meta parsing"| BUI
    BUI -->|"execute scripts"| SCRIPT
    SCRIPT -->|"read/write counts"| STORAGE
    BUI -->|"outbound click"| AFFSERV
    SEOBOT -->|"crawl HTML/OG tags"| IDX

    %% Click Events for component mapping
    click LICENSE "https://github.com/santanu-p/ai-tools/tree/main/LICENSE"
    click README "https://github.com/santanu-p/ai-tools/blob/main/README.md"
    click IDX "https://github.com/santanu-p/ai-tools/blob/main/index.html"
    click AFF "https://github.com/santanu-p/ai-tools/blob/main/affiliate.html"
    click OAF "https://github.com/santanu-p/ai-tools/blob/main/other-affiliate.html"
    click SCRIPT "https://github.com/santanu-p/ai-tools/blob/main/script.js"
    click SITEMAP "https://github.com/santanu-p/ai-tools/blob/main/sitemap.xml"
    click GVER "https://github.com/santanu-p/ai-tools/blob/main/google8c375ed03477c2e3.html"
    click FAVICO "https://github.com/santanu-p/ai-tools/tree/main/favicon_io/"

    %% Styles
    classDef frontend fill:#E3F2FD,stroke:#2196F3,color:#0D47A1
    classDef storage fill:#E8F5E9,stroke:#4CAF50,color:#1B5E20
    classDef external fill:#FFF3E0,stroke:#FF9800,color:#E65100
```
