Install DeskCrew on Discourse (theme component)

Run a Discourse forum? DeskCrew installs as an official theme component: live chat, AI answers grounded in your help articles, and ticketing on every forum page. No code to paste, and the widget stays hidden until you set your key.

Install

  1. In your Discourse admin, go to Customize → Themes → Install → From a git repository.
  2. Paste this repository URL and install:
    https://github.com/webmilmind1/discourse-deskcrew
    
    It adds as a theme component (separate from your theme, so it survives theme changes).
  3. Open the component's Settings and paste your widget key (starts with pub_) from your DeskCrew dashboard under Install.
  4. Add the component to your active theme(s). The chat widget appears forum-wide.

The widget stays hidden until a valid key is set, so nothing shows on your forum before you are ready.

Settings

  • Widget key (required): your pub_ key from Dashboard → Install.
  • Board (optional): point the widget at a specific board slug.
  • Accent color (optional): a hex value such as #4f46e5.
  • Position: left or right side of the screen.

Updating

Discourse checks the git repository for updates. When a new version ships, you will see an update available on the component in Customize → Themes → Components.

How it works

Every conversation from your forum becomes a ticket in your DeskCrew dashboard. The AI drafts a reply grounded in your published knowledge base, a human approves it, and forum members who already left get the answer by email. The component adds a single deferred script and draws the widget in an isolated Shadow DOM, so it never clashes with your Discourse theme.

Related articles