shopcall

ShopCall.ai

AI-powered calling system integrated with e-commerce platforms.

Repository Structure

This is a monorepo containing the following packages:

shopcall/
├── shopcall.ai-main/          # Frontend application (React + Vite + TypeScript)
├── shopcall.ai-backend-main/  # Backend API (Express.js)
├── supabase/                  # Supabase configuration and Edge Functions
├── docs/                      # Documentation files
│   ├── CLAUDE.md             # Development guidelines for AI assistants
│   ├── DEPLOYMENT_GUIDE.md   # Deployment instructions
│   ├── REFACTORING_SUMMARY.md # Code refactoring notes
│   ├── TODO.md               # Project roadmap and tasks
│   └── MISSING_FEATURES.md   # Feature tracking
└── package.json              # Root workspace configuration

Quick Start

Prerequisites

• Node.js 18+ and npm
• Supabase account
• Shopify/WooCommerce API credentials (for integrations)

Installation

Install dependencies for all packages:

# Install Supabase CLI globally or at root
npm install

# Install frontend dependencies
cd shopcall.ai-main
npm install

# Install backend dependencies
cd ../shopcall.ai-backend-main
npm install

Development

Frontend:

cd shopcall.ai-main
npm run dev  # Start dev server on port 8080

Backend:

cd shopcall.ai-backend-main
npm start    # Start Express server

Supabase Functions:

# Deploy all functions
./deploy-functions.sh

# Or deploy individually
npx supabase functions deploy <function-name>

Environment Setup

Create .env files in both frontend and backend directories:

Backend (shopcall.ai-backend-main/.env):

SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_anon_key
SHOPIFY_API_KEY=your_shopify_key
SHOPIFY_API_SECRET=your_shopify_secret
EMAIL_USER=your_gmail
EMAIL_PASSWORD=your_gmail_app_password
NODE_ENV=development

Technology Stack

Frontend

• React 18 with Vite
• TypeScript
• Tailwind CSS + shadcn/ui
• React Router v6
• React Query
• React Hook Form + Zod

Backend

• Express.js v5
• Supabase (PostgreSQL + Auth)
• Nodemailer
• OAuth integrations (Shopify, WooCommerce)

Infrastructure

• Supabase Edge Functions (Deno)
• Vercel (hosting)

Documentation

• CLAUDE.md - Comprehensive project documentation for development
• DEPLOYMENT_GUIDE.md - Deployment instructions
• TODO.md - Project roadmap and task tracking
• MISSING_FEATURES.md - Feature implementation status

Deployment

Both frontend and backend deploy to Vercel:

• Frontend: https://shopcall.ai
• Backend: https://shopcall-ai-backend.vercel.app

See DEPLOYMENT_GUIDE.md for detailed instructions.

License

Proprietary - All rights reserved

Support

For issues or questions, contact the development team.