A fully custom AI chatbot widget built with React and TypeScript. This lightweight, cleanly structured, and mobile-responsive widget allows you to create a personalized chatbot for your business.
- Customize with your business name, industry, and description
- Select from multiple personality types (friendly, professional, humorous, etc.)
- Input knowledge base via text, URL, or JSON
- Preview the chatbot in a simulated chat interface
- Generate embeddable widget code for your website
- Node.js (v14 or higher)
- npm or yarn
- Clone or download this repository
- Navigate to the project directory
- Install dependencies:
npm install
To start the development server:
npm start
This will open the application in your default browser at http://localhost:3000
.
To create a production build:
npm run build
This will generate optimized files in the dist
directory that you can deploy to any static hosting service.
The built project can be easily deployed to platforms like Vercel, Netlify, or any static hosting service:
- Install Vercel CLI:
npm i -g vercel
- Run
vercel
in the project directory - Follow the prompts to deploy
- Create a new site on Netlify
- Connect to your repository or upload the
dist
folder - Set the build command to
npm run build
and publish directory todist
The widget uses CSS variables for easy customization. You can modify the colors, fonts, and other styles in the src/styles/global.css
file.
The project is structured to make it easy to integrate with real AI APIs:
- Check the
src/services/ApiService.ts
file for examples of how to connect to OpenAI or custom APIs - Implement the abstract methods with your specific API calls
- Update the chat interface to use your API service
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with React and TypeScript
- Uses webpack for bundling
- Designed for easy embedding in Carrd sites and other platforms