IHeard.Ai

🤖 iHeard.ai - AI Sales Assistant for Shopify

An intelligent AI-powered sales assistant widget for Shopify stores that helps customers find products, answer questions, and provide personalized recommendations.

📋 Features

• 🎯 Smart Product Recommendations - AI-powered product suggestions based on customer queries
• 💬 Real-time Chat Interface - Floating chat widget with customizable positioning
• 🎨 Fully Customizable - Admin panel to configure colors, text, position, and behavior
• 📱 Mobile Responsive - Optimized for all device sizes
• 🔌 N8N Integration - Optional integration with N8N workflows for advanced AI processing
• ⚡ Real-time Updates - Settings changes reflect immediately on the storefront
• 🛡️ Secure - Built with Shopify's security best practices

🏗️ Architecture

• Frontend: Remix with TypeScript and Shopify Polaris UI
• Backend: Node.js with Prisma ORM and SQLite database
• Theme Extension: Liquid template with vanilla JavaScript
• AI Integration: N8N webhooks with fallback processing
• Authentication: Shopify OAuth with session management

🚀 Quick Start

Prerequisites

• Node.js 18+ and npm
• Shopify Partner account
• Shopify CLI 3.0+

Installation

1. **Clone the repository**

   git clone https://github.com/SankaiAI/iheard.ai.git
   cd iheard.ai

2. **Install dependencies**

   npm install

3. **Set up environment variables**

   cp .env.example .env
   # Edit .env with your Shopify app credentials

   **Required values for `.env`:**

   • SHOPIFY_API_KEY: Get from Shopify Partner Dashboard > Apps > [Your App] > App setup (Client ID)
   • SHOPIFY_SALES_ASSISTANT_WIDGET_ID: Generate a UUID at uuidgenerator.net

   **Optional N8N Integration:*