Skip to content

MuhammadTanveerAbbas/CortexReach

Repository files navigation

πŸ“§ CortexReach

Next.js React TypeScript Tailwind CSS shadcn/ui Google AI
Deploy

Generate personalized cold outreach emails using AI. Paste prospect information, get customized emails powered by Google Gemini, and receive effectiveness predictions.


✨ Features

πŸ€– Smart Email Generation

  • πŸ“‹ Paste prospect data (LinkedIn profiles, bios, articles, social posts)
  • 🎯 Analyzes information and generates personalized emails
  • ✏️ Rich text editor for customization
  • πŸ“Ž Copy generated emails to clipboard

πŸ“Š Effectiveness Analysis

  • 🎯 Scoring system (0-100 scale)
  • πŸ“ˆ Predicted engagement metrics
  • πŸ’‘ Suggestions for improvement
  • 🚫 Spam risk assessment

🎨 User Experience

  • πŸ“± Responsive design for all devices
  • πŸŒ™ Dark/light mode support
  • πŸ’Ύ Local draft auto-save
  • πŸ“œ Email generation history

πŸ› οΈ Tech Stack


πŸš€ Getting Started

⚑ Deploy to Vercel

Deploy with Vercel

⚠️ Important: After deployment, configure environment variables in Vercel:

  1. Go to your Vercel project β†’ Settings β†’ Environment Variables
  2. Add GOOGLE_GENAI_API_KEY with your Google AI API key
  3. Add NEXT_PUBLIC_APP_URL with your deployment URL
  4. Redeploy the application

πŸ’» Local Development

πŸ“‹ Prerequisites

πŸ“¦ Installation

# 1. Clone the repository
git clone https://github.com/MuhammadTanveerAbbas/CortexReach.git
cd CortexReach

# 2. Install dependencies
npm install

# 3. Set up environment variables
cp .env.local.example .env.local
# Add your Google AI API key to .env.local

# 4. Start development server
npm run dev

πŸ” Environment Setup

Create a .env.local file in the root directory:

# Required: Google AI API Key
GOOGLE_GENAI_API_KEY=your_google_ai_api_key_here

# Optional: Application URL
NEXT_PUBLIC_APP_URL=http://localhost:3000

# Optional: Google Analytics
NEXT_PUBLIC_GA_ID=G-XXXXXXXXXX

See .env.local.example for all available options.

πŸ”§ Available Scripts

npm run dev          # Start development server with Turbo
npm run build        # Build for production
npm run start        # Start production server
npm run lint         # Run ESLint
npm run typecheck    # Run TypeScript checks
npm run format       # Format code with Prettier
npm run clean        # Clean build artifacts

πŸ“– Usage

  1. 🌐 Navigate to /tool in your browser
  2. πŸ“‹ Paste prospect information (LinkedIn profile, bio, articles, etc.)
  3. ✍️ Optionally add name, company, and job title
  4. 🎯 Click "Generate Personalized Email"
  5. πŸ‘€ Review and edit the generated email
  6. πŸ“Š Click "Analyze Effectiveness" for feedback
  7. πŸ“Ž Copy the final email to your clipboard

πŸ’Ό What It Does

  • ⚑ Automates personalized email generation
  • πŸ“Š Provides effectiveness scoring and suggestions
  • ⏱️ Saves time on manual email writing
  • βœ… Helps avoid common cold email mistakes

πŸ‘¨β€πŸ’» Development

πŸ“ Project Structure

CortexReach/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/                 # Next.js App Router pages
β”‚   β”œβ”€β”€ components/          # Reusable UI components
β”‚   β”œβ”€β”€ ai/                  # AI integration and flows
β”‚   β”œβ”€β”€ lib/                 # Utility functions
β”‚   └── hooks/               # Custom React hooks
β”œβ”€β”€ public/                  # Static assets
└── docs/                    # Documentation

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

🎯 Production Features

  • πŸ” SEO optimized with meta tags and sitemap
  • ⚠️ Error handling with custom error pages
  • βœ… Environment variable validation
  • 🧹 Code quality tools (ESLint, Prettier, TypeScript)
  • πŸ’Ύ Auto-save drafts to localStorage
  • πŸ“œ Email generation history

πŸ”’ Privacy

  • πŸ”‘ API keys stored in environment variables
  • 🚫 No permanent data storage on servers
  • ⚑ Data processed only during email generation
  • πŸ’Ύ Local storage used for drafts and history

πŸ—ΊοΈ Roadmap

  • Email templates library
  • CRM integration (Salesforce, HubSpot, Pipedrive)
  • Bulk email generation
  • A/B testing support
  • Analytics dashboard
  • Team collaboration features

πŸ’¬ Support


πŸ“„ License

MIT License - see the LICENSE file for details.


Made with ❀️ by Muhammad Tanveer Abbas

About

CortexReach βœ‰οΈ Copilot for Cold Outreach Tool πŸ› 

Topics

Resources

License

Stars

Watchers

Forks