This is a PRD based on a multi-day /wayfinder session

Look how detailed it is

Look how every assertion is linked back to the session where it was decided

Secondary source -> Primary source

Beautiful

https://t.co/AMVKBNJq6X

mattpocock/course-video-manager

Source: https://github.com/mattpocock/course-video-manager

Course Video Manager

A tool for managing course video publishing workflows — editing metadata, generating descriptions, creating thumbnails, and posting to social platforms.

Zapier Webhook Setup (Buffer Integration)

The app uses a Dropbox → Zapier → Buffer pipeline to post videos to social media. When you click “Post to Buffer” in the app, it:

1. Copies the video file into a local Dropbox folder
2. Waits for Dropbox to sync the file to the cloud
3. Sends a webhook to Zapier with the caption and file path
4. Zapier finds the file in Dropbox and adds it to your Buffer queue

Prerequisites

• Dropbox desktop client installed and running (the app uses dropbox filestatus to poll sync status)
• Buffer account connected in Zapier
• Zapier account with access to the Webhooks by Zapier and Buffer integrations

Environment Variables

Creating the Zapier Zap

Step 1: Create a “Webhooks by Zapier” trigger

1. Create a new Zap in Zapier
2. For the trigger, choose Webhooks by Zapier
3. Select Catch Hook as the trigger event
4. Copy the generated webhook URL
5. Set it as the ZAPIER_BUFFER_WEBHOOK_URL environment variable in your app

The webhook receives a JSON payload with this shape:

{
  "caption": "Your post caption text",
  "dropboxFilePath": "/full/path/to/buffer-posts/video.mp4"
}

Step 2: Add a “Dropbox: Find File” action

1. Add an action step and choose Dropbox
2. Select Find File as the action event
3. Configure it to look up the file using the dropboxFilePath value from the webhook payload

Step 3: Add a “Buffer: Add to Queue” action

1. Add another action step and choose Buffer
2. Select Add to Queue as the action event
3. Map the media field to the Dropbox file URL from Step 2
4. Map the text field to the caption value from the webhook payload

Step 4: Test and enable

1. Use the app to trigger a test post so Zapier can capture a sample webhook payload
2. Walk through each step to verify the data mapping is correct
3. Turn on the Zap