# pipedrive/create-pipedrive-app architecture

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

- Interactive diagram: https://gitdiagram.com/pipedrive/create-pipedrive-app
- Repository: https://github.com/pipedrive/create-pipedrive-app

## Overview

create-pipedrive-app is a CLI that gathers project options and generates a Pipedrive Marketplace integration scaffold; it also adds App Extensions to an existing project. The generated product spans OAuth, database/token persistence, a Pipedrive API client, Express routes, and optional React iframe extensions. Claude Code and Codex plugins provide guided commands for scaffolding, extension setup, API guidance, and marketplace-readiness review. Source excerpts show generator ownership and some generated wiring; plugin-to-CLI behavior and unsampled capabilities are based on the README.

Main entry points: [`src/generators/node/projectBuilder.ts`](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/projectBuilder.ts) (Project builder), [`src/cli.ts`](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/cli.ts) (CLI), [`src/utils/writeFile.ts`](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/utils/writeFile.ts) (Generated file writer), [`src/generators/node/app.ts`](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/app.ts) (Express application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflow"]
  node_cli["CLI<br/>[cli.ts]"]
  node_project_prompt["Project prompt<br/>[projectName.ts]"]
  node_database_prompt["Database prompt<br/>[database.ts]"]
  node_extensions_prompt["Extension prompt<br/>[appExtensions.ts]"]
  node_add_extension["Add extension<br/>[addAppExtension.ts]"]
end

subgraph group_generation["Scaffold generation"]
  node_node_generator["Node generator<br/>[index.ts]"]
  node_project_builder["Project builder<br/>[projectBuilder.ts]"]
  node_file_writer["Generated file writer<br/>[writeFile.ts]"]
  node_app_generator["Express app generator<br/>[app.ts]"]
  node_oauth_generator["OAuth generator<br/>[oauth.ts]"]
  node_database_generator["Database generator<br/>[database.ts]"]
  node_client_generator["Pipedrive client generator<br/>[pipedriveClient.ts]"]
  node_crypto_generator["Token crypto generator<br/>[crypto.ts]"]
end

subgraph group_backend["Generated backend"]
  node_generated_app["Express application<br/>[app.ts]"]
  node_generated_oauth["OAuth flow<br/>[oauth.ts]"]
  node_generated_database[("Database and tokens<br/>[database.ts]")]
  node_generated_client["Pipedrive API client<br/>[pipedriveClient.ts]"]
end

subgraph group_extensions["App Extensions"]
  node_extension_generator["Extension generator<br/>[appExtensions.ts]"]
  node_extension_frontend["Iframe frontend<br/>[frontend.ts]"]
  node_extension_router["Extension routes<br/>[router.ts]"]
  node_extension_sdk["Extension SDK<br/>[sdk.ts]"]
  node_extension_styles["Extension styles<br/>[styles.ts]"]
end

subgraph group_assistant["Assistant plugins"]
  node_claude_plugin["Claude commands"]
  node_codex_plugin["Codex commands"]
end

node_developer(("Developer"))

node_developer -->|"runs"| node_cli
node_cli -->|"prompts for name"| node_project_prompt
node_cli -->|"prompts database"| node_database_prompt
node_cli -->|"prompts extensions"| node_extensions_prompt
node_cli -->|"starts generation"| node_node_generator
node_cli -->|"dispatches command"| node_add_extension
node_add_extension -->|"builds extensions"| node_project_builder
node_add_extension -->|"requests choices"| node_extensions_prompt
node_node_generator -->|"builds project"| node_project_builder
node_project_builder -->|"generates app"| node_app_generator
node_project_builder -->|"generates OAuth"| node_oauth_generator
node_project_builder -->|"generates database"| node_database_generator
node_project_builder -->|"generates client"| node_client_generator
node_project_builder -->|"generates crypto"| node_crypto_generator
node_project_builder -->|"generates extensions"| node_extension_generator
node_app_generator -->|"writes app files"| node_file_writer
node_oauth_generator -->|"writes OAuth files"| node_file_writer
node_database_generator -->|"writes database files"| node_file_writer
node_client_generator -->|"writes client file"| node_file_writer
node_crypto_generator -->|"writes crypto file"| node_file_writer
node_extension_generator -->|"generates frontend"| node_extension_frontend
node_extension_generator -->|"generates routes"| node_extension_router
node_extension_frontend -->|"uses SDK"| node_extension_sdk
node_extension_frontend -->|"uses styles"| node_extension_styles
node_generated_app -->|"mounts OAuth"| node_generated_oauth
node_generated_app -->|"reads token store"| node_generated_database
node_generated_app -->|"requests API client"| node_generated_client
node_generated_app -->|"mounts optional routes"| node_extension_router
node_claude_plugin -->|"invokes CLI"| node_cli
node_codex_plugin -->|"invokes CLI"| node_cli

click node_cli "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/cli.ts"
click node_project_prompt "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/prompts/projectName.ts"
click node_database_prompt "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/prompts/database.ts"
click node_extensions_prompt "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/prompts/appExtensions.ts"
click node_add_extension "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/subcommands/addAppExtension.ts"
click node_node_generator "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/index.ts"
click node_project_builder "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/projectBuilder.ts"
click node_file_writer "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/utils/writeFile.ts"
click node_app_generator "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/app.ts"
click node_oauth_generator "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/oauth.ts"
click node_database_generator "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/database.ts"
click node_client_generator "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/pipedriveClient.ts"
click node_crypto_generator "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/crypto.ts"
click node_generated_app "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/app.ts"
click node_generated_oauth "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/oauth.ts"
click node_generated_database "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/database.ts"
click node_generated_client "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/pipedriveClient.ts"
click node_extension_generator "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/appExtensions.ts"
click node_extension_frontend "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/appExtensions/frontend.ts"
click node_extension_router "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/appExtensions/router.ts"
click node_extension_sdk "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/appExtensions/sdk.ts"
click node_extension_styles "https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/appExtensions/styles.ts"
click node_claude_plugin "https://github.com/pipedrive/create-pipedrive-app/tree/master/plugin/skills"
click node_codex_plugin "https://github.com/pipedrive/create-pipedrive-app/tree/master/plugins/create-pipedrive-app/skills"

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_cli,node_project_prompt,node_database_prompt,node_extensions_prompt,node_add_extension toneBlue
class node_node_generator,node_project_builder,node_file_writer,node_app_generator,node_oauth_generator,node_database_generator,node_client_generator,node_crypto_generator toneAmber
class node_generated_app,node_generated_oauth,node_generated_database,node_generated_client toneMint
class node_extension_generator,node_extension_frontend,node_extension_router,node_extension_sdk,node_extension_styles toneRose
class node_claude_plugin,node_codex_plugin,node_developer toneIndigo
```

## Components

### CLI workflow

- [CLI](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/cli.ts): `src/cli.ts`
- [Project prompt](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/prompts/projectName.ts): `src/prompts/projectName.ts`
- [Database prompt](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/prompts/database.ts): `src/prompts/database.ts`
- [Extension prompt](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/prompts/appExtensions.ts): `src/prompts/appExtensions.ts`
- [Add extension](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/subcommands/addAppExtension.ts): `src/subcommands/addAppExtension.ts`

### Scaffold generation

- [Node generator](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/index.ts): `src/generators/node/index.ts`
- [Project builder](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/projectBuilder.ts): `src/generators/node/projectBuilder.ts`
- [Generated file writer](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/utils/writeFile.ts): `src/utils/writeFile.ts`
- [Express app generator](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/app.ts): `src/generators/node/app.ts`
- [OAuth generator](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/oauth.ts): `src/generators/node/oauth.ts`
- [Database generator](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/database.ts): `src/generators/node/database.ts`
- [Pipedrive client generator](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/pipedriveClient.ts): `src/generators/node/pipedriveClient.ts`
- [Token crypto generator](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/crypto.ts): `src/generators/node/crypto.ts`

### Generated backend

- [Express application](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/app.ts): `src/generators/node/app.ts`
- [OAuth flow](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/oauth.ts): `src/generators/node/oauth.ts`
- [Database and tokens](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/database.ts): `src/generators/node/database.ts`
- [Pipedrive API client](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/pipedriveClient.ts): `src/generators/node/pipedriveClient.ts`

### App Extensions

- [Extension generator](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/appExtensions.ts): `src/generators/node/appExtensions.ts`
- [Iframe frontend](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/appExtensions/frontend.ts): `src/generators/node/appExtensions/frontend.ts`
- [Extension routes](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/appExtensions/router.ts): `src/generators/node/appExtensions/router.ts`
- [Extension SDK](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/appExtensions/sdk.ts): `src/generators/node/appExtensions/sdk.ts`
- [Extension styles](https://github.com/pipedrive/create-pipedrive-app/blob/master/src/generators/node/appExtensions/styles.ts): `src/generators/node/appExtensions/styles.ts`

### Assistant plugins

- [Claude commands](https://github.com/pipedrive/create-pipedrive-app/tree/master/plugin/skills): `plugin/skills`
- [Codex commands](https://github.com/pipedrive/create-pipedrive-app/tree/master/plugins/create-pipedrive-app/skills): `plugins/create-pipedrive-app/skills`

### Other components

- **Developer**

## Connections

- Developer → CLI: runs (evidence: `README.md`)
- CLI → Project prompt: prompts for name (evidence: `src/cli.ts`)
- CLI → Database prompt: prompts database (evidence: `src/cli.ts`)
- CLI → Extension prompt: prompts extensions (evidence: `src/cli.ts`)
- CLI → Node generator: starts generation (evidence: `src/cli.ts`)
- CLI → Add extension: dispatches command (evidence: `src/cli.ts`)
- Add extension → Project builder: builds extensions (evidence: `src/subcommands/addAppExtension.ts`)
- Add extension → Extension prompt: requests choices (evidence: `src/subcommands/addAppExtension.ts`)
- Node generator → Project builder: builds project (evidence: `src/generators/node/index.ts`)
- Project builder → Express app generator: generates app (evidence: `src/generators/node/projectBuilder.ts`)
- Project builder → OAuth generator: generates OAuth (evidence: `src/generators/node/projectBuilder.ts`)
- Project builder → Database generator: generates database (evidence: `src/generators/node/projectBuilder.ts`)
- Project builder → Pipedrive client generator: generates client (evidence: `src/generators/node/projectBuilder.ts`)
- Project builder → Token crypto generator: generates crypto (evidence: `src/generators/node/projectBuilder.ts`)
- Project builder → Extension generator: generates extensions (evidence: `src/generators/node/projectBuilder.ts`)
- Express app generator → Generated file writer: writes app files (evidence: `src/generators/node/app.ts`)
- OAuth generator → Generated file writer: writes OAuth files (evidence: `src/generators/node/oauth.ts`)
- Database generator → Generated file writer: writes database files (evidence: `src/generators/node/database.ts`)
- Pipedrive client generator → Generated file writer: writes client file (evidence: `src/generators/node/pipedriveClient.ts`)
- Token crypto generator → Generated file writer: writes crypto file (evidence: `src/generators/node/crypto.ts`)
- Extension generator → Iframe frontend: generates frontend (evidence: `src/generators/node/appExtensions.ts`)
- Extension generator → Extension routes: generates routes (evidence: `src/generators/node/appExtensions.ts`)
- Iframe frontend → Extension SDK: uses SDK (evidence: `src/generators/node/appExtensions/frontend.ts`)
- Iframe frontend → Extension styles: uses styles (evidence: `src/generators/node/appExtensions/frontend.ts`)
- Express application → OAuth flow: mounts OAuth (evidence: `src/generators/node/app.ts`)
- Express application → Database and tokens: reads token store (evidence: `src/generators/node/app.ts`)
- Express application → Pipedrive API client: requests API client (evidence: `src/generators/node/app.ts`)
- Express application → Extension routes: mounts optional routes (evidence: `src/generators/node/app.ts`)
- Claude commands → CLI: invokes CLI (evidence: `README.md`)
- Codex commands → CLI: invokes CLI (evidence: `README.md`)
