Apply to jobs with personalized outreach in 1 click — powered by Llama 3 & Groq.

The open-source job application tool that actually respects your time.

📄 See job post → ⚡ 1 click → 💌 Personalized email sent. Done.

---

😤 The Problem (You Know This Pain)

You:  *copies job description*
You:  *opens ChatGPT*
You:  "Write me a cold email for this job"
GPT:  "Dear Hiring Manager, I am writing to express my keen interest..."
You:  *dies inside*
You:  *does this 30 more times today*

There has to be a better way.

---

⚡ Enter ApplyX

1-click from LinkedIn post → personalized email in your drafts. Real demo gif coming — PRs welcome!

ApplyX is a Chrome extension + web dashboard that lives on LinkedIn. Spot a job post, click once, and a laser-targeted cold email — written from your resume, in your voice — is ready to send via Gmail. No copy-paste. No generic templates. No cringe.

---

🔥 Features

Feature	What it does
⚡ 1-Click Generation	Reads the LinkedIn post, grabs your resume, writes a tailored email via Groq (Llama 3.1) in ~1 second
📎 Auto-attach Resume	Your PDF resume is automatically attached to every outreach email
📬 One-Click Send	Fires the email via Gmail API — without leaving the LinkedIn page
🎨 Dynamic Personalization	Your name, portfolio, and vibe are baked into every message
🔒 Self-Hosted & Private	Your data lives in your Supabase. Zero middlemen.
🆓 Actually Free	Groq's free tier handles thousands of generations per day

---

🚀 Quick Start

Prerequisites: Node.js 18+, a Google Cloud project, a Supabase account, a Groq API key.

1. Clone & Install

git clone https://github.com/kiet7uke/ApplyX.git
cd ApplyX

2. Fire up the Extension

cd apps/extension
npm install
npm run dev

Then in Chrome → chrome://extensions → Load Unpacked → select apps/extension/build/chrome-mv3-dev

3. Fire up the Dashboard

cd apps/web
cp .env.example .env.local  # fill in your keys (see below)
npm install
npm run dev

Open localhost:3000 🎉

4. Connect Everything

1. Log into the dashboard → Manage Profile
2. Upload your resume PDF + add your portfolio URL
3. Copy your Extension Key from Dashboard Settings
4. Paste it into the LinkedIn sidebar settings panel
5. Go to LinkedIn. Find a job. Click the button. ✅

---

🛠️ Full Infrastructure Setup

🗄️ Supabase (Database) — click to expand

1. Create a free project at supabase.com
2. In the SQL Editor, run this schema:

-- Users profile table
create table profiles (
  id uuid references auth.users on delete cascade primary key,
  full_name text,
  portfolio_url text,
  resume_url text,
  extension_key uuid default gen_random_uuid(),
  created_at timestamp with time zone default timezone('utc'::text, now())
);

-- Enable Row Level Security
alter table profiles enable row level security;

create policy "Users can view their own profile."
  on profiles for select using ( auth.uid() = id );

create policy "Users can insert their own profile."
  on profiles for insert with check ( auth.uid() = id );

create policy "Users can update own profile."
  on profiles for update using ( auth.uid() = id );

3. Note your Project URL and anon public key from Project Settings → API

🔑 Google OAuth & Gmail API — click to expand

1. Go to Google Cloud Console → New Project
2. Enable the Gmail API: APIs & Services → Library → search "Gmail API" → Enable
3. Create credentials: APIs & Services → Credentials → Create OAuth 2.0 Client ID
   • Application type: Web application
   • Authorized redirect URI: http://localhost:3000/api/auth/callback/google
4. Required OAuth Scopes:
   • openid
   • email
   • profile
   • https://www.googleapis.com/auth/gmail.send
5. Save your Client ID and Client Secret

🤖 Groq (AI Engine) — click to expand

1. Sign up free at console.groq.com
2. Create an API key
3. That's it. Llama 3.1 is absurdly fast (~300 tokens/sec) and the free tier is incredibly generous.

No OpenAI bill. No rate limit anxiety. Just vibes. ✨

🔐 Environment Variables

Create apps/web/.env.local:

# 🤖 AI
GROQ_API_KEY=gsk_...

# 🗄️ Database  
SUPABASE_URL=https://xxxx.supabase.co
SUPABASE_ANON_KEY=eyJ...

# 🔑 Google OAuth + Gmail
GOOGLE_CLIENT_ID=xxxx.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-...

# 🔒 NextAuth
NEXTAUTH_SECRET=your-super-secret-random-string  # run: openssl rand -base64 32
NEXTAUTH_URL=http://localhost:3000

---

🗂️ Project Structure

ApplyX/
├── apps/
│   ├── extension/          # 🧩 Chrome Extension (Plasmo + React)
│   │   └── src/
│   │       ├── sidebar/    # LinkedIn sidebar UI
│   │       └── background/ # Service worker
│   │
│   └── web/                # 🌐 Dashboard & Backend (Next.js)
│       ├── app/            # Next.js App Router
│       ├── components/     # React components
│       └── lib/            # Supabase, NextAuth, Gmail helpers
│
└── packages/               # 📦 Shared logic & types

---

🧠 How It Works

┌─────────────────────────────────────────────────────────┐
│                    LinkedIn Feed                         │
│                                                         │
│  [Job Post by Recruiter]          ┌──────────────────┐  │
│  "We're hiring a Senior           │   ApplyX Sidebar │  │
│   Backend Engineer at Stripe!"    │                  │  │
│                                   │  [Generate ⚡]   │  │
│                                   └────────┬─────────┘  │
└────────────────────────────────────────────┼────────────┘
                                             │
                                    ┌────────▼────────┐
                                    │   Your Resume   │
                                    │  + Post Context │
                                    │  + Your Name    │
                                    └────────┬────────┘
                                             │
                                    ┌────────▼────────┐
                                    │  Groq Llama 3.1 │
                                    │   (~800ms) ⚡   │
                                    └────────┬────────┘
                                             │
                                    ┌────────▼────────┐
                                    │  Personalized   │
                                    │  Email → Gmail  │
                                    │     Sent ✅     │
                                    └─────────────────┘

---

🤝 Contributing

ApplyX is fully open-source and contributions are very welcome!

# Fork the repo, then:
git checkout -b feature/your-amazing-idea
git commit -m "feat: add your amazing idea"
git push origin feature/your-amazing-idea
# Open a PR 🚀

Ideas for contributions:

• 🎯 LinkedIn Easy Apply form auto-fill
• 📊 Application tracking dashboard
• 🌐 Support for other job platforms (Wellfound, Lever, Greenhouse)
• 🔁 Follow-up email scheduling
• 🧪 A/B testing different email tones
• 🌍 Multi-language outreach support

---

💬 Frequently Asked Questions

Q: Is this actually free?
A: Yes. Groq's free tier handles ~14,400 requests/day. You won't hit that limit job hunting.

Q: Is my resume data safe?
A: Your resume lives in your own Supabase instance. ApplyX never touches it.

Q: Will recruiters know I used AI?
A: The output is grounded in your real resume and their actual job post — it reads as genuinely tailored because it is.

Q: Does it work with LinkedIn Premium?
A: Works with any LinkedIn account. Premium not required.

---

⭐ Star History

---

If ApplyX helped you land an interview, drop a ⭐ — it keeps the project alive.

Built with 💜 by kiet7uke because job hunting is exhausting.

Let's make it smarter, together.