Skip to content

Obada-barakat/ApplicationPilot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

7 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

ApplicationPilot โœˆ๏ธ

An intelligent job application tracking system with automated follow-up reminders

License n8n Status

๐Ÿ“‹ Overview

ApplicationPilot is a comprehensive automation solution designed to streamline the job search process. It eliminates the hassle of manually tracking applications and ensures you never miss an important follow-up opportunity.

The system consists of two intelligent workflows that work together to capture, store, and manage your job applications while automatically reminding you to follow up with employers at the optimal time.

The Problem

Job seekers often struggle with:

  • Keeping track of multiple applications across different companies
  • Remembering to follow up after 7-10 days (the recommended timeframe)
  • Maintaining organized records of application details and contacts
  • Missing opportunities due to forgotten follow-ups

The Solution

ApplicationPilot automates the entire tracking and follow-up process, allowing you to focus on preparing for interviews rather than managing spreadsheets.


โœจ Features

๐ŸŽฏ Core Functionality

  • Beautiful submission form - Clean, responsive HTML form for logging applications
  • Automatic data logging - All applications stored in Google Sheets with timestamps
  • Instant confirmation emails - Receive immediate confirmation when an application is logged
  • Smart follow-up system - Automated reminders sent 7 days after application
  • Status tracking - Monitor application progress (Applied, Interview, Rejected, Offer)
  • No-duplicate reminders - Tracks which applications have received follow-up reminders

๐Ÿค– Automation Features

  • Daily scheduled checks - Runs automatically every day at 9:00 AM
  • Intelligent filtering - Only reminds about applications that need attention
  • Auto-update tracking - Marks applications as "followed up" after reminder is sent
  • Customizable timing - Easy to adjust the follow-up period

๐Ÿ› ๏ธ Tech Stack

Core Technologies

  • n8n - Workflow automation platform
  • Google Sheets API - Data storage and management
  • Gmail API - Email notifications and reminders
  • JavaScript - Custom logic and date calculations
  • HTML/CSS - Front-end form interface

APIs & Integrations

  • Google OAuth 2.0
  • RESTful webhooks
  • Cloud-based automation

๐Ÿ—๏ธ Architecture

System Components

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   HTML Form     โ”‚
โ”‚  (User Input)   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         โ”‚
         โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚    Webhook      โ”‚
โ”‚   (n8n Trigger) โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         โ”‚
         โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”       โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Google Sheets  โ”‚โ—„โ”€โ”€โ”€โ”€โ”€โ”€โ”ค  Schedule Triggerโ”‚
โ”‚   (Data Store)  โ”‚       โ”‚   (Daily 9 AM)   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
         โ”‚                         โ”‚
         โ–ผ                         โ–ผ
โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”       โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  Gmail (Send)   โ”‚       โ”‚  Read & Filter   โ”‚
โ”‚  Confirmation   โ”‚       โ”‚  Applications    โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                   โ”‚
                                   โ–ผ
                          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                          โ”‚   Code Node      โ”‚
                          โ”‚ (Date Filter)    โ”‚
                          โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                   โ”‚
                                   โ–ผ
                          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                          โ”‚  Gmail (Send)    โ”‚
                          โ”‚   Reminder       โ”‚
                          โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                   โ”‚
                                   โ–ผ
                          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                          โ”‚  Update Sheet    โ”‚
                          โ”‚ (Mark Sent)      โ”‚
                          โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Workflow 1: Application Submission

  1. User submits job application via HTML form
  2. Webhook receives form data
  3. Data logged to Google Sheets with timestamp
  4. Confirmation email sent to user

Workflow 2: Follow-up Reminders

  1. Schedule trigger runs daily at 9:00 AM
  2. Retrieves all applications from Google Sheets
  3. Filters for applications that:
    • Are 7+ days old
    • Status = "Applied"
    • No follow-up reminder sent yet
  4. Sends reminder email with application details
  5. Updates sheet to mark reminder as sent

๐Ÿ“ธ Screenshots

Application Form

alt text[]

Google Sheets Dashboard

alt text

n8n Workflows

Workflow 1: Form Handler _alt text

Workflow 2: Follow-up Automation []alt text


๐Ÿš€ Setup Instructions

Prerequisites

  • n8n instance (cloud or self-hosted)
  • Google account
  • Google Cloud project with enabled APIs:
    • Google Sheets API
    • Google Drive API
    • Gmail API

