# saemali/tools-site architecture

> Architecture diagram of the GitHub repository saemali/tools-site, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/saemali/tools-site
- Repository: https://github.com/saemali/tools-site

## Overview

FreelanceTools.in is a static site of browser-based money tools and informational guides for Indian freelancers and small businesses. A visitor’s primary workflow is to open a calculator, enter financial details, and view an estimate; the sampled JavaScript implements GST, TDS, EMI, tax-regime, late-fee, and invoice calculations. The site also provides a guide library and a Secret Santa generator. The README documents static hosting, while the excerpts do not show page-to-script wiring or the generator’s implementation, so those relationships are left unverified.

Main entry points: [`app.js`](https://github.com/saemali/tools-site/blob/main/app.js) (Calculator logic), [`build.py`](https://github.com/saemali/tools-site/blob/main/build.py) (Site generation), [`gst.html`](https://github.com/saemali/tools-site/blob/main/gst.html) (GST calculator), [`tds.html`](https://github.com/saemali/tools-site/blob/main/tds.html) (TDS calculator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tools["Money tools"]
  node_calcjs["Calculator logic<br/>[app.js]"]
  node_gst["GST calculator<br/>[gst.html]"]
  node_tds["TDS calculator<br/>[tds.html]"]
  node_emi["EMI calculator<br/>[emi.html]"]
  node_regime["Tax regimes<br/>[regime.html]"]
  node_latefee["GST late fee<br/>[gst-late-fee.html]"]
  node_invoice["Invoice generator<br/>[invoice.html]"]
  node_santa["Secret Santa"]
  node_santajs["Santa logic<br/>[secret-santa.js]"]
end

subgraph group_guides["Guides and articles"]
  node_guidesindex["Guide library<br/>[guides.html]"]
  node_content["Guide content"]
  node_articles["Published articles"]
end

subgraph group_site["Site experience"]
  node_home["Home<br/>[index.html]"]
  node_build["Site generation<br/>[build.py]"]
  node_style["Site styling<br/>[style.css]"]
end

node_visitor(("Visitor"))

node_visitor -.->|"opens"| node_home
node_visitor -.->|"uses"| node_gst
node_visitor -.->|"uses"| node_tds
node_visitor -.->|"uses"| node_emi
node_visitor -.->|"uses"| node_regime
node_visitor -.->|"uses"| node_latefee
node_visitor -.->|"uses"| node_invoice
node_visitor -.->|"uses"| node_santa
node_visitor -.->|"reads"| node_guidesindex
node_calcjs -.->|"renders"| node_gst
node_calcjs -.->|"renders"| node_tds
node_calcjs -.->|"renders"| node_emi
node_calcjs -.->|"renders"| node_regime
node_calcjs -.->|"renders"| node_latefee
node_calcjs -.->|"renders"| node_invoice
node_build -->|"generates"| node_guidesindex
node_build -->|"generates"| node_articles

click node_home "https://github.com/saemali/tools-site/blob/main/index.html"
click node_calcjs "https://github.com/saemali/tools-site/blob/main/app.js"
click node_gst "https://github.com/saemali/tools-site/blob/main/gst.html"
click node_tds "https://github.com/saemali/tools-site/blob/main/tds.html"
click node_emi "https://github.com/saemali/tools-site/blob/main/emi.html"
click node_regime "https://github.com/saemali/tools-site/blob/main/regime.html"
click node_latefee "https://github.com/saemali/tools-site/blob/main/gst-late-fee.html"
click node_invoice "https://github.com/saemali/tools-site/blob/main/invoice.html"
click node_santa "https://github.com/saemali/tools-site/blob/main/secret-santa-generator.html"
click node_santajs "https://github.com/saemali/tools-site/blob/main/secret-santa.js"
click node_guidesindex "https://github.com/saemali/tools-site/blob/main/guides.html"
click node_content "https://github.com/saemali/tools-site/tree/main/content"
click node_articles "https://github.com/saemali/tools-site/blob/main/advance-tax-for-freelancers.html"
click node_build "https://github.com/saemali/tools-site/blob/main/build.py"
click node_style "https://github.com/saemali/tools-site/blob/main/style.css"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_calcjs,node_gst,node_tds,node_emi,node_regime,node_latefee,node_invoice,node_santa,node_santajs toneBlue
class node_guidesindex,node_content,node_articles toneAmber
class node_home,node_build,node_style toneMint
class node_visitor toneIndigo
```

## Components

### Money tools

- [Calculator logic](https://github.com/saemali/tools-site/blob/main/app.js): `app.js`
- [GST calculator](https://github.com/saemali/tools-site/blob/main/gst.html): `gst.html`
- [TDS calculator](https://github.com/saemali/tools-site/blob/main/tds.html): `tds.html`
- [EMI calculator](https://github.com/saemali/tools-site/blob/main/emi.html): `emi.html`
- [Tax regimes](https://github.com/saemali/tools-site/blob/main/regime.html): `regime.html`
- [GST late fee](https://github.com/saemali/tools-site/blob/main/gst-late-fee.html): `gst-late-fee.html`
- [Invoice generator](https://github.com/saemali/tools-site/blob/main/invoice.html): `invoice.html`
- [Secret Santa](https://github.com/saemali/tools-site/blob/main/secret-santa-generator.html): `secret-santa-generator.html`
- [Santa logic](https://github.com/saemali/tools-site/blob/main/secret-santa.js): `secret-santa.js`

### Guides and articles

- [Guide library](https://github.com/saemali/tools-site/blob/main/guides.html): `guides.html`
- [Guide content](https://github.com/saemali/tools-site/tree/main/content): `content`
- [Published articles](https://github.com/saemali/tools-site/blob/main/advance-tax-for-freelancers.html): `advance-tax-for-freelancers.html`

### Site experience

- [Home](https://github.com/saemali/tools-site/blob/main/index.html): `index.html`
- [Site generation](https://github.com/saemali/tools-site/blob/main/build.py): `build.py`
- [Site styling](https://github.com/saemali/tools-site/blob/main/style.css): `style.css`

### Other components

- **Visitor**

## Connections

- Visitor → Home: opens
- Visitor → GST calculator: uses
- Visitor → TDS calculator: uses
- Visitor → EMI calculator: uses
- Visitor → Tax regimes: uses
- Visitor → GST late fee: uses
- Visitor → Invoice generator: uses
- Visitor → Secret Santa: uses
- Visitor → Guide library: reads
- Calculator logic → GST calculator: renders
- Calculator logic → TDS calculator: renders
- Calculator logic → EMI calculator: renders
- Calculator logic → Tax regimes: renders
- Calculator logic → GST late fee: renders
- Calculator logic → Invoice generator: renders
- Site generation → Guide library: generates (evidence: `build.py`)
- Site generation → Published articles: generates (evidence: `build.py`)
