https://github.com/pipedrive/create-pipedrive-app
Scaffold a production-ready Pipedrive Marketplace app with OAuth, database, and App Extensions in seconds.
https://github.com/pipedrive/create-pipedrive-app
Last synced: about 1 month ago
JSON representation
Scaffold a production-ready Pipedrive Marketplace app with OAuth, database, and App Extensions in seconds.
- Host: GitHub
- URL: https://github.com/pipedrive/create-pipedrive-app
- Owner: pipedrive
- License: mit
- Created: 2026-05-08T08:53:29.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2026-05-21T15:00:23.000Z (about 2 months ago)
- Last Synced: 2026-05-21T22:36:24.711Z (about 2 months ago)
- Language: TypeScript
- Homepage:
- Size: 21.5 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# create-pipedrive-app
CLI scaffolding tool for Pipedrive Marketplace integrations. Generates an Express + TypeScript + Drizzle ORM project with OAuth 2.0, a Pipedrive API client, and optional App Extensions frontend (React + Vite). The CLI can be used standalone without any AI tooling.
## Usage
```bash
npx create-pipedrive-app
```
The CLI prompts for:
- **Project name**
- **Database**: Postgres, MySQL, or SQLite
- **App Extensions**: custom panel, custom modal, or neither
## Generated project
```
/
src/
index.ts # server entry point
app.ts # Express app with OAuth router (+ optional App Extensions)
oauth/ # OAuth 2.0 install, callback, token exchange, refresh
pipedrive/ # Pipedrive API client wrapper
database/ # Drizzle ORM schema, migrations, db driver
app-extensions/ # App Extensions handlers (if selected)
frontend/
app-extension-ui/ # React + Vite iframe UI (if App Extensions selected)
.env.example
docker-compose.yml
README.md
package.json
tsconfig.json
```
The generated project uses **Express + TypeScript + Drizzle ORM** (ESM, Node.js).
When App Extensions are selected, the project includes a shared React iframe app for custom panels and modals. `docker-compose up --watch` starts the backend and Vite dev server in containers with Compose Watch. Local Developer Hub iframe URLs must point at an HTTPS tunnel to the Vite dev server — for example `https:///extensions/panel` or `https:///extensions/modal`. After `npm run build`, production iframe URLs can point at the backend-hosted routes.
## Requirements
- Node.js (to run `npx create-pipedrive-app`)
- Docker (for Postgres/MySQL databases and App Extensions development)
## Using with an AI coding assistant
The package ships plugins for **Claude Code** and **Codex** that wrap the CLI with guided slash commands. The plugins require the CLI — they call `npx create-pipedrive-app` under the hood.
### Claude Code
This repository acts as the Claude Code plugin marketplace. Claude reads the marketplace catalog from `.claude-plugin/marketplace.json`, then installs the plugin from `plugin/`.
After this repository is public, install the plugin with:
```bash
claude plugin marketplace add pipedrive/create-pipedrive-app
claude plugin install create-pipedrive-app@pipedrive
```
Inside Claude Code, use the equivalent slash commands:
```text
/plugin marketplace add pipedrive/create-pipedrive-app
/plugin install create-pipedrive-app@pipedrive
/reload-plugins
```
The plugin calls `npx create-pipedrive-app` under the hood, so the npm package must also be published or otherwise available to users.
### Codex
```bash
codex plugin install create-pipedrive-app
```
### Available commands
Both plugins expose the same slash commands:
| Command | What it does |
|---------|-------------|
| `/pipedrive-new-app` | Scaffold a new integration project |
| `/pipedrive-add-app-extension` | Add a custom panel or modal extension |
| `/pipedrive-api` | Get guidance on using the Pipedrive API |
| `/pipedrive-review-marketplace-readiness` | Check for gaps before submitting to the marketplace |