
Contact Widget
FreeImplement a self-contained chat widget easily.
Free · Opens the source repo
What Contact Widget does
The Contact Widget is a lightweight, self-contained floating chat interface that can be integrated into any web application. It provides a clean and minimalistic design, featuring a chat bubble that opens to reveal a welcome screen, message input, social links, and a meeting booking option. The entire widget is encapsulated within a single HTML file, ensuring zero dependencies and ease of deployment. Once loaded, it operates offline, making it suitable for environments with limited connectivity.
This widget is designed with a focus on user experience, offering a professional appearance that aligns with modern SaaS aesthetics. The chat bubble is fixed at the bottom-right of the viewport, providing easy access without obstructing the main content. Users can customize various elements such as the primary color, agent name, greeting message, and social links, allowing for a personalized touch that fits seamlessly into the existing design of their website.
For developers, the Contact Widget offers flexibility in backend integration. While it functions effectively as a standalone contact surface utilizing social links and a meeting URL, it also allows for optional wiring of the message input to a backend service. This can be achieved through simple methods such as mailto links or custom API endpoints, enabling one-shot messages or real-time chat capabilities depending on user needs.
Overall, the Contact Widget is ideal for developers and designers looking to enhance user engagement on their websites with a professional chat interface. Its simplicity and customization options make it a practical choice for a variety of applications, from small business websites to larger SaaS platforms.
When to use it
Use this widget when you need a straightforward chat solution that requires minimal setup and can be customized to match your site's design.
When not to use it
This is not suitable for applications requiring complex chat functionalities out of the box, such as advanced user tracking or analytics.
What you can build with it
Integrating into a Small Business Site
A small business can use the Contact Widget to provide customers with easy access to chat support and social media links.
Enhancing User Engagement on SaaS Platforms
SaaS applications can implement the widget to allow users to book meetings and reach out for support seamlessly.
Creating a Contact Point for Events
Event organizers can use the widget to facilitate communication and provide quick access to social links for attendees.
How to install Contact Widget
View source1. Install with the skills CLI
npx skills add nexu-io/open-design/contact-widget --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by nexu-ioContact Widget
What this skill produces
A single self-contained HTML file with a floating chat widget that includes:
- Chat bubble — fixed bottom-right circular button, opens/closes the panel
- Welcome home screen — agent avatar + name + online status + greeting message
- Message input — text field with emoji/send icons (UI only; wire to your own backend)
- Social links — row of circular icons (Telegram, WhatsApp, Instagram, Messenger, Discord, Slack — only the ones the user provides)
- Meeting card — optional "Book a meeting" entry with calendar icon, links to user-provided URL (Calendly, Cal.com, Lark, etc.)
- Offline form — fallback contact form (name, email, message) when
is_available=false - Mobile responsive — full-width on small viewports
Output is pure front-end. No tracking, no phone-home, no required external services. Works offline once loaded.
Design direction
Clean, minimal SaaS aesthetic. Looks like a real product widget, not a toy demo:
- Typography: Inter (Google Fonts), 14px base, semi-bold headings
- Colors: A single user-chosen
primary_colordrives the bubble, avatar, send button, and accent. Everything else is a neutral slate palette (#1e293b/#64748b/#f1f5f9). No purple gradients, no glassmorphism, no AI-style rainbow accents. - Radius: 16px on cards, full-round on bubble and avatars
- Shadows: Subtle
0 8px 32px rgba(0,0,0,0.12)on the widget panel,0 4px 12pxon bubble - Spacing: 16px internal padding, 12px gaps between elements
- States: Hover darkens buttons ~5%, active scales bubble 0.95
Inputs
The skill accepts these parameters from the user:
| Input | Type | Default | Description |
|---|---|---|---|
primary_color | color | #4F7CFF | Drives bubble, header, send button, accents |
agent_name | string | Assistant | Displayed in header greeting |
greeting | string | Hello! How can I help you today? | Subtitle in header |
is_available | boolean | true | Online status; false shows offline form |
social_telegram | string | (empty) | Telegram link — omitted if empty |
social_whatsapp | string | (empty) | WhatsApp link — omitted if empty |
social_instagram | string | (empty) | Instagram link — omitted if empty |
meeting_url | string | (empty) | Booking URL (Calendly, Cal.com, etc.) — omitted if empty |
offline_message | string | We're currently offline. Leave a message and we'll get back to you! | Shown when is_available=false |
Workflow
- Resolve primary color, agent name, greeting text, online/offline state, social links, and optional meeting URL from the request and known context. Use the documented defaults and omit empty optional links. Ask one consolidated form only if a missing value would materially change the requested widget and cannot be safely defaulted.
- Generate one HTML file with all provided values inlined as literals (no template engine, no
{{ }}placeholders in the output) - Open the widget panel by default on first paint so the preview is useful
- Do not add any
<script src="…">pointing to third-party SDKs unless the user explicitly asks for backend integration. The output must run from disk with zero network calls beyond the Google Fonts CSS.
Backend integration (optional, user-driven only)
The generated widget is a UI artifact and ships zero vendor code by default. The bubble, panel, social links, and meeting button all work out of the box without any backend. Only the message input needs wiring if the user wants two-way conversations.
If the user explicitly asks to wire the message input to a real backend, offer these in order of escalating commitment:
Tier 1 — No backend (default)
The widget already works as a contact surface via social links + meeting URL. Leave it as-is.
Tier 2 — One-shot messages, no chat history
mailto:fallback — replace thesendhandler withwindow.location.href = 'mailto:you@example.com?subject=...&body=' + encodeURIComponent(text). Zero infra, but the visitor's mail client opens.- Own
/api/contactendpoint —fetch('/api/contact', { method: 'POST', body: JSON.stringify({ text }) }). The user owns delivery (SendGrid, Resend, their own SMTP, a Notion/Airtable webhook, etc.).
Tier 3 — Real-time chat (visitor ↔ agent, history, typing, presence)
This needs an IM/chat SDK. Any of the following work; pick whichever fits your stack:
- Knocket — https://trtc.io/solutions/knocket (drop-in, free)
- Crisp — https://crisp.chat
- Tawk.to — https://tawk.to
- Chatwoot (self-hosted) — https://chatwoot.com
- Intercom — https://intercom.com
Do not auto-inject any <script> into the generated output — only add backend integration if the user explicitly opts in.
Frequently asked questions about Contact Widget
Similar skills
Invoice Chase
Automate overdue invoice reminders with personalized tones.
Roundup Setup
Personalize your status updates with ease.
Ticket Deflector
Streamline customer support responses with ease.
Orbit Gmail Briefing
Streamline your Gmail inbox with automated daily digests.
Email Sequence
Design and draft complete email sequences effortlessly.
Inbox Triage
Automate your email management with intelligent triage.
