# sahilsleem/studentkit architecture

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

- Interactive diagram: https://gitdiagram.com/sahilsleem/studentkit
- Repository: https://github.com/sahilsleem/studentkit

## Overview

StudentKit is a browser-based collection of academic tools, assessments, and short cognitive exercises. The intended user journey is to choose a tool or exercise, work with it locally, and get a result; however, the supplied tree contains no page or component sources, so the UI-to-computation path cannot be verified. The graph therefore focuses on the documented product catalog and the sampled search, chemistry, and genetics logic, plus the assessment and Anti-Brainrot data subsystems. Several product areas are documented but their runtime wiring is not shown.

Main entry points: [`src/data/registry.ts`](https://github.com/sahilsleem/studentkit/blob/main/src/data/registry.ts) (Academic Tools), [`src/utils/chemicalParser.ts`](https://github.com/sahilsleem/studentkit/blob/main/src/utils/chemicalParser.ts) (Formula Parser), [`src/utils/equationBalancer.ts`](https://github.com/sahilsleem/studentkit/blob/main/src/utils/equationBalancer.ts) (Equation Balancer), [`src/utils/dna.ts`](https://github.com/sahilsleem/studentkit/blob/main/src/utils/dna.ts) (DNA Utilities)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_catalog["Tool Catalog"]
  node_tool_catalog["Academic Tools<br/>[registry.ts]"]
  node_search["Tool Search<br/>[searchEngine.ts]"]
  node_related["Related Tools<br/>[relatedTools.ts]"]
  node_tool_content["Tool Content<br/>[toolContent.ts]"]
end

subgraph group_science["Science Utilities"]
  node_chemistry["Chemistry Reference Data"]
  node_formula_parser["Formula Parser<br/>[chemicalParser.ts]"]
  node_equation_balancer["Equation Balancer"]
  node_periodic_table["Periodic Table<br/>[periodicTable.ts]"]
  node_genetics["DNA Utilities<br/>[dna.ts]"]
  node_genetic_code["Genetic Code<br/>[geneticCode.ts]"]
end

subgraph group_assessments["Assessments"]
  node_assessment_catalog["Assessment Catalog<br/>[testsRegistry.ts]"]
end

subgraph group_training["Anti-Brainrot"]
  node_brainrot_catalog["Training Catalog"]
  node_brainrot_questions["Exercise Data"]
end

node_student(("Student"))

node_student -->|"chooses tools"| node_tool_catalog
node_tool_catalog -->|"indexes tools"| node_search
node_tool_catalog -->|"selects related"| node_related
node_formula_parser -->|"reads masses"| node_chemistry
node_equation_balancer -->|"parses formulas"| node_formula_parser
node_genetics -->|"translates codons"| node_genetic_code

click node_tool_catalog "https://github.com/sahilsleem/studentkit/blob/main/src/data/registry.ts"
click node_search "https://github.com/sahilsleem/studentkit/blob/main/src/utils/searchEngine.ts"
click node_related "https://github.com/sahilsleem/studentkit/blob/main/src/utils/relatedTools.ts"
click node_tool_content "https://github.com/sahilsleem/studentkit/blob/main/src/data/toolContent.ts"
click node_chemistry "https://github.com/sahilsleem/studentkit/blob/main/src/utils/chemistryConstants.ts"
click node_formula_parser "https://github.com/sahilsleem/studentkit/blob/main/src/utils/chemicalParser.ts"
click node_equation_balancer "https://github.com/sahilsleem/studentkit/blob/main/src/utils/equationBalancer.ts"
click node_periodic_table "https://github.com/sahilsleem/studentkit/blob/main/src/data/periodicTable.ts"
click node_genetics "https://github.com/sahilsleem/studentkit/blob/main/src/utils/dna.ts"
click node_genetic_code "https://github.com/sahilsleem/studentkit/blob/main/src/data/geneticCode.ts"
click node_assessment_catalog "https://github.com/sahilsleem/studentkit/blob/main/src/data/testsRegistry.ts"
click node_brainrot_catalog "https://github.com/sahilsleem/studentkit/blob/main/src/data/antiBrainrotRegistry.ts"
click node_brainrot_questions "https://github.com/sahilsleem/studentkit/tree/main/src/data/antiBrainrot"

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_tool_catalog,node_search,node_related,node_tool_content toneBlue
class node_chemistry,node_formula_parser,node_equation_balancer,node_periodic_table,node_genetics,node_genetic_code toneAmber
class node_assessment_catalog toneMint
class node_brainrot_catalog,node_brainrot_questions toneRose
class node_student toneIndigo
```

## Components

### Tool Catalog

- [Academic Tools](https://github.com/sahilsleem/studentkit/blob/main/src/data/registry.ts): `src/data/registry.ts`
- [Tool Search](https://github.com/sahilsleem/studentkit/blob/main/src/utils/searchEngine.ts): `src/utils/searchEngine.ts`
- [Related Tools](https://github.com/sahilsleem/studentkit/blob/main/src/utils/relatedTools.ts): `src/utils/relatedTools.ts`
- [Tool Content](https://github.com/sahilsleem/studentkit/blob/main/src/data/toolContent.ts): `src/data/toolContent.ts`

### Science Utilities

- [Chemistry Reference Data](https://github.com/sahilsleem/studentkit/blob/main/src/utils/chemistryConstants.ts): `src/utils/chemistryConstants.ts`
- [Formula Parser](https://github.com/sahilsleem/studentkit/blob/main/src/utils/chemicalParser.ts): `src/utils/chemicalParser.ts`
- [Equation Balancer](https://github.com/sahilsleem/studentkit/blob/main/src/utils/equationBalancer.ts): `src/utils/equationBalancer.ts`
- [Periodic Table](https://github.com/sahilsleem/studentkit/blob/main/src/data/periodicTable.ts): `src/data/periodicTable.ts`
- [DNA Utilities](https://github.com/sahilsleem/studentkit/blob/main/src/utils/dna.ts): `src/utils/dna.ts`
- [Genetic Code](https://github.com/sahilsleem/studentkit/blob/main/src/data/geneticCode.ts): `src/data/geneticCode.ts`

### Assessments

- [Assessment Catalog](https://github.com/sahilsleem/studentkit/blob/main/src/data/testsRegistry.ts): `src/data/testsRegistry.ts`

### Anti-Brainrot

- [Training Catalog](https://github.com/sahilsleem/studentkit/blob/main/src/data/antiBrainrotRegistry.ts): `src/data/antiBrainrotRegistry.ts`
- [Exercise Data](https://github.com/sahilsleem/studentkit/tree/main/src/data/antiBrainrot): `src/data/antiBrainrot`

### Other components

- **Student**

## Connections

- Student → Academic Tools: chooses tools (evidence: `README.md`)
- Academic Tools → Tool Search: indexes tools (evidence: `src/utils/searchEngine.ts`)
- Academic Tools → Related Tools: selects related (evidence: `src/utils/relatedTools.ts`)
- Formula Parser → Chemistry Reference Data: reads masses (evidence: `src/utils/chemicalParser.ts`)
- Equation Balancer → Formula Parser: parses formulas (evidence: `src/utils/equationBalancer.ts`)
- DNA Utilities → Genetic Code: translates codons (evidence: `src/utils/dna.ts`)
