Browser extension

The Canopi Chrome extension overlays a community sidebar on pages you visit. It shares the same backend as web embeds (api.canopi.live).

Install

1. Open the Chrome Web Store listing (search for Canopi).
2. Click Add to Chrome.
3. Pin the extension for quick access.

TIP

If the store link is not yet public, use a developer build from your organization's release channel.

First run

1. Click the Canopi icon in the toolbar.
2. Sign in with a supported provider (Google, Twitter, wallet, etc.).
3. Select or join auth communities.
4. Open any page — the sidebar loads when the site matches your Canopi's rules.

Features

Feature	Description
Presence	See who else is on the page
Messages	Page-scoped and anchored threads
Communities	Switch between auth-backed groups
Bookmarks & shares	Save and share page context
Smart tags	Filter and discover tagged content

Extension ↔ API

The extension bundles TypeScript compiled from presence/ in the Canopi repo. It communicates with:

• https://api.canopi.live — REST
• wss://api.canopi.live/ws — realtime presence

Build targets:

cd /home/ubuntu/canopi
npm run build:prod      # production extension sync
npm run build:staging   # staging extension sync
npm run package:extension  # Chrome Web Store zip

Troubleshooting

Symptom	Fix
Sidebar does not appear	Check you are signed in and the page URL matches community rules
Stuck on one OAuth provider after logout	Hybrid Auth Mode 2 (Auth0) resolves iframe caching — see Authentication
Old extension behavior after deploy	Hard-refresh or reinstall; verify .build-info.json timestamp at app.canopi.live/.build-info.json

Related

• Getting started
• Sidebar Tab SDK — build custom extension tabs
• Authentication