Generate personalized cold outreach emails using AI. Paste prospect information, get customized emails powered by Google Gemini, and receive effectiveness predictions.
- π 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
- π― Scoring system (0-100 scale)
- π Predicted engagement metrics
- π‘ Suggestions for improvement
- π« Spam risk assessment
- π± Responsive design for all devices
- π Dark/light mode support
- πΎ Local draft auto-save
- π Email generation history
- Framework: Next.js 15 with App Router
- Language: TypeScript 5
- UI Library: React 18
- Styling: Tailwind CSS 3
- Components: shadcn/ui
- Icons: Lucide React
- AI: Google Gemini 2.5 Flash
- Go to your Vercel project β Settings β Environment Variables
- Add
GOOGLE_GENAI_API_KEYwith your Google AI API key - Add
NEXT_PUBLIC_APP_URLwith your deployment URL - Redeploy the application
- Node.js v18+ (Download)
- npm v8+ (comes with Node.js)
- Google AI API Key (Get yours here)
# 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 devCreate 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-XXXXXXXXXXSee .env.local.example for all available options.
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- π Navigate to
/toolin your browser - π Paste prospect information (LinkedIn profile, bio, articles, etc.)
- βοΈ Optionally add name, company, and job title
- π― Click "Generate Personalized Email"
- π Review and edit the generated email
- π Click "Analyze Effectiveness" for feedback
- π Copy the final email to your clipboard
- β‘ Automates personalized email generation
- π Provides effectiveness scoring and suggestions
- β±οΈ Saves time on manual email writing
- β Helps avoid common cold email mistakes
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
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
- π 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
- π 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
- Email templates library
- CRM integration (Salesforce, HubSpot, Pipedrive)
- Bulk email generation
- A/B testing support
- Analytics dashboard
- Team collaboration features
- π Issues: GitHub Issues
- π Discussions: GitHub Discussions
MIT License - see the LICENSE file for details.
Made with β€οΈ by Muhammad Tanveer Abbas