🛠️ Technology Stack

Frontend

• Framework: Next.js 16.1.4 (App Router)
• UI Library: React 19.2.3
• Language: TypeScript 5.x
• Styling: Tailwind CSS 4.x
• Animations: Framer Motion 12.29.0
• Fonts: Geist Sans & Geist Mono

Backend

• Runtime: Next.js API Routes (Node.js)
• Database: MongoDB with Mongoose 9.1.5
• Authentication: ScaleKit SDK 2.1.9
• AI Service: Google Generative AI 1.38.0
• HTTP Client: Axios 1.13.3

Development Tools

• Build Tool: Next.js built-in
• Linting: ESLint 9.x
• Type Checking: TypeScript
• Package Manager: npm
• CSS Processing: PostCSS

🚀 Getting Started

Prerequisites

• Node.js 18.x or higher
• npm or yarn
• MongoDB database
• Google Gemini API key
• ScaleKit account and credentials

Installation

1. Clone the repository

   git clone <repository-url>
   cd <to-project-folder>
   

2. Install dependencies

   npm install
   

3. Environment Setup Create a .env.local file in the root directory:

   MONGODB_URL=
   SCALEKIT_ENVIRONMENT_URL=
   SCALEKIT_CLIENT_ID=your-scalekit-client-id
   SCALEKIT_CLIENT_SECRET=your-scalekit-client-secret
   GEMINI_API_KEY=your-gemini-api-key
   

4. Run the development server

   npm run dev
   

5. Open your browser Navigate to http://localhost:3000

📖 Usage

For Business Owners

1. Sign Up/Login: Use enterprise SSO via ScaleKit
2. Configure Chatbot:
   • Access the dashboard at /dashboard
   • Enter business name, support email, and knowledge base
   • Save settings
3. Generate Embed Code:
   • Go to /embed page
   • Copy the provided script tag
   • Paste it into your website's HTML

For Developers

1. API Integration: Use the RESTful APIs for custom integrations
2. Customization: Modify components in /src/components/
3. Styling: Update Tailwind classes or add custom CSS

🔧 API Reference

Authentication Endpoints

• POST /api/auth/login - Initiate OAuth flow
• POST /api/auth/callback - Handle OAuth callback
• POST /api/auth/logout - Clear user session

Chat Endpoints

• POST /api/chat - Process customer messages

  {
    "message": "Customer question",
    "ownerId": "business-owner-id"
  }
  

Settings Endpoints

• POST /api/settings - Create/update chatbot settings
• POST /api/settings/get - Retrieve settings for owner

🔒 Security Features

• HTTP-only Cookies: Secure session management
• CORS Configuration: Controlled cross-origin access
• Input Validation: Comprehensive data validation
• Authentication Middleware: Route protection
• Enterprise SSO: ScaleKit integration for secure access

🚀 Deployment

Production Build

npm run build
npm start

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

Built with ❤️ by Jagrat Agrawal