# akbkgk/sankalpam-generator architecture

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

- Interactive diagram: https://gitdiagram.com/akbkgk/sankalpam-generator
- Repository: https://github.com/akbkgk/sankalpam-generator

## Overview

Saṅkalpam Generator is a browser-based ritual text and pañcāṅgam app. The main workflow is to choose a calendar method, date and location, enter personal and family details, then prepare and copy, print or save the saṅkalpam or tarpaṇam. The README also describes calendar and tarpaṇam-day tools, local-only profile storage, and optional feedback and email services. No source excerpts were available, so component paths point to the listed app entry file and relationships rely on README statements only.

Main entry points: [`index.html`](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html) (Browser app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Inputs and preferences"]
  node_app["Browser app<br/>[index.html]"]
  node_profile["Personal details<br/>[index.html]"]
  node_family["Family details<br/>[index.html]"]
  node_preferences["Calendar and script<br/>[index.html]"]
end

subgraph group_calendar["Pañcāṅgam tools"]
  node_location["City and date<br/>[index.html]"]
  node_vakya["Vākya calculation<br/>[index.html]"]
  node_drik["Tirukkaṇita calculation<br/>[index.html]"]
  node_calendarview["Pañcāṅgam calendar<br/>[index.html]"]
  node_dayfinder["Tarpaṇam day finder<br/>[index.html]"]
end

subgraph group_ritual["Ritual text and output"]
  node_sankalpam["Saṅkalpam text<br/>[index.html]"]
  node_tarpa["Tarpaṇam text<br/>[index.html]"]
  node_chants["Chant selection<br/>[index.html]"]
  node_export["Copy and PDF<br/>[index.html]"]
end

subgraph group_services["Storage and services"]
  node_device[("Device storage<br/>[index.html]")]
  node_feedback["Google Form"]
  node_email["Email subscription<br/>[index.html]"]
  node_sheet[("Private Google Sheet")]
end

node_user(("User"))

node_user -->|"opens"| node_app
node_app -->|"accepts details"| node_profile
node_app -->|"accepts details"| node_family
node_app -->|"sets preferences"| node_preferences
node_app -->|"uses city"| node_location
node_location -->|"calculates at sunrise"| node_vakya
node_location -->|"calculates at sunrise"| node_drik
node_preferences -->|"selects method"| node_vakya
node_preferences -->|"selects method"| node_drik
node_app -->|"provides calendar"| node_calendarview
node_app -->|"finds ritual dates"| node_dayfinder
node_app -->|"prepares text"| node_sankalpam
node_app -->|"prepares text"| node_tarpa
node_chants -->|"selects chants"| node_sankalpam
node_profile -->|"personalizes"| node_sankalpam
node_family -->|"personalizes"| node_tarpa
node_preferences -->|"sets script"| node_sankalpam
node_preferences -->|"sets script"| node_tarpa
node_sankalpam -->|"exports"| node_export
node_tarpa -->|"exports"| node_export
node_profile -->|"saves locally"| node_device
node_family -->|"saves locally"| node_device
node_user -.->|"sends feedback"| node_feedback
node_user -.->|"subscribes"| node_email
node_email -.->|"stores subscription"| node_sheet

click node_app "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_profile "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_family "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_preferences "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_location "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_vakya "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_drik "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_calendarview "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_dayfinder "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_sankalpam "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_tarpa "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_chants "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_export "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_device "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"
click node_email "https://github.com/akbkgk/sankalpam-generator/blob/main/index.html"

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_app,node_profile,node_family,node_preferences,node_user toneBlue
class node_location,node_vakya,node_drik,node_calendarview,node_dayfinder toneAmber
class node_sankalpam,node_tarpa,node_chants,node_export toneMint
class node_device,node_feedback,node_email,node_sheet toneRose
```

## Components

### Inputs and preferences

- [Browser app](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- [Personal details](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- [Family details](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- [Calendar and script](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`

### Pañcāṅgam tools

- [City and date](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- [Vākya calculation](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- [Tirukkaṇita calculation](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- [Pañcāṅgam calendar](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- [Tarpaṇam day finder](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`

### Ritual text and output

- [Saṅkalpam text](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- [Tarpaṇam text](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- [Chant selection](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- [Copy and PDF](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`

### Storage and services

- [Device storage](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- **Google Form**
- [Email subscription](https://github.com/akbkgk/sankalpam-generator/blob/main/index.html): `index.html`
- **Private Google Sheet**

### Other components

- **User**

## Connections

- User → Browser app: opens (evidence: `README.md`)
- Browser app → Personal details: accepts details (evidence: `README.md`)
- Browser app → Family details: accepts details (evidence: `README.md`)
- Browser app → Calendar and script: sets preferences (evidence: `README.md`)
- Browser app → City and date: uses city (evidence: `README.md`)
- City and date → Vākya calculation: calculates at sunrise (evidence: `README.md`)
- City and date → Tirukkaṇita calculation: calculates at sunrise (evidence: `README.md`)
- Calendar and script → Vākya calculation: selects method (evidence: `README.md`)
- Calendar and script → Tirukkaṇita calculation: selects method (evidence: `README.md`)
- Browser app → Pañcāṅgam calendar: provides calendar (evidence: `README.md`)
- Browser app → Tarpaṇam day finder: finds ritual dates (evidence: `README.md`)
- Browser app → Saṅkalpam text: prepares text (evidence: `README.md`)
- Browser app → Tarpaṇam text: prepares text (evidence: `README.md`)
- Chant selection → Saṅkalpam text: selects chants (evidence: `README.md`)
- Personal details → Saṅkalpam text: personalizes (evidence: `README.md`)
- Family details → Tarpaṇam text: personalizes (evidence: `README.md`)
- Calendar and script → Saṅkalpam text: sets script (evidence: `README.md`)
- Calendar and script → Tarpaṇam text: sets script (evidence: `README.md`)
- Saṅkalpam text → Copy and PDF: exports (evidence: `README.md`)
- Tarpaṇam text → Copy and PDF: exports (evidence: `README.md`)
- Personal details → Device storage: saves locally (evidence: `README.md`)
- Family details → Device storage: saves locally (evidence: `README.md`)
- User → Google Form: sends feedback (evidence: `README.md`)
- User → Email subscription: subscribes (evidence: `README.md`)
- Email subscription → Private Google Sheet: stores subscription (evidence: `README.md`)
