# 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:

```bash
# 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:**
```bash
cd shopcall.ai-main
npm run dev  # Start dev server on port 8080
```

**Backend:**
```bash
cd shopcall.ai-backend-main
npm start    # Start Express server
```

**Supabase Functions:**
```bash
# 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`):
```bash
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](./CLAUDE.md) - Comprehensive project documentation for development
- [DEPLOYMENT_GUIDE.md](./DEPLOYMENT_GUIDE.md) - Deployment instructions
- [TODO.md](./TODO.md) - Project roadmap and task tracking
- [MISSING_FEATURES.md](./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](./DEPLOYMENT_GUIDE.md) for detailed instructions.

## License

Proprietary - All rights reserved

## Support

For issues or questions, contact the development team.
