Getting Started with Jopilot 🚀

"You not alone in your job search!" 🤝

Welcome to Jopilot, your comprehensive job search assistant. This guide helps you get up and running quickly with clear, step-by-step instructions based on the current application features and routes.

What You Can Do ✨

• 🏠 Dashboard - Command center with quick actions and overview
• 📄 Resume Management - Upload, edit, and version your resume (Markdown format)
• 🔍 Jobs Management - Add, edit, delete, and bulk import jobs with smart URL handling
• 🔗 Smart URLs - Multiple posting links per job with automatic platform detection
• 📝 Applications - Create from jobs or populate manually, generate AI-powered cover letters, download PDFs
• 🎯 Q&A Preparation - Get AI-generated answers to application or even interview questions
• 👥 Contacts - Aggregated view across applications (LinkedIn, email, phone, other)
• 👤 Profile - Update your personal information and security settings

🔒 Security & Privacy: Your data is protected with Supabase Row Level Security (RLS).

Prerequisites 📋

• 🌐 Access the app at https://jopilot.io
• ✍️ Sign-up requires: first name, last name, email, and password
• 🔑 Registration Code: Required at launch - use FALL2025 (codes rotate and may be limited by availability; check the signup page banner for current codes)

💡 Tip: CSV import is optional and not needed for initial onboarding. If you plan to import later, prepare a CSV with columns like Company, Position, Job Description Link, Status, and optional notes/contacts. Multiple URLs per job are supported.

Quick Start: Your First Application 🚀

Step 1: Sign Up and Set Up Your Profile 🆔

1. 🧭 Navigate to /signup to create your account
2. 📝 Enter required information:
   • First name and last name
   • Email address
   • Password (create a strong one 🔐)
3. 🔑 Registration Code: If prompted, enter the current code (e.g., FALL2025)
4. ✅ Complete email verification if required
5. 👤 Set up your profile with any additional information

Already have an account? Go to /login instead.

After sign-in, you'll land on /dashboard with quick navigation to Resume, Jobs, and Create Application.

Step 2: Upload Your Resume 📄

1. 🧭 Navigate to /dashboard/resume
2. 📤 Upload your resume as a Markdown (.md or .markdown) file, or start editing directly in the browser
3. ✏️ Review and edit using the split-view editor with Markdown/Preview tabs
4. 💾 Save your resume - auto-save and versioning keep your changes safe

Why Markdown? It's simple to edit, easy to version, and works perfectly with AI-assisted composition. ✨

Step 3: Add Your First Job 🔍

1. 🧭 Navigate to /dashboard/jobs
2. ➕ Click "New Job" for manual entry or "Bulk Import" for multiple jobs
3. 🔄 Alternatively, you can create a new Application manually (by going to Applications page: /dashboard/applications/new)

For manual entry:

• 🏢 Enter company name and job title
• 🔗 Add one or more posting URLs - paste raw links, Jopilot automatically:
  • ✨ Canonicalizes and de-duplicates URLs
  • 🧹 Removes tracking parameters
  • 🤖 Detects HR platforms (LinkedIn, Greenhouse, etc.)
• 📊 Set initial status (usually "new")
• 📝 Add any additional notes

For bulk import:

• 📋 Use "Bulk Import" to parse CSV files or pasted text lists
• 🔗 Multiple URLs per job are supported
• 💼 LinkedIn links are automatically prioritized for ordering
• 👀 Preview before confirming the import

Note: Background scraping runs for non-LinkedIn URLs to store content for AI processing. LinkedIn is intentionally excluded. It could take several minutes for the Job Description to be scraped and populated. ⏳

Step 4: Start an Application 📝

1. 📋 From the Jobs list, click "Apply" on your chosen job or go to Applications directly and fill the URL(s) in and details described in the next sections
2. 🤖 Jopilot automatically:
   • 📊 Updates the job status (e.g., to "evaluating")
   • 🚀 Opens the application flow at /dashboard/applications/new
   • 📝 Pre-fills company, job title, and URLs from the job
   • 📄 Extracts job description from scraped content (editable)
3. ✅ Review and confirm application details:
   • 🏢 Company and job title (pre-filled)
   • 📋 Application notes
   • 👤 Hiring manager information (if available)
   • 📞 Contact details
   • 📍 Location and work preferences
   • 🏢 HR platform (auto-detected, editable)
4. ➡️ Click "Proceed to Compose" to continue

Step 5: Generate Your Cover Letter ✨

1. 🧭 Navigate to /dashboard/applications/[id]/compose (automatically opened)
2. 🤖 Use "Generate with AI" to create:
   • 📋 Job summary based on the description
   • 💌 Personalized cover letter using your resume and job requirements
3. ✏️ Review and edit anything freely before saving
4. 📄 Download PDF to save the cover letter as an attachment
5. ✅ Click "Complete Application" to:
   • ✅ Mark the application as completed
   • 📊 Update job status to "applied"
   • 🏠 Return to the dashboard

Step 6: Get Answers to Application or even potential Interview Questions (Optional) 🎯

1. 🧭 From the Compose page, click "Answer Questions" to open /dashboard/applications/[id]/questions
2. ❓ Paste your application or interview questions:
   • One per line or separated by blank lines
   • Up to 15,000 characters supported
