Un buen portfolio de programador reúne entre tres y cinco proyectos terminados, desplegados y con una explicación corta de qué problema resuelven y qué decisiones tomaste. Mejor pocos y funcionando que muchos a medias. Abajo tienes qué proyectos elegir, cómo presentar cada uno y cómo ponerlo en línea para que se abra con un clic.
El número es criterio mío, no una regla: varias guías de formación y de empleo tech coinciden en un rango parecido, y tiene sentido. Quien te entrevista dedica pocos minutos a mirar tu trabajo. Si los dedica a tres proyectos que abren y se entienden, ve más que si se pierde entre diez repositorios.
Si todavía estás decidiendo por dónde empezar como programador, antes te puede servir el artículo sobre cómo trabajar como programador web freelance. Este va de lo que enseñas, no de cómo captar clientes.
Qué tiene que lograr tu portfolio en dos minutos
Tu portfolio tiene que responder a tres preguntas de quien lo abre: qué sabes hacer, si lo has terminado de verdad y si puedes explicar cómo lo hiciste. Todo lo demás, desde los colores hasta las animaciones, importa menos que esas tres respuestas visibles en pocos clics.
Piensa en la persona al otro lado. Puede ser una reclutadora técnica que ve decenas de perfiles o un desarrollador senior con la agenda llena. Es raro que clone tus repositorios o lea tu código línea a línea antes de la entrevista. Lo normal es que mire tu página, abrir uno o dos enlaces y decidir si tiene preguntas que hacerte.
Por eso el portfolio es una pieza de lectura rápida. Cada proyecto debe poder entenderse sin instalar nada: una demo en vivo, una captura y tres frases. El detalle técnico está en el repositorio para quien quiera bajar a él, y en la conversación de la entrevista para el resto.
Cuántos proyectos incluir y cuáles elegir
Incluye de tres a cinco proyectos y que cada uno demuestre algo distinto: una interfaz cuidada, el consumo de datos externos, datos que se guardan y se recuperan, y algo más ambicioso donde se junten varias piezas. Si dos proyectos demuestran lo mismo, deja el mejor y descarta el otro.
Esta tabla resume los cuatro tipos que yo cubriría y qué enseña cada uno:
Tipo de proyecto | Ejemplo | Qué demuestra |
|---|---|---|
Web estática bien hecha | Una landing responsive | HTML y CSS con criterio, diseño adaptable, que sabes publicar |
App que usa una API externa | Una app del tiempo | Peticiones a un servicio ajeno, estados de carga y de error |
App con datos propios | Una app de notas con base de datos | Modelado de datos, backend, edición y borrado de registros |
Producto con varias piezas | Un panel en tiempo real o una suscripción con login | Autenticación, flujos completos, despliegue de extremo a extremo |
Un ejemplo de progresión real es el temario de Rock the AI Code, que según su ficha, consultada el 3-11-2026, incluye «8 proyectos reales entregables de dificultad progresiva: desde una landing page hasta un SaaS completo». Los títulos de la ficha son Landing page, App del tiempo, Portfolio interactivo, App de notas, Suscripción de pago, Live Dashboard, Asistente con IA y un proyecto integrador. Fíjate en que cada uno sube un escalón. Tu selección puede seguir esa lógica aunque no hagas ese programa.
Si estás empezando y solo tienes un proyecto presentable, empieza por ahí. Un portfolio con un proyecto bien contado vale más que uno vacío a la espera de tener cinco. Ve añadiendo según termines.
Qué conviene revisar antes de publicar un proyecto
Antes de enseñar un proyecto, comprueba que se abre, que hace lo que dices y que se parece lo menos posible a la versión del tutorial de la que partiste. Con esas tres comprobaciones evitas casi todo lo que le resta valor a un portfolio, y te lleva menos de una tarde por proyecto.
Que funcione desde la URL pública. Ábrelo desde un navegador sin sesión iniciada y desde el móvil. Un enlace roto es lo primero que se ve.
Que no sea el tutorial tal cual. Si el proyecto sigue un curso paso a paso, añade algo tuyo: una función, un cambio de datos, otro diseño. Contarlo en la ficha lo convierte en tu trabajo.
Que esté terminado. Un proyecto con la mitad de las funciones y un «próximamente» pesa menos que uno pequeño y completo. Si no está listo, sácalo del portfolio hasta que lo esté.
Que no lleve claves ni datos privados. Revisa que ningún fichero
.env, token o contraseña haya acabado en el repositorio.
Lo que no cumpla algo de esto no tiene por qué desaparecer para siempre. Se queda en tu GitHub, fuera del escaparate, hasta que lo termines.
Cómo presentar cada proyecto
Cada proyecto necesita una ficha corta con seis elementos: nombre, qué problema resuelve, qué tecnologías usa, una decisión que tomaste, el enlace a la demo y el enlace al repositorio. Con eso, quien te lee entiende el proyecto en menos de un minuto y sabe de qué preguntarte en la entrevista.
El elemento que casi nadie escribe, y el que más aporta, es la decisión. «Usé React» no dice nada. «Guardé el estado del carrito en el navegador porque no necesitaba cuentas de usuario, y lo habría movido al servidor si las hubiera» enseña cómo piensas. Una sola frase así por proyecto ya te distingue.
Esta es la plantilla que usaría para el README de cada repositorio. Cópiala y rellénala:
El apartado de ejecución en local importa más de lo que parece. Si alguien técnico quiere probar tu código y los comandos no funcionan, la conclusión que saca no es buena. Pruébalos tú en una carpeta limpia antes de publicarlos.
Despliega para que se abra con un clic
Un proyecto que solo vive en tu ordenador no sirve para un portfolio. Despliégalo en un servicio de alojamiento y enlaza la URL pública en la ficha. Tres opciones habituales son GitHub Pages, Netlify y Vercel, y las tres documentan cómo hacerlo en sus páginas oficiales.
GitHub Pages es, según su documentación, un servicio de hospedaje de sitios estáticos que toma archivos HTML, CSS y JavaScript directamente de un repositorio de GitHub. Encaja con webs sin servidor propio: una landing o tu propio portfolio. Si tu cuenta es usuario, su sitio personal se publica desde un repositorio llamado usuario.github.io.
Netlify permite publicar arrastrando la carpeta de tu proyecto, y también conectando un repositorio de Git. Vercel trabaja con entornos de local, vista previa y producción, y permite volver a un despliegue anterior de producción si algo sale mal. Para proyectos con servidor o base de datos, esta última vía te da más margen.
Cuál elegir importa poco. Elige uno, despliega tu primer proyecto con él y reutiliza el método en los siguientes. Después, comprueba el resultado con Lighthouse, la herramienta abierta de Google que audita rendimiento, accesibilidad y SEO de una página que puedes lanzar desde las herramientas de desarrollo de Chrome. Un portfolio que carga rápido y se lee bien en el móvil ya dice algo de ti.
Tu GitHub también es un escaparate
Tu perfil de GitHub es de lo primero que suele mirar quien te entrevista. Fija en él tus mejores repositorios: GitHub permite anclar hasta seis entre repositorios y gists, y esos son los que se ven primero. Que coincidan con los proyectos de tu portfolio.
Según la documentación de GitHub, se hace desde tu perfil, con la opción de personalizar los anclajes. Ordénalos de más a menos presentable.
Dos hábitos que se notan desde fuera: historial de commits con mensajes que se entienden, y un README en cada repositorio anclado. Un repositorio sin README obliga a quien lo abre a adivinar qué hace. Si quieres ver qué piezas se esperan de un perfil que construye de punta a punta, el artículo sobre qué hace un desarrollador full stack te da el mapa.
Tu propio portfolio también cuenta como proyecto
La web de tu portfolio es en sí un proyecto que se puede evaluar. Hazla simple: tu nombre, una frase sobre lo que haces, tus tres o cuatro mejores proyectos con su ficha y una forma de contactarte. Si la construyes con un framework como React, el propio sitio demuestra componentes reutilizables y despliegue.
No necesitas una web con animaciones ni un diseño de agencia. Necesitas que cargue rápido, que se vea bien en el móvil y que se actualice sin sufrir cuando añadas un proyecto. La guía de React para desarrollar aplicaciones web modernas te sirve si quieres montarla con ese framework.
En Rock the AI Code, el «Proyecto 03» es justo este: un «Portfolio profesional interactivo con herramientas de IA», en el que, según la ficha, se construye «un portfolio React con componentes reutilizables, estado y despliegue continuo». Es un buen ejemplo de cómo convertir tu portfolio en un proyecto más del programa y no en una tarea aparte.
Del primer proyecto al portfolio desplegado
Rock the AI Code te lleva de una landing page a un SaaS completo con 8 proyectos reales entregables de dificultad progresiva. Descarga el dossier y mira los proyectos y el temario.
Cómo contar tus proyectos en la entrevista
En la entrevista, cuenta cada proyecto en tres movimientos: qué problema tenía, qué decidiste y qué cambiarías hoy. Treinta segundos por proyecto bastan. La persona que entrevista suele tirar del hilo de la decisión, y ahí es donde tener la ficha escrita te ahorra improvisar.
Prepara una respuesta honesta para «¿qué parte te costó más?». No hace falta que sea dramática. «Me costó entender cómo se guardan las sesiones y lo resolví leyendo la documentación del framework» es una buena respuesta, porque demuestra que sabes buscar y aprender.
Si usaste IA para escribir parte del código, dilo con naturalidad y, sobre todo, ten claro qué hace. La propia ficha de Rock the AI Code plantea ese objetivo: aprender a desarrollar con la IA como herramienta de trabajo, «sabiendo siempre qué hace tu código, no aceptándolo a ciegas». Es una buena regla para el portfolio y para la entrevista: puedes explicar cada pieza porque la entendiste. Para ver cómo se está moviendo el perfil que trabaja así, lee el artículo sobre el perfil del desarrollador agéntico.
Un plan para esta semana y para el mes
Si hoy tienes un solo proyecto, haz esto esta semana: despliégalo, escribe su ficha y su README, y ancla el repositorio en tu perfil. Con eso ya tienes un portfolio de uno, que es más de lo que tiene mucha gente. El resto se construye proyecto a proyecto.
Un plan de cuatro semanas razonable: la primera, un proyecto de web estática publicado y con ficha; la segunda, una app que consuma una API externa; la tercera, una con datos propios y base de datos; la cuarta, tu página de portfolio que reúna los tres. Es un ejemplo, no una receta, y lo puedes ajustar a tu tiempo.
Si prefieres hacerlo con un camino guiado, Rock the AI Code propone justo esa progresión: los 8 proyectos de la landing al SaaS están pensados para acabar en un portfolio desplegado. Tienes todo el detalle en su ficha del programa.
Construye tu portfolio proyecto a proyecto
Descarga el dossier de Rock the AI Code y descubre los 8 proyectos que construirás, el syllabus completo y todo lo que necesitas saber antes de solicitar tu plaza.
Preguntas frecuentes sobre el portfolio de programador
¿Cuántos proyectos debe tener un portfolio de programador?
Entre tres y cinco proyectos terminados, que demuestren cosas distintas, es un buen punto de partida. Si solo tienes uno, publícalo igualmente con su ficha y ve añadiendo. Un portfolio pequeño con proyectos que abren y se entienden funciona mejor que uno largo con proyectos a medias.
¿Qué proyectos poner en el portfolio si no tengo experiencia laboral?
Proyectos personales y los que hayas hecho durante tu formación. Una landing publicada, una app que consuma una API y una con base de datos ya cubren lo esencial. Lo que importa es que funcionen, que cuentes qué hiciste tú y que puedas explicar tus decisiones.
¿Puedo incluir proyectos hechos siguiendo un tutorial?
Sí, siempre que añadas algo tuyo y lo cuentes: una función nueva, otro conjunto de datos u otro diseño. En la ficha explica qué parte es tuya. Un proyecto de tutorial con tu cambio y su explicación es mejor que uno propio sin terminar.
¿Necesito una web propia o me basta con GitHub?
GitHub es casi obligatorio para un perfil técnico, pero una web propia hace que quien te entrevista vea tu trabajo sin leer código. Lo ideal es tener las dos: la web con las fichas y la demo, y GitHub con los repositorios anclados y sus README.
¿Dónde puedo alojar mi portfolio?
En un servicio de alojamiento de sitios y aplicaciones, como GitHub Pages, Netlify o Vercel. Los tres tienen documentación oficial para publicar desde un repositorio. Para una web estática, GitHub Pages basta; para una aplicación con servidor, Netlify o Vercel dan más opciones.
¿Puedo incluir proyectos hechos con ayuda de IA?
Sí, siempre que entiendas qué hace el código y puedas explicarlo. Indica en la ficha qué decisiones tomaste tú. En la entrevista te preguntarán por el funcionamiento, no por quién escribió cada línea, y ahí es donde se nota si entendiste lo que publicaste.
