chatkit-js

Embed and customize OpenAI ChatKit UI components in Next.js applications.

2|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/NaimalArain13/Hackathon-II_The-Evolution-of-Todo --skill chatkit-js
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: chatkit-js
Source: https://github.com/NaimalArain13/Hackathon-II_The-Evolution-of-Todo/tree/main/.claude/skills/chatkit-js
Command: npx skills add https://github.com/NaimalArain13/Hackathon-II_The-Evolution-of-Todo --skill chatkit-js

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The ChatKit JS integration skill helps developers quickly embed OpenAI ChatKit UI components into a Next.js app, enabling feature-rich chat experiences with minimal setup, while maintaining secure authentication and backend integration.

Core Features & Use Cases

  • Frontend integration: Use the ChatKit React components directly in Next.js pages and components.
  • Custom backend support: Configure a backend API URL and optional domain key for secure, authenticated messaging.
  • Theming and customization: Style and tailor the chat widget to fit your app's design system.
  • Conversation history & authentication: Preserve chat history and inject user authentication tokens into requests.
  • Use Case: Build an in-app support bot or task assistant within a Next.js application, backed by a FastAPI backend.

Quick Start

Install the package, configure the API URL and domain key, and boot your Next.js app. Then integrate the ChatKit component into your page using the provided templates or your own UI.

Frequently Asked Questions about chatkit-js

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I embed OpenAI ChatKit UI in a Next.js application?

To embed OpenAI ChatKit UI in a Next.js application, install the @openai/chatkit-react package and integrate the components directly into your pages. You can configure the API URL and domain key to enable secure, authenticated messaging.

Can I use a custom FastAPI backend with ChatKit components?

Yes, you can use a custom FastAPI backend with ChatKit components. You need to configure the NEXT_PUBLIC_CHAT_API_URL environment variable to point to your backend API URL for handling secure messaging requests.

How does ChatKit handle authentication and conversation history?

ChatKit handles authentication by allowing you to inject user authentication tokens into chat requests. It preserves conversation history within the Next.js application, ensuring continuous and secure chat experiences.

What environment variables are required to configure the ChatKit widget?

Configuring the ChatKit widget requires optional environment variables including NEXT_PUBLIC_CHAT_API_URL for your backend API endpoint and NEXT_PUBLIC_OPENAI_DOMAIN_KEY for secure domain authentication.

How do I customize the theming of the ChatKit widget?

You can customize the theming of the ChatKit widget by styling and tailoring the @openai/chatkit-react components. This allows you to align the chat interface directly with your Next.js application's design system.