# leokdigital/digital-presence-engine architecture

> Architecture diagram of the GitHub repository leokdigital/digital-presence-engine, 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/leokdigital/digital-presence-engine
- Repository: https://github.com/leokdigital/digital-presence-engine

## Overview

This is a whitelabel digital-presence template and AI-agent skill for agencies. Its main workflow is an agency or agent selecting a client configuration or preset, running the setup generator, and receiving brand, marketing, SEO, and motion assets. Separate tools support motion-reference inspection and event-based audio planning. The README documents broader strategy, creative, SEO, motion, and QA playbooks; source excerpts confirm only selected generator and tool relationships, so unsampled wiring is omitted.

Main entry points: [`scripts/setup-client.mjs`](https://github.com/leokdigital/digital-presence-engine/blob/main/scripts/setup-client.mjs) (Whitelabel generator), [`scripts/sound-design-engine.mjs`](https://github.com/leokdigital/digital-presence-engine/blob/main/scripts/sound-design-engine.mjs) (Audio mix planner), [`client.config.json`](https://github.com/leokdigital/digital-presence-engine/blob/main/client.config.json) (Client configuration), [`presets`](https://github.com/leokdigital/digital-presence-engine/tree/main/presets) (Client presets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Client setup"]
  node_clientconfig["Client configuration<br/>[client.config.json]"]
  node_presets["Client presets"]
  node_generator["Whitelabel generator<br/>[setup-client.mjs]"]
end

subgraph group_brandcontent["Brand and content"]
  node_brandtokens["Brand tokens<br/>[brand.json]"]
  node_theme["Theme styles<br/>[theme.css]"]
  node_googleads["Google ads"]
  node_metaads["Meta ads<br/>[ads_meta.json]"]
  node_voiceover["Voiceover script"]
  node_article["Technical article"]
end

subgraph group_seo["Search presence"]
  node_schema["Structured data<br/>[schema.json]"]
  node_llms["LLM context<br/>[llms.txt]"]
  node_robots["Crawler rules<br/>[robots.txt]"]
  node_pricing["Pricing content<br/>[pricing.md]"]
end

subgraph group_motion["Motion and audio"]
  node_motionpage["Motion reel page<br/>[index.html]"]
  node_motionanim["GSAP animation<br/>[main.js]"]
  node_motionevents["Motion events<br/>[events.json]"]
  node_sounddesign["Audio mix planner"]
  node_mixreport["Mix report"]
  node_inspector["Reference inspector"]
end

subgraph group_guidance["Agent playbooks"]
  node_skill["Agent skill<br/>[SKILL.md]"]
  node_playbooks["Agency playbooks"]
end

node_agency(("Agency or agent"))

node_agency -->|"edits"| node_clientconfig
node_agency -->|"selects"| node_presets
node_clientconfig -->|"configures"| node_generator
node_presets -->|"configures"| node_generator
node_generator -->|"generates"| node_brandtokens
node_generator -->|"writes"| node_theme
node_generator -->|"writes"| node_schema
node_generator -->|"writes"| node_pricing
node_generator -->|"writes"| node_googleads
node_generator -->|"writes"| node_metaads
node_generator -->|"writes"| node_voiceover
node_generator -->|"generates"| node_article
node_generator -->|"generates"| node_llms
node_generator -->|"generates"| node_robots
node_generator -->|"generates"| node_motionpage
node_generator -->|"generates"| node_motionanim
node_sounddesign -->|"reads"| node_motionevents
node_sounddesign -->|"reads"| node_voiceover
node_sounddesign -->|"writes"| node_mixreport
node_motionpage -.->|"runs"| node_motionanim
node_skill -.->|"guides"| node_playbooks

click node_clientconfig "https://github.com/leokdigital/digital-presence-engine/blob/main/client.config.json"
click node_presets "https://github.com/leokdigital/digital-presence-engine/tree/main/presets"
click node_generator "https://github.com/leokdigital/digital-presence-engine/blob/main/scripts/setup-client.mjs"
click node_brandtokens "https://github.com/leokdigital/digital-presence-engine/blob/main/src/tokens/brand.json"
click node_theme "https://github.com/leokdigital/digital-presence-engine/blob/main/src/styles/theme.css"
click node_googleads "https://github.com/leokdigital/digital-presence-engine/blob/main/src/content/ads_google_rsa.json"
click node_metaads "https://github.com/leokdigital/digital-presence-engine/blob/main/src/content/ads_meta.json"
click node_voiceover "https://github.com/leokdigital/digital-presence-engine/blob/main/src/content/voiceover_script.json"
click node_article "https://github.com/leokdigital/digital-presence-engine/blob/main/src/content/technical_article.md"
click node_schema "https://github.com/leokdigital/digital-presence-engine/blob/main/public/schema.json"
click node_llms "https://github.com/leokdigital/digital-presence-engine/blob/main/public/llms.txt"
click node_robots "https://github.com/leokdigital/digital-presence-engine/blob/main/public/robots.txt"
click node_pricing "https://github.com/leokdigital/digital-presence-engine/blob/main/public/pricing.md"
click node_motionpage "https://github.com/leokdigital/digital-presence-engine/blob/main/src/motion/index.html"
click node_motionanim "https://github.com/leokdigital/digital-presence-engine/blob/main/src/motion/main.js"
click node_motionevents "https://github.com/leokdigital/digital-presence-engine/blob/main/src/motion/events.json"
click node_sounddesign "https://github.com/leokdigital/digital-presence-engine/blob/main/scripts/sound-design-engine.mjs"
click node_mixreport "https://github.com/leokdigital/digital-presence-engine/blob/main/artifacts/audio_mix_report.json"
click node_inspector "https://github.com/leokdigital/digital-presence-engine/blob/main/scripts/inspect-reference.mjs"
click node_skill "https://github.com/leokdigital/digital-presence-engine/blob/main/SKILL.md"
click node_playbooks "https://github.com/leokdigital/digital-presence-engine/tree/main/docs/playbooks"

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_clientconfig,node_presets,node_generator toneBlue
class node_brandtokens,node_theme,node_googleads,node_metaads,node_voiceover,node_article toneAmber
class node_schema,node_llms,node_robots,node_pricing toneMint
class node_motionpage,node_motionanim,node_motionevents,node_sounddesign,node_mixreport,node_inspector toneRose
class node_skill,node_playbooks,node_agency toneIndigo
```

## Components

### Client setup

- [Client configuration](https://github.com/leokdigital/digital-presence-engine/blob/main/client.config.json): `client.config.json`
- [Client presets](https://github.com/leokdigital/digital-presence-engine/tree/main/presets): `presets`
- [Whitelabel generator](https://github.com/leokdigital/digital-presence-engine/blob/main/scripts/setup-client.mjs): `scripts/setup-client.mjs`

### Brand and content

- [Brand tokens](https://github.com/leokdigital/digital-presence-engine/blob/main/src/tokens/brand.json): `src/tokens/brand.json`
- [Theme styles](https://github.com/leokdigital/digital-presence-engine/blob/main/src/styles/theme.css): `src/styles/theme.css`
- [Google ads](https://github.com/leokdigital/digital-presence-engine/blob/main/src/content/ads_google_rsa.json): `src/content/ads_google_rsa.json`
- [Meta ads](https://github.com/leokdigital/digital-presence-engine/blob/main/src/content/ads_meta.json): `src/content/ads_meta.json`
- [Voiceover script](https://github.com/leokdigital/digital-presence-engine/blob/main/src/content/voiceover_script.json): `src/content/voiceover_script.json`
- [Technical article](https://github.com/leokdigital/digital-presence-engine/blob/main/src/content/technical_article.md): `src/content/technical_article.md`

### Search presence

- [Structured data](https://github.com/leokdigital/digital-presence-engine/blob/main/public/schema.json): `public/schema.json`
- [LLM context](https://github.com/leokdigital/digital-presence-engine/blob/main/public/llms.txt): `public/llms.txt`
- [Crawler rules](https://github.com/leokdigital/digital-presence-engine/blob/main/public/robots.txt): `public/robots.txt`
- [Pricing content](https://github.com/leokdigital/digital-presence-engine/blob/main/public/pricing.md): `public/pricing.md`

### Motion and audio

- [Motion reel page](https://github.com/leokdigital/digital-presence-engine/blob/main/src/motion/index.html): `src/motion/index.html`
- [GSAP animation](https://github.com/leokdigital/digital-presence-engine/blob/main/src/motion/main.js): `src/motion/main.js`
- [Motion events](https://github.com/leokdigital/digital-presence-engine/blob/main/src/motion/events.json): `src/motion/events.json`
- [Audio mix planner](https://github.com/leokdigital/digital-presence-engine/blob/main/scripts/sound-design-engine.mjs): `scripts/sound-design-engine.mjs`
- [Mix report](https://github.com/leokdigital/digital-presence-engine/blob/main/artifacts/audio_mix_report.json): `artifacts/audio_mix_report.json`
- [Reference inspector](https://github.com/leokdigital/digital-presence-engine/blob/main/scripts/inspect-reference.mjs): `scripts/inspect-reference.mjs`

### Agent playbooks

- [Agent skill](https://github.com/leokdigital/digital-presence-engine/blob/main/SKILL.md): `SKILL.md`
- [Agency playbooks](https://github.com/leokdigital/digital-presence-engine/tree/main/docs/playbooks): `docs/playbooks`

### Other components

- **Agency or agent**

## Connections

- Agency or agent → Client configuration: edits (evidence: `README.md`)
- Agency or agent → Client presets: selects (evidence: `README.md`)
- Client configuration → Whitelabel generator: configures (evidence: `README.md`)
- Client presets → Whitelabel generator: configures (evidence: `README.md`)
- Whitelabel generator → Brand tokens: generates (evidence: `README.md`)
- Whitelabel generator → Theme styles: writes (evidence: `scripts/setup-client.mjs`)
- Whitelabel generator → Structured data: writes (evidence: `scripts/setup-client.mjs`)
- Whitelabel generator → Pricing content: writes (evidence: `scripts/setup-client.mjs`)
- Whitelabel generator → Google ads: writes (evidence: `scripts/setup-client.mjs`)
- Whitelabel generator → Meta ads: writes (evidence: `scripts/setup-client.mjs`)
- Whitelabel generator → Voiceover script: writes (evidence: `scripts/setup-client.mjs`)
- Whitelabel generator → Technical article: generates (evidence: `scripts/setup-client.mjs`)
- Whitelabel generator → LLM context: generates (evidence: `README.md`)
- Whitelabel generator → Crawler rules: generates (evidence: `README.md`)
- Whitelabel generator → Motion reel page: generates (evidence: `README.md`)
- Whitelabel generator → GSAP animation: generates (evidence: `scripts/setup-client.mjs`)
- Audio mix planner → Motion events: reads (evidence: `scripts/sound-design-engine.mjs`)
- Audio mix planner → Voiceover script: reads (evidence: `scripts/sound-design-engine.mjs`)
- Audio mix planner → Mix report: writes (evidence: `scripts/sound-design-engine.mjs`)
- Motion reel page → GSAP animation: runs
- Agent skill → Agency playbooks: guides
