Tu portafolio es tu currículum real como desarrollador web. No el PDF con tecnologías listadas — sino los proyectos funcionando que un cliente potencial puede explorar antes de decidir contratarte. Un buen portafolio convierte visitantes en clientes; uno malo (o inexistente) hace que dependas de la suerte.
Qué necesita un portafolio que consiga trabajo
La mayoría de los portafolios fallan porque muestran lo que el desarrollador quiere mostrar, no lo que el cliente necesita ver. Desde la perspectiva del cliente:
- ¿Puede este desarrollador hacer lo que yo necesito?
- ¿Ha trabajado con clientes reales o solo proyectos de práctica?
- ¿Puedo confiar en que entregará?
Tu portafolio debe responder esas tres preguntas en menos de 60 segundos.
Cuántos proyectos necesitas
Calidad sobre cantidad. Tres proyectos sólidos superan a doce proyectos mediocres.
| Número de proyectos | Qué transmite |
|---|---|
| 0-1 | ”Apenas estoy aprendiendo” |
| 2-3 proyectos sólidos | Listo para clientes reales |
| 4-6 proyectos variados | Experiencia demostrable |
| 10+ proyectos pero mediocres | Activo pero sin criterio |
Qué proyectos incluir (y cuáles evitar)
Incluir
- Proyectos con clientes reales (aunque sean amigos o familiares)
- Clones funcionales de apps conocidas (clon de Twitter, de Airbnb, de tienda Amazon) — demuestran capacidad técnica
- Proyectos personales que resuelvan un problema real
- Proyectos de código abierto donde hayas contribuido
Evitar
- Proyectos de tutorial copiados sin modificaciones
- “Hello World” o ejercicios básicos de cursos
- Proyectos rotos o que no cargan
- Demos sin README ni explicación
Cómo presentar cada proyecto
Cada proyecto debe tener:
- Nombre y descripción en una línea — qué hace y para quién
- Screenshot o GIF animado — el 80% de las personas no hacen clic sin ver algo primero
- Tech stack — qué tecnologías usaste y por qué
- Link al demo en vivo — no “próximamente”, algo que funcione ahora
- Link al código en GitHub — para clientes técnicos y empleadores
- Reto y solución — en 2-3 oraciones, qué problema resolviste
Dónde alojar tu portafolio
| Opción | Costo | Pros | Contras |
|---|---|---|---|
| GitHub Pages | Gratis | Simple, integrado con repositorios | No soporta backend |
| Vercel | Gratis (plan básico) | Deploy automático, súper rápido | Límites en plan gratuito |
| Netlify | Gratis (plan básico) | Formularios, functions integradas | Similar a Vercel |
| Dominio propio (.dev, .me) | $10-15 USD/año | Profesional, memorable | Costo mínimo |
Recomendación: Vercel o Netlify + dominio propio. Tener tunombre.dev o tunombre.me ya comunica seriedad.
El sitio web del portafolio
Tu portafolio mismo es un proyecto — y debe estar bien hecho. Un desarrollador web con un portafolio que carga lento, no es responsive o tiene errores de diseño evidentes envía señales negativas.
Estructura mínima:
/ → Hero con tu propuesta de valor
/proyectos → Galería de proyectos con filtros (si tienes varios)
/sobre-mi → Tu historia, stack, disponibilidad
/contacto → Formulario simple o link a CalendlyNo necesitas nada más elaborado al inicio.
Tecnologías para construir el portafolio
Opciones según tu stack:
- HTML/CSS + JS puro: limpio y rápido, muestra que dominas los fundamentos
- React + Vite: si React es tu especialidad, demuéstralo usándolo
- Astro: excelente para sitios estáticos con contenido mixto, performance sobresaliente
- Next.js: si vas al fullstack, es una buena demostración
Evita WordPress para tu portafolio personal a menos que tu nicho sea WordPress — envía el mensaje equivocado.
Conectar GitHub al portafolio
Tu historial de commits en GitHub dice más que tu CV. Consejos:
- Activa el “GitHub Contribution Graph” — verde todos los días (o casi) transmite disciplina
- Escribe READMEs claros con screenshots para cada repositorio
- Usa descripción y topics en cada repo (
react,portfolio,freelance, etc.) - Fija los 6 repositorios más importantes en tu perfil
Errores clásicos de portafolios de desarrollo web
| Error | Por qué hace daño |
|---|---|
| ”Bajo construcción” en secciones | Comunica que no terminas lo que empiezas |
| Proyectos que no cargan | Peor que no tener portafolio |
| Tecnologías listadas sin proyectos que las demuestren | Cualquiera puede escribir “React” en su CV |
| Diseño muy recargado o con UX confusa | Ironía — el desarrollador no puede navegar bien su propio sitio |
| Sin forma de contacto clara | Convertiste un visitante en nada |
Cuándo está “listo” el portafolio
Nunca estará perfecto. Regla práctica: si tienes 2 proyectos funcionando y un formulario de contacto, ya puedes empezar a buscar clientes. Mejoras el portafolio mientras trabajas, no antes de salir a buscar trabajo.
Conclusión
Un portafolio de desarrollo web efectivo no requiere 20 proyectos ni diseño de agencia. Requiere 3 proyectos que demuestren capacidad real, que carguen rápido, con links funcionales y un canal de contacto claro. Construye eso primero, sal a buscar clientes, y mejora tu portafolio con cada proyecto que completes.
¿Quieres feedback en tu portafolio antes de mandarlo a clientes? Comparte el link en el foro — hay desarrolladores más experimentados dispuestos a revisar.