Back to Home
RecBug Documentation & Multi-Destination Hub

Supported Destinations & Setup Guide

Step-by-step guides for installing RecBug and connecting all supported issue trackers and team chat tools via OAuth 2.0 (or a webhook URL for Microsoft Teams), plus offline diagnostic exports.

1. Installing the RecBug Chrome Extension

Official Chrome Web Store Release

Get RecBug directly from the Chrome Web Store

Install the verified extension in one click to get automatic updates, strictly bug-focused telemetry recording, and instant bug synchronization.

Quick Installation Steps:

1
Open Chrome Web Store

Click the Add to Chrome button above or anywhere across the site to open the official listing.

2
Confirm Installation

Click Add to Chrome on the store page and accept the standard browser prompt.

3
Pin & Start Recording

Click the puzzle piece icon in Chrome's toolbar and pin RecBug for instant access.

Compatible with:Google ChromeBraveMicrosoft EdgeArcChromium

2. Supported Destination Setup Guides

ClickUp Integration

Deep Space/List hierarchy sync, custom markdown descriptions & priority mapping

OAuth 2.0

How to connect ClickUp:

  1. In RecBug Settings, toggle ClickUp to on.
  2. Click Connect with ClickUp. A ClickUp authorization window opens.
  3. Choose the Workspace(s) to share and click Connect Workspace.
  4. Back in RecBug, select your target Space, Folder, and List.
🗂️ Hierarchy Navigation

RecBug automatically fetches all your authorized Workspaces, Spaces, Folders, and Lists.

⚡ Priority & Attachment Sync

Maps Urgent (1), High (2), Normal (3), Low (4) and uploads video, console logs, and HAR directly.

Atlassian Jira Cloud

Project Keys, Issue Types (Bug/Task/Story), Jira ADF formatting & attachments

Atlassian OAuth 2.0

How to connect Jira Cloud:

  1. In RecBug Settings, toggle Jira to on.
  2. Click Connect with Atlassian and sign in to your Atlassian account.
  3. Review the requested permissions, pick your Jira site, and click Accept.
  4. Back in RecBug, select your target Project Key (e.g. DEV, BUG) and Issue Type (Bug).
🔒 No tokens to copy: RecBug connects through Atlassian's standard OAuth 2.0 consent screen, so you never paste an API token or password.

Trello

Board and list routing, card descriptions, and evidence attachments

OAuth 2.0

How to connect Trello:

  1. In RecBug Settings, toggle Trello to on.
  2. Click Log in with Trello (1-click OAuth 2.0) and approve access.
  3. RecBug automatically discovers your accessible Boards and open Lists.
  4. Select your target destination Board and List for automatic ticket routing.
🔒 OAuth only: Customers never create a developer app or paste an API key or user token. OAuth sessions remain in local browser storage (chrome.storage.local).

Linear

Team selector, issue states, urgency levels, and markdown description injection

OAuth 2.0

How to connect Linear:

  1. In RecBug Settings, toggle Linear to on.
  2. Click Connect with Linear and approve access for your workspace.
  3. RecBug will automatically query Linear’s GraphQL API to populate all your organization’s Teams.
  4. Select the target engineering team and default state (e.g. Triage or Backlog).

Slack (OAuth & Block Kit)

Instant bug notifications with Block Kit cards, error badges, and attachment links

OAuth 2.0

