Astro integration for AI live chat, help center and ticketing. Add the DeskCrew support widget to any Astro site with one line in astro.config.mjs. Free plan, no card required.
Website • Integrations • For agents • Sign up
⭐ Help more people find DeskCrew. Star this repo!
Add AI live chat, a help center and ticketing to any Astro site in about two minutes, free, with no credit card. @deskcrew/astro is the official DeskCrew integration: one line in astro.config.mjs puts a support widget on every page, answers visitor questions from your own help articles, and turns anything it cannot answer into a real support ticket.
The widget running on an Astro site. Watch the full quality video.
npm install @deskcrew/astro// astro.config.mjs
import { defineConfig } from 'astro/config'
import deskcrew from '@deskcrew/astro'
export default defineConfig({
integrations: [
deskcrew({
widgetKey: 'pub_xxxxxxxx', // required, from Dashboard → Install
// board: 'your-workspace', // optional
// color: '#4f46e5', // optional accent colour
// position: 'right', // optional: 'left' | 'right'
// greeting: 'Hi! How can we help?', // optional
}),
],
})Build or run your site and the chat launcher appears on every page. No account yet? Create one free, then copy your key from Dashboard → Install.
- AI answers grounded in your own help articles. The assistant only answers from the knowledge base you publish, so it cannot invent product facts.
- A human approves before anything sends. Every AI draft waits in an approval queue. Nothing reaches a customer unreviewed.
- Every conversation becomes a ticket. Widget chats, emails and board posts land in one dashboard with full history.
- Visitors who leave still get answered. Leave an email address and the reply arrives by email.
- Free plan, no card. Chat widget, public knowledge base and ticketing are included on the free plan.
| Option | Type | Required | Description |
|---|---|---|---|
widgetKey |
string |
yes | Your public key (pub_…). |
board |
string |
no | Board slug (lowercase letters, numbers, dashes). |
color |
string |
no | Accent colour as a 6-digit hex value, e.g. #4f46e5. |
position |
'left' | 'right' |
no | Which side the launcher sits on. |
greeting |
string |
no | Greeting shown on the launcher. |
If widgetKey is missing or malformed the integration prints a build-time warning and adds nothing. Your site still builds.
The integration injects a small inline script into the document head that loads https://deskcrew.io/desk.js with your settings as data-* attributes. The widget renders inside a Shadow DOM, so it cannot inherit or leak your site's CSS. desk.js derives its API origin from its own src, so there is nothing else to configure.
Astro compatibility: works with any Astro 4 or later project, static or SSR, and with any adapter.
| DeskCrew | Intercom | Crisp | Tidio | |
|---|---|---|---|---|
| Free plan with AI answers | Yes | No | Limited | Limited |
| Human approves AI replies | Yes, built in | No | No | No |
| Official Astro integration | Yes | No | No | No |
| Public knowledge base included | Yes | Paid add-on | Paid tier | Paid tier |
| Credit card to start | No | Yes | No | No |
Install @deskcrew/astro, add the integration to astro.config.mjs with your public widget key, and rebuild. The launcher appears on every page.
Yes. The free plan includes the chat widget, a public knowledge base and ticketing, with no credit card. Paid plans add higher AI allowances and team features. See pricing.
The integration adds one deferred script tag. Nothing renders until the visitor opens the launcher, and the widget is isolated in a Shadow DOM.
It answers from the knowledge base you publish. When it has no grounded answer it escalates to a human instead of guessing, and every draft reply requires human approval before sending.
Both. The widget is client-side and framework agnostic, so output mode and adapter do not matter.
Yes. Each site is its own workspace with a separate knowledge base, ticket history and widget key.
- Astro integration page: https://deskcrew.io/integrations/astro
- All integrations: https://deskcrew.io/integrations
- Pricing: https://deskcrew.io/pricing
- Start free: https://deskcrew.io/signup
MIT © DeskCrew · deskcrew.io · hello@deskcrew.io
Updated July 2026.

