# beautifulai/pptxgenjs architecture

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

- Interactive diagram: https://gitdiagram.com/beautifulai/pptxgenjs
- Repository: https://github.com/beautifulai/pptxgenjs

## Overview

PptxGenJS is a JavaScript library for building OOXML PowerPoint presentations. Its main workflow is to create a presentation, add slides and content, then serialize and export a PPTX file. The graph includes documented chart, media, master-slide, and HTML-table capabilities, plus the internal generators that turn slide content into OOXML. Connections among implementation modules are based on the README workflow and SOURCE INDEX references; unsampled implementation details are not assumed.

Main entry points: [`src/pptxgen.ts`](https://github.com/beautifulai/pptxgenjs/blob/main/src/pptxgen.ts) (Presentation), [`src/gen-objects.ts`](https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-objects.ts) (Shapes and Images), [`src/gen-utils.ts`](https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-utils.ts) (Generation Utilities), [`src/core-interfaces.ts`](https://github.com/beautifulai/pptxgenjs/blob/main/src/core-interfaces.ts) (Data Interfaces)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Presentation API"]
  node_presentation["Presentation<br/>[pptxgen.ts]"]
  node_slide["Slide<br/>[slide.ts]"]
end

subgraph group_content["Slide Content"]
  node_tables["Tables and HTML<br/>[gen-tables.ts]"]
  node_objects["Shapes and Images<br/>[gen-objects.ts]"]
  node_charts["Charts<br/>[gen-charts.ts]"]
  node_media["Media<br/>[gen-media.ts]"]
end

subgraph group_generation["OOXML Generation"]
  node_xml["OOXML Serializer<br/>[gen-xml.ts]"]
  node_paragraph["Paragraphs<br/>[paragraph.ts]"]
  node_bullets["Bullets<br/>[bullet.ts]"]
  node_textprops["Text Properties<br/>[properties.ts]"]
  node_utilities["Generation Utilities<br/>[gen-utils.ts]"]
  node_imageutils["Image Utilities<br/>[imageUtils.ts]"]
end

subgraph group_support["Shared Types"]
  node_enums["Enums<br/>[core-enums.ts]"]
  node_interfaces["Data Interfaces<br/>[core-interfaces.ts]"]
end

node_developer(("Library User"))
node_archive["JSZip"]
node_pptxfile["PPTX File"]

node_developer -->|"creates"| node_presentation
node_presentation -->|"adds slides"| node_slide
node_developer -->|"adds content"| node_slide
node_presentation -->|"adds objects"| node_objects
node_presentation -->|"adds charts"| node_charts
node_presentation -->|"adds media"| node_media
node_presentation -->|"converts tables"| node_tables
node_slide -->|"adds objects"| node_objects
node_presentation -->|"encodes media"| node_media
node_presentation -->|"generates OOXML"| node_xml
node_presentation -->|"packages output"| node_archive
node_presentation -->|"writes file"| node_pptxfile
node_objects -->|"uses table generation"| node_tables
node_objects -->|"uses"| node_utilities
node_objects -->|"uses image helpers"| node_imageutils
node_xml -->|"uses"| node_paragraph
node_paragraph -->|"generates bullets"| node_bullets
node_paragraph -->|"generates run properties"| node_textprops
node_xml -->|"uses"| node_utilities
node_charts -->|"uses"| node_utilities
node_tables -->|"uses"| node_utilities
node_presentation -->|"uses"| node_enums
node_presentation -->|"uses"| node_interfaces
node_objects -->|"uses"| node_enums
node_objects -->|"uses"| node_interfaces
node_charts -->|"uses"| node_interfaces
node_media -->|"uses"| node_interfaces
node_imageutils -->|"uses"| node_interfaces
node_imageutils -->|"uses"| node_utilities
node_tables -->|"supports HTML conversion"| node_pptxfile

click node_presentation "https://github.com/beautifulai/pptxgenjs/blob/main/src/pptxgen.ts"
click node_slide "https://github.com/beautifulai/pptxgenjs/blob/main/src/slide.ts"
click node_tables "https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-tables.ts"
click node_objects "https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-objects.ts"
click node_charts "https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-charts.ts"
click node_media "https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-media.ts"
click node_xml "https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-xml.ts"
click node_paragraph "https://github.com/beautifulai/pptxgenjs/blob/main/src/generators/paragraph.ts"
click node_bullets "https://github.com/beautifulai/pptxgenjs/blob/main/src/generators/bullet.ts"
click node_textprops "https://github.com/beautifulai/pptxgenjs/blob/main/src/generators/textRun/properties.ts"
click node_utilities "https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-utils.ts"
click node_imageutils "https://github.com/beautifulai/pptxgenjs/blob/main/src/utils/imageUtils.ts"
click node_enums "https://github.com/beautifulai/pptxgenjs/blob/main/src/core-enums.ts"
click node_interfaces "https://github.com/beautifulai/pptxgenjs/blob/main/src/core-interfaces.ts"

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_presentation,node_slide,node_developer toneBlue
class node_tables,node_objects,node_charts,node_media toneAmber
class node_xml,node_paragraph,node_bullets,node_textprops,node_utilities,node_imageutils toneMint
class node_enums,node_interfaces toneRose
class node_archive,node_pptxfile toneIndigo
```

## Components

### Presentation API

- [Presentation](https://github.com/beautifulai/pptxgenjs/blob/main/src/pptxgen.ts): `src/pptxgen.ts`
- [Slide](https://github.com/beautifulai/pptxgenjs/blob/main/src/slide.ts): `src/slide.ts`

### Slide Content

- [Tables and HTML](https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-tables.ts): `src/gen-tables.ts`
- [Shapes and Images](https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-objects.ts): `src/gen-objects.ts`
- [Charts](https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-charts.ts): `src/gen-charts.ts`
- [Media](https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-media.ts): `src/gen-media.ts`

### OOXML Generation

- [OOXML Serializer](https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-xml.ts): `src/gen-xml.ts`
- [Paragraphs](https://github.com/beautifulai/pptxgenjs/blob/main/src/generators/paragraph.ts): `src/generators/paragraph.ts`
- [Bullets](https://github.com/beautifulai/pptxgenjs/blob/main/src/generators/bullet.ts): `src/generators/bullet.ts`
- [Text Properties](https://github.com/beautifulai/pptxgenjs/blob/main/src/generators/textRun/properties.ts): `src/generators/textRun/properties.ts`
- [Generation Utilities](https://github.com/beautifulai/pptxgenjs/blob/main/src/gen-utils.ts): `src/gen-utils.ts`
- [Image Utilities](https://github.com/beautifulai/pptxgenjs/blob/main/src/utils/imageUtils.ts): `src/utils/imageUtils.ts`

### Shared Types

- [Enums](https://github.com/beautifulai/pptxgenjs/blob/main/src/core-enums.ts): `src/core-enums.ts`
- [Data Interfaces](https://github.com/beautifulai/pptxgenjs/blob/main/src/core-interfaces.ts): `src/core-interfaces.ts`

### Other components

- **Library User**
- **JSZip**
- **PPTX File**

## Connections

- Library User → Presentation: creates (evidence: `README.md`)
- Presentation → Slide: adds slides (evidence: `src/pptxgen.ts`)
- Library User → Slide: adds content (evidence: `README.md`)
- Presentation → Shapes and Images: adds objects (evidence: `src/pptxgen.ts`)
- Presentation → Charts: adds charts (evidence: `src/pptxgen.ts`)
- Presentation → Media: adds media (evidence: `src/pptxgen.ts`)
- Presentation → Tables and HTML: converts tables (evidence: `src/pptxgen.ts`)
- Slide → Shapes and Images: adds objects (evidence: `src/slide.ts`)
- Presentation → Media: encodes media (evidence: `src/pptxgen.ts`)
- Presentation → OOXML Serializer: generates OOXML (evidence: `src/pptxgen.ts`)
- Presentation → JSZip: packages output (evidence: `src/pptxgen.ts`)
- Presentation → PPTX File: writes file (evidence: `README.md`)
- Shapes and Images → Tables and HTML: uses table generation (evidence: `src/gen-objects.ts`)
- Shapes and Images → Generation Utilities: uses (evidence: `src/gen-objects.ts`)
- Shapes and Images → Image Utilities: uses image helpers (evidence: `src/gen-objects.ts`)
- OOXML Serializer → Paragraphs: uses (evidence: `src/gen-xml.ts`)
- Paragraphs → Bullets: generates bullets (evidence: `src/generators/paragraph.ts`)
- Paragraphs → Text Properties: generates run properties (evidence: `src/generators/paragraph.ts`)
- OOXML Serializer → Generation Utilities: uses (evidence: `src/gen-xml.ts`)
- Charts → Generation Utilities: uses (evidence: `src/gen-charts.ts`)
- Tables and HTML → Generation Utilities: uses (evidence: `src/gen-tables.ts`)
- Presentation → Enums: uses (evidence: `src/pptxgen.ts`)
- Presentation → Data Interfaces: uses (evidence: `src/pptxgen.ts`)
- Shapes and Images → Enums: uses (evidence: `src/gen-objects.ts`)
- Shapes and Images → Data Interfaces: uses (evidence: `src/gen-objects.ts`)
- Charts → Data Interfaces: uses (evidence: `src/gen-charts.ts`)
- Media → Data Interfaces: uses (evidence: `src/gen-media.ts`)
- Image Utilities → Data Interfaces: uses (evidence: `src/utils/imageUtils.ts`)
- Image Utilities → Generation Utilities: uses (evidence: `src/utils/imageUtils.ts`)
- Tables and HTML → PPTX File: supports HTML conversion (evidence: `README.md`)