How to connect Slack:

  1. In RecBug Settings, toggle Slack to on.
  2. Click Add to Slack and choose your workspace.
  3. Review the permissions and click Allow.
  4. Back in RecBug, select the channel where QA bug reports should be posted (e.g. #qa-incidents or #bug-reports).
💬 Block Kit Formatting: RecBug automatically formats the notification with title, priority pill, environment specs, console error counts, and direct links to the video reproduction.

Microsoft Teams

Adaptive Card notifications for Microsoft 365 channels and developer triage teams

OAuth 2.0 or Incoming Webhook URL

How to connect Microsoft Teams:

  1. In RecBug Settings, toggle MS Teams to on.
  2. For OAuth, select OAuth 2.0, click Log in with Microsoft Teams, and approve access.
  3. Select the target team and channel discovered from Microsoft Graph.

Incoming Webhook alternative:

  1. In Microsoft Teams, navigate to your desired team channel and click ••• (More options) > Connectors > Incoming Webhook (or set up a Power Automate "When a webhook request is received" workflow).
  2. Provide a name (e.g. RecBug Bug Triage), upload an icon, and click Create.
  3. Copy the generated Webhook URL (starts with https://outlook.office.com/webhook/... or https://prod-XX.logic.azure.com/...).
  4. Paste the URL into RecBug’s MS Teams configuration card.

Offline Standalone ZIP & HAR Export

Zero-network offline archives for air-gapped environments, email attachments, and local audits

No Cloud • 100% Local Archive

Download a complete, organized package directly to your local file system with zero network requests or third-party connections:

📁 recording.mp4 / .webm

High-definition video reproduction trimmed to the exact failure window.

🌐 network_requests.har

Standard HTTP Archive 1.2 log inspectable in Chrome DevTools Network panel.

📝 console_logs.json

Structured array of error, warn, and log statements with timestamps and stack traces.

💾 storage_state.json

Playwright v2 format storage state with token redaction for automated test replay.

🍪 cookies.txt

Netscape format cookies export for cURL, Postman, and API debugging sessions.

🖼️ annotated_screenshots/

High-resolution canvas captures with pen drawings, geometric highlights, and callouts.

3. Capture Modes, In-App WYSIWYG Editor & Studio

Dual Capture: Screenshots & 60fps Video

Not all bugs need a video. RecBug lets you pick the optimal capture format right from the launch drawer:

  • 1-Click Screenshot Mode: Instantly captures the active viewport and opens directly into review without waiting for recording timers or video encoding. Ideal for visual regressions, misaligned buttons, or static CSS defects.
  • 60fps Screen Recording: High-definition video capture with optional microphone voice narration and instant virtual scrubbing. Perfect for complex multi-step workflows, race conditions, and animation glitches.
  • Universal Telemetry Collection: Both screenshot and video modes automatically gather console logs, full HAR 1.2 network payloads, application storage state, and system metadata.
In-App WYSIWYG Editor & Syntax Compilers

Craft structured, readable bug descriptions with rich formatting that compiles natively to your tracker:

  • Rich Text Controls: Bold, italic, underline, strikethrough, heading levels (H1–H6), bulleted and numbered lists, inline code blocks, and hyperlinks.
  • Jira ADF (Atlassian Document Format): Compiles rich text into structured JSON nodes (paragraphs, bullet lists, code blocks) so tickets render with authentic Jira native styling.
  • Slack mrkdwn & Teams Cards: Automatically translates formatting to Slack mrkdwn (*bold*, <url|label>) and Microsoft Teams styled cards.
  • Standard Markdown: Seamlessly exports clean GitHub/Linear/Trello/ClickUp-compliant markdown.
Hybrid Video Baking Architecture

RecBug combines instantaneous client-side responsiveness with cloud-grade video compatibility:

  • Instant Virtual Trimming: Adjust start and end scrubber handles with zero rendering latency. Your cuts preview immediately without waiting for client-side re-encoding.
  • Sub-15s FFmpeg Transcoding: When dispatching your report, RecBug's ephemeral backend (api.recbug.com) burns in annotations and transcodes WebM into standard MP4 for seamless inline playback in Jira, ClickUp, and Linear.
  • Resilient Offline Fallback: If the network drops or backend transcoding is unavailable, an interactive modal allows downloading the raw trimmed WebM directly or retrying the export.
Visual Annotation Studio

Pinpoint visual regressions and UI defects before handing tickets off to engineering:

  • Freehand Pen Tool: Scribble circles, arrows, and custom underlines with customizable stroke widths and vibrant colors.
  • Geometric Callout Shapes: Drop rectangle and circular highlight frames around misaligned elements or broken layouts.
  • Precision Crop: Crop screenshot captures down to the exact component or modal in question.
  • Multi-Level History: Full undo (Ctrl/Cmd+Z) and redo (Ctrl/Cmd+Y) stack ensures hassle-free editing.

4. Application Storage State & Playwright Reproduction

Eliminate "Cannot Reproduce" by Exporting Complete Client State

Many modern frontend bugs only manifest under specific authenticated user states, feature flag flags, or corrupted cached storage. RecBug inspects and packages the complete client storage layer:

📦 Local & Session Storage

Captures all key-value entries across window.localStorage and window.sessionStorage with JSON value parsing.

🗄️ IndexedDB Databases

Enumerates object store schemas, key paths, indexes, and active state snapshots without crashing browser memory.

🛡️ Automated Token Sanitization

Client-side regex masks Bearer JWT tokens, auth secrets, and session hashes with [REDACTED_SECRET] before export.

Instant Playwright Test Session Reproduction

Engineers can load the exported storage_state.json directly in Playwright CLI to open a browser window pre-authenticated with the user's exact cookies and storage:

npx playwright open --load-storage=storage_state.json https://yourapp.com/dashboard

5. Performance Diagnostics & Developer Preferences

Deep Telemetry & INP

Measures Interaction to Next Paint (INP), JS Heap Memory allocation trends, and identifies slow network resource bottlenecks.

Dark & Light Themes

Seamless theme switching between sleek midnight dark mode and high-contrast light mode with configurable font scaling (Compact, Normal, Large).

In-App CSAT Feedback

Quick 1-5 star CSAT rating and categorized drawer to submit UX impressions, bug reports, and feature requests directly to our team.

Security & Privacy Commitments

Strict Purpose Limitation & Ephemeral Processing

RecBug collects user-initiated screen recordings, console logs, and network telemetry strictly for bug reporting. Video recordings and annotations are transmitted to RecBug servers (api.recbug.com) for video transcoding/trimming. Media processing is strictly ephemeral and temporary files are deleted immediately after delivery. Data is never sold to third parties or data brokers, and is not used for advertising, marketing, or creditworthiness evaluation. Destination credentials remain stored in your local browser storage, and finalized reports are dispatched directly to your authorized tools (ClickUp, Jira, Trello, Linear, Slack, Teams).