How pipedrive/create-pipedrive-app works
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: projectBuilder.ts Project builder · cli.ts CLI · writeFile.ts Generated file writer · app.ts Express application
Components 25
CLI workflow
- CLI
src/cli.ts - Project prompt
src/prompts/projectName.ts - Database prompt
src/prompts/database.ts - Extension prompt
src/prompts/appExtensions.ts - Add extension
src/subcommands/addAppExtension.ts
Scaffold generation
- Node generator
src/generators/node/index.ts - Project builder
src/generators/node/projectBuilder.ts - Generated file writer
src/utils/writeFile.ts - Express app generator
src/generators/node/app.ts - OAuth generator
src/generators/node/oauth.ts - Database generator
src/generators/node/database.ts - Pipedrive client generator
src/generators/node/pipedriveClient.ts - Token crypto generator
src/generators/node/crypto.ts
Generated backend
- Express application
src/generators/node/app.ts - OAuth flow
src/generators/node/oauth.ts - Database and tokens
src/generators/node/database.ts - Pipedrive API client
src/generators/node/pipedriveClient.ts
App Extensions
- Extension generator
src/generators/node/appExtensions.ts - Iframe frontend
src/generators/node/appExtensions/frontend.ts - Extension routes
src/generators/node/appExtensions/router.ts - Extension SDK
src/generators/node/appExtensions/sdk.ts - Extension styles
src/generators/node/appExtensions/styles.ts
Assistant plugins
- Claude commands
plugin/skills - Codex commands
plugins/create-pipedrive-app/skills
Other components
- Developer
Connections 30
- Developer → CLI: runs
README.md - CLI → Project prompt: prompts for name
src/cli.ts - CLI → Database prompt: prompts database
src/cli.ts - CLI → Extension prompt: prompts extensions
src/cli.ts - CLI → Node generator: starts generation
src/cli.ts - CLI → Add extension: dispatches command
src/cli.ts - Add extension → Project builder: builds extensions
src/subcommands/addAppExtension.ts - Add extension → Extension prompt: requests choices
src/subcommands/addAppExtension.ts - Node generator → Project builder: builds project
src/generators/node/index.ts - Project builder → Express app generator: generates app
src/generators/node/projectBuilder.ts - Project builder → OAuth generator: generates OAuth
src/generators/node/projectBuilder.ts - Project builder → Database generator: generates database
src/generators/node/projectBuilder.ts - Project builder → Pipedrive client generator: generates client
src/generators/node/projectBuilder.ts - Project builder → Token crypto generator: generates crypto
src/generators/node/projectBuilder.ts - Project builder → Extension generator: generates extensions
src/generators/node/projectBuilder.ts - Express app generator → Generated file writer: writes app files
src/generators/node/app.ts - OAuth generator → Generated file writer: writes OAuth files
src/generators/node/oauth.ts - Database generator → Generated file writer: writes database files
src/generators/node/database.ts - Pipedrive client generator → Generated file writer: writes client file
src/generators/node/pipedriveClient.ts - Token crypto generator → Generated file writer: writes crypto file
src/generators/node/crypto.ts - Extension generator → Iframe frontend: generates frontend
src/generators/node/appExtensions.ts - Extension generator → Extension routes: generates routes
src/generators/node/appExtensions.ts - Iframe frontend → Extension SDK: uses SDK
src/generators/node/appExtensions/frontend.ts - Iframe frontend → Extension styles: uses styles
src/generators/node/appExtensions/frontend.ts - Express application → OAuth flow: mounts OAuth
src/generators/node/app.ts - Express application → Database and tokens: reads token store
src/generators/node/app.ts - Express application → Pipedrive API client: requests API client
src/generators/node/app.ts - Express application → Extension routes: mounts optional routes
src/generators/node/app.ts - Claude commands → CLI: invokes CLI
README.md - Codex commands → CLI: invokes CLI
README.md