Getting Started

Connect Yocoolab to your team's tools in minutes. Every integration follows the same simple pattern.

What is Yocoolab?

Yocoolab is a contextual feedback system for live web applications. Your team pins comments directly on deployed UIs, captures element context automatically, and routes feedback to your existing tools — Jira, Linear, Slack, Telegram, and Claude Code.

Every integration enriches threads with full context: screenshots, CSS selectors, viewport info, and Pendo usage analytics. Your team gets notified at every stage — from initial feedback to PR to resolution.

Prerequisites

A Yocoolab account at app.yocoolab.com
An organization created (or an invite to join one)
Admin role in the organization (required to configure integrations)
The Yocoolab Chrome Extension installed

Quick Start

1
Sign in to the admin dashboard
Go to app.yocoolab.com and sign in with GitHub or Google.
2
Create or join an organization
Organizations scope your repositories, integrations, and team permissions. Create one from the dashboard or accept an invite.
3
Go to Settings → Integrations
Each integration has a card showing its connection status. Click any card to begin setup.
4
Connect your tools
Each integration follows the same pattern: enter credentials, test the connection, then map your repositories to the target (Jira project, Slack channel, etc.).

How Integrations Work

All integrations follow the same lifecycle:

Configure credentials

Test connection

Map repos to targets

Security

Tip

All API tokens and credentials are encrypted at rest using AES-256-GCM. Credentials are scoped to your organization and never exposed in API responses. Access is controlled by role-based permissions — only org admins can configure integrations.

Install the SDK

Embed Yocoolab's commenting system directly in your web app with the client SDK.

# Clone + install (one command)

git clone https://github.com/Jonahbkerr/yocoolab-v2.git ~/yocoolab-v2 bash ~/yocoolab-v2/scripts/install.sh

yocoolab-core

Framework-agnostic SDK with API client, element picker, and real-time support

yocoolab-react

React hooks and components built on core (zustand, react-query, socket.io)

yocoolab-client

Unified bundle — re-exports both packages for easy import

# Add to your project

npm install ~/yocoolab-v2/client

# Initialize in your app

import Yocoolab from 'yocoolab-client';

Yocoolab.init({
  apiUrl: 'https://api.yocoolab.com',
  repo: 'my-org/my-repo',
  branch: 'main',
});

AI Agent Setup

Feed this prompt to any AI coding agent (Claude Code, Cursor, Cline, etc.) to install Yocoolab automatically:

Install Yocoolab commenting SDK in my project:

1. git clone https://github.com/Jonahbkerr/yocoolab-v2.git ~/yocoolab-v2
2. bash ~/yocoolab-v2/scripts/install.sh
3. npm install ~/yocoolab-v2/client
4. Initialize: import Yocoolab from 'yocoolab-client'

For AI agent integration:
  npx -y @yocoolab/mcp-server@2 setup

Also see the AI Agents page for MCP server setup.