Skip to content

Adapters overview

bugfreedback separates screenshot storage from export (where feedback tickets land). Configure both in nuxt.config.ts; secrets can also come from environment variables (see each guide).

Storage

Upload annotated screenshots to object storage so export adapters can embed durable HTTPS URLs.

ProviderGuide
Google Cloud StorageGCS / storage
S3-compatible (AWS, R2, MinIO)S3 storage
DisabledNo storage

Export

Route each submission to one export destination:

ProviderCreatesGuide
githubGitHub IssueGitHub
linearLinear issueLinear
jiraJira issueJira
notionNotion database pageNotion
slackSlack message (incoming webhook)Slack
asanaAsana taskAsana
trelloTrello cardTrello
webhookHTTP POST to your URLWebhook
iftttIFTTT Maker Webhook triggerIFTTT

Typical production stack

ts
// nuxt.config.ts — GitHub Issues + GCS storage
export default defineNuxtConfig({
  modules: ['@nuxt/ui', '@bugfreedback/bugfreedback'],
  bugfreedback: {
    enabled: true,
    storage: {
      provider: 'gcs',
      bucket: process.env.BUGFREEDBACK_GCS_BUCKET || '',
      objectPrefix: 'feedback/',
    },
    export: {
      provider: 'github',
      token: process.env.BUGFREEDBACK_GITHUB_TOKEN || '',
      owner: 'your-org',
      repo: 'your-app',
      labels: ['feedback', 'from:widget'],
    },
  },
})

See Local demo to run the playground and Configuration for theme and auth options.

Released under the MIT License.