# ashusharma1999/hindi-dsl-react architecture

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

- Interactive diagram: https://gitdiagram.com/ashusharma1999/hindi-dsl-react
- Repository: https://github.com/ashusharma1999/hindi-dsl-react

## Overview

##### Project type and purpose
- This is a single-page frontend application (built with Create React App) that introduces a custom Hindi DSL (“.ved” files) on top of React.
- Purpose: let developers write React components in Hindi syntax, transpile them to JSX, and render them in the browser using Material UI.

##### File structure
- Top-level:
- package.json / package-lock.json: Node.js + npm config, dependency list, custom script “transpile-ved.”
- transpile-ved.js: CLI script that parses/transforms .ved into .jsx/JS.
- public/: static assets (index.html, manifest.json, robots.txt).
- src/: React source code and assets.
– App.js, Ganaka.jsx: core components.
– Ganaka.ved: Hindi DSL component.
– index.js: React entry point.
– reportWebVitals.js, setupTests.js, App.test.js: logging & tests.
- It follows the CRA convention and adds a custom DSL preprocessing step.

##### README for insights
- Built on React.js via Create React App.
- Custom script “npm run transpile-ved” to convert .ved files.
- Uses Material UI for styling and component library.
- Target audience: Hindi-speaking learners and developers.

## Diagram (Mermaid)

```mermaid
flowchart TD
    Developer["Developer"]:::actor

    subgraph "Source Code"
      DSL["Ganaka.ved"]:::source
      Generated["Ganaka.jsx"]:::source
      AppJS["App.js"]:::source
      AppCSS["App.css"]:::source
      IndexJS["index.js"]:::source
    end

    subgraph "Instrumentation & Tests"
      RVital["reportWebVitals.js"]:::source
      SetupTests["setupTests.js"]:::source
      AppTest["App.test.js"]:::source
    end

    Developer --> DSL
    Developer --> AppJS
    Developer --> AppCSS
    Developer --> IndexJS
    Developer --> RVital
    Developer --> SetupTests
    Developer --> AppTest

    DSL --> VedTranspiler["VedTranspiler<br>(transpile-ved.js)"]:::tools
    click VedTranspiler "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/transpile-ved.js"
    VedTranspiler --> Generated

    Generated --> BuildPipeline["React Build Pipeline<br>(CRA: Babel + Webpack)"]:::tools
    AppJS --> BuildPipeline
    AppCSS --> BuildPipeline
    IndexJS --> BuildPipeline

    PackageJSON["package.json"]:::toolconfig
    PackageLock["package-lock.json"]:::toolconfig
    PackageJSON --> BuildPipeline
    PackageLock --> BuildPipeline
    click PackageJSON "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/package.json"
    click PackageLock "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/package-lock.json"

    BuildPipeline --> Bundle["bundle.js"]:::runtime

    subgraph "Static Assets"
      PublicIndex["index.html"]:::runtime
      Manifest["manifest.json"]:::runtime
      Robots["robots.txt"]:::runtime
    end
    click PublicIndex "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/public/index.html"
    click Manifest "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/public/manifest.json"
    click Robots "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/public/robots.txt"

    Bundle --> StaticServer["Static Server / Host"]:::runtime
    PublicIndex --> StaticServer
    Manifest --> StaticServer
    Robots --> StaticServer

    StaticServer --> Browser["Browser<br>(SPA Runtime)"]:::runtime
    MUI["Material UI Library"]:::external
    Browser --> MUI

    click DSL "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/src/Ganaka.ved"
    click Generated "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/src/Ganaka.jsx"
    click AppJS "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/src/App.js"
    click AppCSS "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/src/App.css"
    click IndexJS "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/src/index.js"
    click RVital "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/src/reportWebVitals.js"
    click SetupTests "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/src/setupTests.js"
    click AppTest "https://github.com/ashusharma1999/hindi-dsl-react/blob/main/src/App.test.js"

    classDef actor fill:#ccc,stroke:#333,stroke-width:2px
    classDef source fill:#bfb,stroke:#080,stroke-width:1px
    classDef tools fill:#bbf,stroke:#00f,stroke-width:1px
    classDef toolconfig fill:#ddf,stroke:#00f,stroke-width:1px
    classDef runtime fill:#fba,stroke:#f50,stroke-width:1px
    classDef external fill:#ffe600,stroke:#bb0,stroke-width:1px
```
