---
title: "Feedback"
description: "A feedback button that reports bugs from any app straight into a kontor project."
canonical_url: "https://docs.dev.lightdrop.cloud/guides/feedback"
---
# Feedback

> A feedback button that reports bugs from any app straight into a kontor project.

kontor is the issue tracker for wervt apps. Its feedback widget adds a small "Feedback" button
to an app; reports land in a kontor project's triage with the page they came from, the browser
and the app's release.

## Set it up

1. In kontor, open the project's **Settings → Intake keys** and create a key. Add the app's URL
(`https://my-app.dev.lightdrop.cloud`) as an allowed origin, so signed-in wervt users report under
their account.
2. Add the key to the app:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  modules: ['@wervt/nuxt'],
  wervt: {
    feedback: { key: 'pk_…', lang: 'de' },
  },
})
```

The key is public (it can only create triage reports), so it can live in the config. To keep it
out of the repository, set `feedback: true` and the key with `wervt env`:

```sh
wervt env my-app --set NUXT_PUBLIC_WERVT_FEEDBACK_KEY=pk_…
```

## Options

<table>
<thead>
  <tr>
    <th>
      Option
    </th>
    
    <th>
      Default
    </th>
    
    <th>
      What it does
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>
      <code>
        key
      </code>
    </td>
    
    <td>
      
    </td>
    
    <td>
      The project's public intake key
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        url
      </code>
    </td>
    
    <td>
      <code>
        https://kontor.wervt.app
      </code>
    </td>
    
    <td>
      The kontor instance, for a self-hosted one
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        lang
      </code>
    </td>
    
    <td>
      the browser's
    </td>
    
    <td>
      <code>
        de
      </code>
      
       or <code>
        en
      </code>
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        position
      </code>
    </td>
    
    <td>
      <code>
        bottom-right
      </code>
    </td>
    
    <td>
      <code>
        bottom-left
      </code>
      
      , or <code>
        none
      </code>
      
       for your own button
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        side
      </code>
    </td>
    
    <td>
      <code>
        right
      </code>
    </td>
    
    <td>
      With <code>
        position: 'none'
      </code>
      
      : the corner the form opens in
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        label
      </code>
    </td>
    
    <td>
      <code>
        Feedback
      </code>
    </td>
    
    <td>
      Text of the floating button
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        color
      </code>
    </td>
    
    <td>
      blue
    </td>
    
    <td>
      Accent color, any CSS color
    </td>
  </tr>
  
  <tr>
    <td>
      <code>
        dev
      </code>
    </td>
    
    <td>
      <code>
        false
      </code>
    </td>
    
    <td>
      Load it in <code>
        nuxt dev
      </code>
      
       too (add localhost as allowed origin)
    </td>
  </tr>
</tbody>
</table>

## Your own button and context

`useWervtFeedback()` opens the form from anywhere and adds context to every report:

```vue
<script setup lang="ts">
const feedback = useWervtFeedback()
feedback.setContext({ room: room.value.id })
</script>

<template>
  <UButton label="Report a problem" @click="feedback.open()" />
</template>
```

The widget loads after the app has hydrated, from kontor itself: changes to it reach every app
without a release. Each report carries the page URL, browser, viewport, language, the app's name
and its build id.


## Sitemap

See the full [sitemap](https://docs.dev.lightdrop.cloud/sitemap.md) for all pages.
