🚀 GreyBrain AI Pulse - Deployment Guide

📋 Pre-Deployment Checklist

✅ Current Features Ready for Production:

• 🧠 AI-Powered Newsletter Generation (Gemini API with Google Search)
• 📧 Email Newsletter Automation (Brevo integration)
• 🤖 Discord Community Integration (Auto-posting to topic channels)
• 📊 RSS Feed Generation
• 🔖 Bookmark System
• 📱 Responsive Design
• 🔄 Auto-refresh every 30 minutes

🔧 Environment Variables Required:

# API Keys
VITE_GEMINI_API_KEY=your_gemini_api_key
VITE_BREVO_API_KEY=your_brevo_api_key

# Discord Configuration
VITE_DISCORD_BOT_TOKEN=your_discord_bot_token
VITE_DISCORD_GUILD_ID=your_discord_guild_id
VITE_DISCORD_WEBHOOK_URL=your_discord_webhook_url
VITE_DISCORD_SERVER_INVITE=https://discord.gg/your-invite

# Telegram (Optional - can be added later)
VITE_TELEGRAM_BOT_TOKEN=your_telegram_bot_token
VITE_TELEGRAM_CHAT_ID=your_telegram_chat_id

🌐 Deployment Options

Option 1: Vercel (Recommended)

# Install Vercel CLI
npm i -g vercel

# Deploy
vercel

# Set environment variables in Vercel dashboard
# vercel.com → Project → Settings → Environment Variables

Option 2: Netlify

# Install Netlify CLI
npm i -g netlify-cli

# Build and deploy
npm run build
netlify deploy --prod --dir=dist

Option 3: GitHub Pages

# Build for production
npm run build

# Deploy to gh-pages branch
npm i -g gh-pages
gh-pages -d dist

🔗 Embedding in GreyBrain.ai

Option 1: Full Page Integration

Add a new page/route to your main website:

<!-- Add to your main site -->
<iframe 
  src="https://your-deployed-pulse.vercel.app" 
  width="100%" 
  height="100vh" 
  frameborder="0">
</iframe>

Option 2: Widget Integration

Create a newsletter widget for your homepage:

<!-- Newsletter widget -->
<div id="greybrain-pulse-widget"></div>
<script>
  // Embed latest newsletter content
  fetch('https://your-deployed-pulse.vercel.app/api/latest')
    .then(response => response.json())
    .then(data => {
      // Render newsletter preview
    });
</script>

Option 3: Subdomain

Set up a subdomain: pulse.greybrain.ai

• Point DNS to your deployment
• Update CNAME records

📧 Email Newsletter Automation

Current Setup:

• ✅ Subscription Form (Brevo integration)
• ✅ Weekly Digest Generation (HTML + Text)
• ✅ Automated Campaigns (Brevo API)
• ✅ RSS Feed for email clients

To Enable Auto-Sending:

1. Set up Brevo Campaign Automation
2. Configure Weekly Schedule (Sundays at 9 AM)
3. Test with Small List first

🤖 Discord Integration Status

✅ Fully Configured:

• Professional Discord server created
• 6 topic-specific channels matching newsletter categories
• Auto-posting when new content is generated
• Professional roles and community guidelines
• Webhook integration for manual posting

Channels Created:

• #llm-announcements → "New LLM Announcements & Releases"
• #productivity-hacks → "LLM Productivity Hacks & Tips"
• #ai-tool-of-the-day → "AI Tool/Tip of the Day"
• #deep-agents-tools → "Emerging Deep Agents & AI Tools"
• #academic-research → "Academic Research & Papers"
• #healthcare-llm → "Healthcare LLM Advancements"

🔄 Automation Features

Auto-Posting (Every 30 minutes):

1. Generate Newsletter (Gemini API + Google Search)
2. Post to Discord Channels (Topic-specific routing)
3. Update RSS Feed
4. Refresh Website Content

Weekly Email Digest:

• Automated HTML email generation
• Subscriber management via Brevo
• Professional email templates

📱 Mobile & Performance

Optimizations:

• ✅ Responsive design for all devices
• ✅ Lazy loading for images
• ✅ Optimized bundle size
• ✅ Fast loading with Vite

🔐 Security & Privacy

Implemented:

• ✅ Environment variable protection
• ✅ API key security
• ✅ CORS configuration
• ✅ No sensitive data in client

📊 Analytics & Monitoring

Ready for:

• Google Analytics integration
• Newsletter engagement tracking
• Discord community metrics
• Email open/click rates (Brevo)

🚀 Quick Deploy Commands

# 1. Build for production
npm run build

# 2. Test production build locally
npm run preview

# 3. Deploy to Vercel
vercel --prod

# 4. Set environment variables in Vercel dashboard

🔧 Post-Deployment Tasks

1. Update Discord Invite Link in .env
2. Test Email Subscriptions
3. Verify Auto-Posting
4. Set up Custom Domain (if needed)
5. Configure Analytics

📞 Support & Maintenance

Monitoring:

• Check Discord auto-posting daily
• Monitor email delivery rates
• Review API usage limits
• Update content categories as needed

Future Enhancements:

• 📱 Telegram integration
• 🔍 Search functionality
• 📈 Analytics dashboard
• 🎨 Custom themes
• 🔔 Push notifications

Ready to deploy! 🚀