Unified Offer Protocol

# Unified Offer Protocol (UOP) A multi-tenant SaaS platform connecting e-commerce merchants with AI developers through intelligent affiliate marketing. ## 🚀 Overview Unified Offer Protocol enables: - **AI Developers**: Create intelligent agents that can query products, generate affiliate links, and negotiate prices - **E-commerce Merchants**: Connect their shops, manage product catalogs, and set dynamic pricing rules ## 🌐 Live Application - **Production**: [https://unifiedoffer.com](https://unifiedoffer.com) - **API**: [https://api.unifiedoffer.com](https://api.unifiedoffer.com) ## 🛠️ Tech Stack - **Frontend**: React 18 + TypeScript + Vite - **UI**: shadcn/ui + Tailwind CSS - **Backend**: Supabase (PostgreSQL + Edge Functions) - **Authentication**: Supabase Auth with RLS - **Deployment**: IONOS Deploy Now with GitHub Actions ## 📋 Prerequisites - Node.js 20.x - npm or yarn - Supabase CLI (for local development) ## 🚀 Getting Started ### 1. Clone the repository ```bash git clone https://github.com/Chris85appding/unified-offer-protocol-front.git cd unified-offer-protocol-front ``` ### 2. Install dependencies ```bash npm install ``` ### 3. Set up environment variables Create a `.env.local` file: ```env VITE_SUPABASE_URL=https://api.unifiedoffer.com VITE_SUPABASE_ANON_KEY=your_anon_key_here VITE_LIVEDEMO_API_KEY=your_demo_api_key_here ``` ### 4. Start development server ```bash npm run dev ``` The application will be available at `http://localhost:5173` ## 📁 Project Structure ``` src/ ├── components/ # Reusable UI components ├── pages/ # Route pages ├── hooks/ # Custom React hooks ├── lib/ # Utilities and configurations ├── types/ # TypeScript type definitions └── integrations/ # External service integrations supabase/ ├── functions/ # Edge Functions └── migrations/ # Database migrations ``` ## 🔧 Available Scripts ```bash # Development npm run dev # Start dev server npm run build # Build for production npm run preview # Preview production build # Testing npm run test:e2e # Run end-to-end tests npm run test:integrity # Check codebase integrity npm run test:api # Test API endpoints # Code Quality npm run lint # Run ESLint npm run format # Format with Prettier # Deployment npm run deploy:functions # Deploy Supabase Edge Functions ``` ## 🔐 API Integration ### For Developers 1. Register at [unifiedoffer.com](https://unifiedoffer.com) 2. Generate API key from dashboard 3. Use the API endpoints: ```javascript // Example: Search products const response = await fetch( 'https://api.unifiedoffer.com/functions/v1/query-products', { method: 'POST', headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json', }, body: JSON.stringify({ query: 'laptop', maxResults: 10, }), } ); ``` ### For Merchants 1. Connect your e-commerce shop (Shopify, WooCommerce, etc.) 2. Configure pricing rules and commission rates 3. Monitor sales and analytics through the dashboard ## 📊 Key Features - **Real-time Analytics**: Track clicks, conversions, and revenue - **Dynamic Pricing**: AI-powered price negotiations - **Multi-shop Support**: Connect multiple e-commerce platforms - **Commission System**: Automated billing and payouts - **API Rate Limiting**: Fair usage policies - **Shopify Integration**: Native Shopify app support ## 🏗️ Architecture - **Multi-tenant SaaS**: Isolated data per user with RLS - **Event-driven**: Real-time updates via Supabase subscriptions - **Serverless**: Edge Functions for API endpoints - **Type-safe**: Full TypeScript coverage - **Responsive**: Mobile-first design ## 🤝 Contributing We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details. ## 📄 License This project is proprietary software. All rights reserved. ## 🆘 Support - Documentation: [/docs](./docs) - Issues: [GitHub Issues](https://github.com/Chris85appding/unified-offer-protocol-front/issues) - Email: support@unifiedoffer.com ## 🚀 Deployment The application is automatically deployed via GitHub Actions when pushing to: - `main` branch → Production (unifiedoffer.com) - `develop` branch → Staging environment See [DEPLOYMENT.md](./DEPLOYMENT.md) for detailed deployment instructions. --- Built with ❤️ by the Unified Offer Protocol team