> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryproduck.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Add the widget, wire it to your repo, and let agents ship the fixes.

## Get feedback flowing

<Steps>
  <Step title="Create a project">
    In the [Produck dashboard](https://tryproduck.com/app), open **Projects** and click
    **Create**. Create one project per app you want feedback on.

    <Info>
      Projects — plus the GitHub connection and coding agents below — need the **Startup
      tier or higher**. It's free to start: sign up for the Startup tier, or upgrade from a
      personal account.
    </Info>
  </Step>

  <Step title="Generate an API key">
    Open your project's **settings** and click **Generate API key**. Your key starts with
    `pk_live_`.

    <Warning>
      The full key is shown **once**, right after you generate it. Copy it before closing
      the dialog. Lost it? Generate a new one and delete the old.
    </Warning>
  </Step>

  <Step title="Embed the widget">
    Copy the script tag from the dialog — your key is already filled in — and paste it
    before the closing `</body>` tag of your app:

    ```html theme={null}
    <script src="https://tryproduck.com/sdk/v1.js" data-project="pk_live_YOUR_KEY" defer></script>
    ```

    That's the whole install. Reload your app and the duck button appears in the
    bottom-right corner.

    <Check>
      Click the duck (or press **⌘ + Shift + Z** / **Ctrl + Shift + Z**) to open the
      widget.
    </Check>

    Prefer to delegate? Hand your coding agent a ready-made prompt from
    [Set up with an AI agent](/sdk/installation#set-up-with-an-ai-agent) — it covers web,
    React Native, and native iOS.
  </Step>

  <Step title="See feedback roll in">
    Submit a test note from your app, then open the **Feedback** view in the dashboard.
    Your submission appears with its annotations, voice transcript, and page snapshot.
  </Step>
</Steps>

## Close the loop with coding agents

Connect your repo so Produck's agents can turn a piece of feedback into a pull request.

<Steps>
  <Step title="Open your project's settings">
    In the [dashboard](https://tryproduck.com/app), open the project you created above — or
    create one first — and go to **project settings**.
  </Step>

  <Step title="Connect a GitHub repository">
    In the **Repository** card, click **Install GitHub App** and pick the repos Produck can
    see. Access is **read-only** — uninstall anytime.
  </Step>

  <Step title="Pick the repo and branch">
    Back in project settings, choose the **Repository** and set the **Branch** the agent
    works from. Agents open a pull request against this branch and never push to it directly.
  </Step>

  <Step title="Launch a coding agent">
    Open any feedback ticket. Once its project has a connected repo and a completed design
    doc, a **Launch** button appears on the ticket. The agent clones the repo, writes the
    fix, and opens a PR for your review — usually in 5–20 minutes.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Installation" icon="code" href="/sdk/installation">
    Framework snippets and where to place the script tag.
  </Card>

  <Card title="JavaScript API" icon="terminal" href="/sdk/javascript-api">
    Identify users, open the widget from your own UI, and listen for events.
  </Card>
</CardGroup>