ResumeGlow - Real-Time ATS Optimization Without Generic Advice

Acceptance Criteria

PDF Upload: done when user can upload a .pdf and it extracts text without errors. ATS Score: done when score appears in under 5 seconds and updates live as user edits. Feedback: done when each section shows 1-3 specific actionable suggestions. Freemium: done when free users are limited to 3 parses/month and see upgrade prompt on 4th parse. Stripe: done when checkout processes correctly and user gains immediate access to pro features.

How to build it, step by step

1. Scaffold project: 'npx create-next-app@latest resume-glow --typescript --tailwind --app' — use App Router for streaming responses. 2. Install JS dependencies: 'npm install pdf-parse @supabase/supabase-js @supabase/ssr stripe resend' and 'npm install -D @types/pdf-parse'. 3. Create Supabase project, then run this SQL to create tables: 'CREATE TABLE profiles (id uuid PRIMARY KEY REFERENCES auth.users, plan text DEFAULT free, parse_count int DEFAULT 0, created_at timestamptz DEFAULT now()); CREATE TABLE resume_parsings (id uuid PRIMARY KEY DEFAULT gen_random_uuid(), user_id uuid REFERENCES profiles(id), raw_text text, ats_score int, created_at timestamptz DEFAULT now()); CREATE TABLE section_feedbacks (id uuid PRIMARY KEY DEFAULT gen_random_uuid(), parsing_id uuid REFERENCES resume_parsings(id), section_name text, issue text, suggestion text);' — enable RLS on all three tables and add policy 'USING (user_id = auth.uid())'. 4. Build the PDF upload API route at 'app/api/parse-resume/route.ts': accept multipart/form-data, use pdf-parse to extract raw text ('const data = await pdfParse(buffer); const text = data.text'), then split into sections by detecting headers using regex for common labels (EXPERIENCE, EDUCATION, SKILLS, SUMMARY) — if text extraction returns under 100 characters, return a 422 with message 'PDF text unreadable — please paste resume as text'. 5. Build the ATS heuristic scoring function in 'lib/ats-score.ts': define a static ruleset as a TypeScript object — deduct 10 points if skills section is a paragraph (no newlines or bullets), deduct 15 points if contact info is inside a table (heuristic: pipe characters or tab clusters in first 5 lines), deduct 10 points for date formats not matching MM/YYYY or Month YYYY, deduct 10 points if job titles contain special characters, award 20 points base, scale remaining 40 points by keyword density match against a provided job description. This gives a deterministic 0–100 score without relying on Claude for scoring. 6. Build the Claude API call in 'lib/claude-feedback.ts': POST to 'https://api.anthropic.com/v1/messages' with model 'claude-haiku-4-5', pass a system prompt that includes the static ATS ruleset as context ('You are an ATS parsing expert. The following rules define common ATS failures: [paste ruleset]. Given a resume section, identify which rules are violated and return JSON: {section, issue, suggestion}.'), and pass the extracted section text as the user message — parse the returned JSON to populate section_feedbacks rows. 7. Wire freemium gate in the API route: before parsing, query profiles table for the user's parse_count — if plan is 'free' and parse_count >= 3, return 403 with upgrade prompt. Otherwise increment parse_count. 8. Build real-time score UI in 'app/components/ResumeEditor.tsx': use a controlled textarea for paste input, debounce onChange at 600ms, POST to '/api/parse-resume' on each debounce tick, update a score state variable and re-render the score dial using a simple SVG arc component — animate score changes with CSS transition on stroke-dashoffset. 9. Set up Stripe: create a 'resume-glow-pro' product at $9/month in Stripe dashboard, create '/api/stripe/checkout/route.ts' that calls 'stripe.checkout.sessions.create' with the price ID and user email, and '/api/stripe/webhook/route.ts' that listens for 'checkout.session.completed' and updates the user's plan to 'pro' in Supabase. 10. Deploy: push to GitHub, connect repo to Vercel, add environment variables (ANTHROPIC_API_KEY, SUPABASE_URL, SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY, STRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET, RESEND_API_KEY), set Stripe webhook endpoint to your Vercel prod URL, run end-to-end test: upload a PDF, verify raw text logs, verify score appears under 5 seconds, verify Stripe checkout flow promotes user to pro plan in Supabase.