3. 🤖 Choose "Save & Generate Answers" to get AI-generated personalized responses
4. 👀 Review answers at /dashboard/applications/[id]/answers
5. 📋 Copy individual answers as needed for your application filling or interview preparation

Daily Workflow Recommendations 📅

Morning Routine (5-10 minutes) ☕

• 🔍 Check out job boards and add new jobs
• 📊 Update application statuses from previous days
• 📞 Identify jobs and contacts needing follow-up or status updates

Job Management 📋

• ➕ Add new interesting postings as you discover them
• 🔄 Update job statuses as you progress through the pipeline
• 🗑️ Remove irrelevant or closed positions to keep your list focused

Application Tracking 📈

• 👀 Monitor application responses and interview schedules
• 📝 Update communication history in application notes
• 📊 Track progress through the application stages

Contact Management 👥

• 🔍 Review new contacts extracted from applications
• 🎯 Search for specific contacts when preparing for interviews
• 🤝 Maintain professional network information for future opportunities

Pro Tips & Best Practices 💡

Job Discovery Efficiency 🔍

• 📋 Use bulk import when you have multiple job postings
• ✨ Take advantage of URL canonicalization - paste raw URLs and let the system clean them up
• 🔗 Multiple URLs per job are great for postings across different platforms (LinkedIn, company site, Indeed, etc.)

AI-Powered Features 🤖

• 📄 Job descriptions are automatically extracted from posting URLs (except LinkedIn)
• 💌 Cover letters are personalized based on your resume and job requirements
• 🎯 Use the Q&A feature to quickly respond to the application or prepare for common interview questions with tailored answers

Data Organization 📊

• 🏷️ Use consistent naming for companies and positions
• 📝 Keep your resume updated in the system for best AI results
• 📋 Add notes and contact information as you gather them during your search

Status Management 📈

Jobs typically progress through these stages: New → Evaluating → Applied → Interview Scheduled → Interviewed → Offer Received → Accepted/Rejected/Dismissed/Withdrawn

Advanced Features 🚀

CSV Import for Historical Data 📊

• 📤 Import historical applications via CSV to bootstrap your pipeline
• ⏰ Preserve original dates with automatic timestamp handling
• 🤖 Contact parsing extracts LinkedIn, email, and phone information automatically

URL Management 🔗

• 🔗 Multiple URLs per job supported with automatic platform detection
• 🧹 URL hygiene: Trackers removed, LinkedIn URLs standardized
• 🕷️ Background scraping stores content for AI processing (LinkedIn excluded)

Contact Search & Management 👥

• 📱 Contacts page (/dashboard/contacts) aggregates all contacts from applications
• 🔍 Search by name, company, or contact value
• 🏷️ Filter by contact type (LinkedIn, email, phone, other)
• 🤝 Build warm outreach lists for networking and follow-ups

Security & Privacy 🔒

• 🛡️ Row Level Security (RLS) ensures your data is isolated and accessible only to you
• 🔐 All sensitive operations run server-side with no service-role secrets exposed to clients
• 🔄 Regular security updates and monitoring
• 🚫 No data sharing with third parties

Keyboard Shortcuts & Navigation ⌨️

• 📂 Use the sidebar for quick navigation between sections
• ⭕ Tab through forms for efficient data entry
• ⬅️ Back buttons provide logical navigation through multi-step flows

Getting Help & Support 🆘

• 📚 Documentation: Additional documentation will be posted to Jopilot web site
• 📖 Scenarios Guide: Work in progress and will be added soon
• 💬 Support: Join Telegram Group or send your questions to support@jopilot.io
• 🚀 Development: Note that application is under active development and you can influence its direction by providing your feedback and recommendations, sharing ideas and requesting features or improvements

Common Questions ❓

Q: Can I import my existing job application data? A: Yes! Use the CSV import feature to bulk import jobs and applications with full timestamp preservation and contact parsing. 📊

Q: How does the AI generate cover letters? A: The system analyzes your resume and the job description to create personalized content that highlights your relevant experience. All content is fully editable before saving. 🤖

Q: Why are LinkedIn URLs excluded from scraping? A: LinkedIn's terms of service prohibit automated scraping. The system respects this while still allowing you to use LinkedIn URLs for tracking and organization. 🚫

Q: Is my data secure? A: Yes, all data is protected with enterprise-grade security, RLS policies, and regular security audits. Your information is never shared with third parties. 🔒

Q: What's the registration code for? A: Registration codes help manage initial user capacity and ensure quality onboarding. Codes rotate periodically - check the signup page for the current code. 🔑

Next Steps 🎯

Once you're comfortable with the basic workflow, explore these advanced features:

1. 📊 CSV Import: Import historical job application data with preserved timestamps
2. 🔗 Multiple URL Management: Handle multiple posting URLs per job effectively
3. 🔍 Contact Search: Use advanced search to find specific contacts quickly
4. 👤 Profile Management: Keep your information current for better AI results
5. ⚙️ Admin Features (admin users only): Access administrative tools and reports

---

Welcome to Jopilot! Your job search journey just got more organized and effective. Remember, "You not alone in your job search!" 🤝

Access the application: https://jopilot.io 🌐