Step 1: Google Cloud Setup

  1. Go to Google Cloud Console
  2. Create a new project or select existing one
  3. Enable required APIs:
    • Google Sheets API
    • Google Drive API
    • Gmail API
  4. Create OAuth 2.0 credentials:
    • Go to "Credentials" โ†’ "Create Credentials" โ†’ "OAuth client ID"
    • Choose "Web application"
    • Add authorized redirect URI: https://your-n8n-instance.com/rest/oauth2-credential/callback
    • Save Client ID and Client Secret

Step 2: Google Sheets Setup

  1. Create a new Google Sheet
  2. Add these column headers:
    • Timestamp
    • Company Name
    • Position
    • Date Applied
    • Contact Email
    • Your Email
    • Status
    • Follow-up Sent

Step 3: n8n Configuration

Workflow 1: Form Handler

  1. Import the workflow JSON (provided in /workflows folder)
  2. Configure Google Sheets credential
  3. Configure Gmail credential
  4. Update webhook URL in HTML form
  5. Activate workflow

Workflow 2: Follow-up Reminders

  1. Import the workflow JSON
  2. Configure Google Sheets credential
  3. Configure Gmail credential
  4. Set desired schedule time
  5. Update Code node if needed (default: 7 days)
  6. Activate workflow

Step 4: Deploy HTML Form

  1. Update the webhook URL in job-application-form.html
  2. Deploy to:
    • GitHub Pages
    • Netlify
    • Vercel
    • Or any static hosting service

๐Ÿ“ Project Structure

ApplicationPilot/
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ workflows/
โ”‚   โ”œโ”€โ”€ form-handler.json
โ”‚   โ””โ”€โ”€ follow-up-reminders.json
โ”œโ”€โ”€ form/
โ”‚   โ””โ”€โ”€ job-application-form.html
โ”œโ”€โ”€ screenshots/
โ”‚   โ”œโ”€โ”€ form.png
โ”‚   โ”œโ”€โ”€ google-sheet.png
โ”‚   โ”œโ”€โ”€ workflow-1.png
โ”‚   โ””โ”€โ”€ workflow-2.png
โ””โ”€โ”€ docs/
    โ””โ”€โ”€ SETUP.md

๐Ÿ”ฎ Future Enhancements

Planned Features

  • Analytics Dashboard - Visualize application metrics and trends
  • LinkedIn Integration - Auto-import job postings
  • AI-Powered Insights - Suggest optimal follow-up times based on industry
  • Interview Scheduler - Calendar integration for interview tracking
  • Company Research Notes - Store and organize company research
  • Weekly Summary Reports - Digest of application activity
  • Mobile App - Native mobile interface
  • Chrome Extension - One-click application logging

Potential Integrations

  • LinkedIn API
  • Indeed API
  • Glassdoor API
  • Calendar APIs (Google Calendar, Outlook)
  • Notion API (for detailed note-taking)

๐Ÿ’ก What I Learned

Building ApplicationPilot taught me valuable skills in:

Technical Skills

  • Workflow Automation: Designing and implementing complex multi-step automation workflows
  • API Integration: Working with Google OAuth 2.0 and RESTful APIs
  • JavaScript Logic: Implementing date calculations and filtering algorithms
  • Data Management: Structuring and manipulating data across different platforms
  • Front-end Development: Creating responsive, user-friendly forms

Problem-Solving

  • Async Operations: Handling asynchronous API calls and data flow
  • Error Handling: Building robust systems that gracefully handle failures
  • User Experience: Designing intuitive interfaces for non-technical users
  • Scheduling Logic: Implementing time-based triggers and conditions

Best Practices

  • Modular workflow design
  • Clear documentation
  • Scalable architecture
  • Security considerations (OAuth 2.0)

๐Ÿค Contributing

While this is a personal portfolio project, suggestions and feedback are welcome!

If you'd like to:

  • Report a bug
  • Suggest an enhancement
  • Share your implementation

Feel free to open an issue or reach out directly.


๐Ÿ“ License

This project is licensed under the MIT License - see the LICENSE file for details.


๐Ÿ‘ค Author

Ubba Obada


๐Ÿ™ Acknowledgments

  • n8n community for excellent documentation and support
  • Google for providing robust APIs
  • The job-seeking community for inspiring this project

๐Ÿ“ž Contact

Have questions or want to collaborate? Reach out!


โญ If you found this project helpful, please consider giving it a star!


Built with โค๏ธ and n8n automation

About

An intelligent job application tracking system with automated follow-up reminders

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages