Skip to main content
INTERACTIVE CHECKLIST · 100% BROWSER PERSISTENCE

Developer Portfolio Checklist

What makes a high-converting developer portfolio?

A hiring manager evaluates your portfolio in under 30 seconds. The goal is not flashy animations, but immediate proof of competence: working live deployment links, clear problem statements in your case studies, accessible contact links, and fast mobile loading times (< 2.5s LCP). Ticking the 9 items below ensures you pass initial technical recruiter triage.

1. Live DeliverablesEvery project links to working production software.
2. Core Web VitalsFast FCP/LCP load times with zero layout shift.
3. Direct ContactDirect mailto and social channels without buggy forms.

100% Client-Side Privacy: Your checklist state is stored only in your local browser storage (localStorage). It is never sent to our servers or stored in any database.

Live Readiness Score(0 of 9 items verified)

Portfolio Health Index

0
/100Significant Presentation Gaps
Unique Page Title & Meta Description
SEO & Hierarchy+10 pts

Why it matters: Search engines, LinkedIn link previews, and recruiters rely on meta tags to preview who you are and what you build before clicking.

How to verify:Inspect your HTML <head>. Ensure <title> includes your name and engineering specialty (under 60 chars), and <meta name="description"> summarizes your experience in under 160 chars.
Exactly One H1 Landmark Heading
SEO & Hierarchy+10 pts

Why it matters: Screen readers and search bots use the H1 as the primary page topic. Having multiple or zero H1s damages accessibility and document outline clarity.

How to verify:Search your DOM for <h1> tags. Verify there is exactly one containing your primary name and value proposition (e.g., "Full-Stack Engineer").
Featured Projects with Working Live Demos
Projects & Content+15 pts

Why it matters: 30-second recruiter scans prioritize verifiable deliverables. Projects without working deployment links or source code force recruiters to guess whether your code runs.

How to verify:Test every project card on desktop and mobile. Verify that live demo URLs (Vercel, Netlify) open instantly and GitHub repository links are public.
Meaningful Alt Text on Screenshots
Accessibility & Contact+10 pts

Why it matters: Screen readers announce alt text to visually impaired engineers, and search engines index it. Empty or generic alt="image" violates WCAG 2.2 AA.

How to verify:Inspect all <img> tags. Ensure alt text describes what the screenshot portrays (e.g. "Interactive Kanban board dashboard with task cards").
Mobile-Friendly Responsive Viewport
Performance & Mobile+15 pts

Why it matters: Over 40% of initial link clicks from resumes or LinkedIn happen on mobile devices. Horizontal overflows or unreadable mobile fonts trigger immediate bounce.

How to verify:Test your portfolio in Chrome DevTools Device Mode (375px width). Check for zero horizontal scrolling, readable touch targets (>= 44x44px), and collapsible navigation.
Direct Contact Channels & Social Links
Accessibility & Contact+10 pts

Why it matters: Recruiters who like your work need zero friction to reach you. Relying solely on a buggy contact form without a direct email or LinkedIn link causes lost outreach.

How to verify:Provide a visible mailto: link, LinkedIn profile URL, and public GitHub link in your navigation or footer.
Concise About Section & Tech Focus
Projects & Content+10 pts

Why it matters: Hiring managers want to understand what problems you enjoy solving and where your technical depth lies in 2-3 focused paragraphs.

How to verify:Ensure your about section highlights your primary tech stack, 1-2 key technical milestones, and what roles you are currently seeking.
Web Vitals & Performance Hygiene (< 2.5s LCP)
Performance & Mobile+15 pts

Why it matters: A slow portfolio suggests that an engineer does not consider production end-user performance or asset optimization.

How to verify:Run Google PageSpeed Insights on your URL. Verify Largest Contentful Paint (LCP) is under 2.5s, images are compressed (WebP/AVIF), and fonts load asynchronously.
Semantic Landmarks & Keyboard Usability
Accessibility & Contact+5 pts

Why it matters: Using proper semantic HTML tags (<header>, <nav>, <main>, <footer>) ensures your portfolio is keyboard navigable (Tab navigation) and compliant with modern web standards.

How to verify:Navigate your entire portfolio using only the Tab and Enter keys. Ensure all interactive links and buttons have visible focus outlines.

Want an automated, live audit of your website?

DEV//REALITY automatically inspects your HTML landmarks, meta tags, and live Google PageSpeed Web Vitals alongside your GitHub profile.