Un buen currículum de programador cabe en una página, muestra resultados y lleva a la persona que lee a su portafolio. Un buen portafolio tiene pocos proyectos, bien explicados, con el código en GitHub y una demostración que funcione. Los dos se complementan: el currículum hace que alguien quiera ver su trabajo, y el portafolio prueba lo que el currículum afirma.
Si estás comenzando y aún no tienes experiencia registrada, esta guía es para ti. Vamos a armar el currículum paso a paso, luego el portafolio, y terminaremos con una lista de verificación para revisar todo antes de enviar la primera candidatura.
Lo que buscan primero los que contratan
Quien lee muchos currículums hace una primera lectura rápida en busca de lo esencial: el puesto que buscas, las tecnologías que usas, la experiencia o los proyectos más recientes y una forma fácil de contactarte. El resto solo se lee si esa primera pasada convence.
Esto cambia la forma de escribir. Cada línea debe ayudar a la persona a decidir si vale la pena llamarte para una conversación. Lo que no ayuda, obstaculiza, porque esconde lo que importa.
Cómo armar un buen currículum de programador
1. Usa una sola página
Al inicio de la carrera, una página es suficiente y es lo que la mayoría de los reclutadores prefiere leer. Más que eso suele significar que has incluido información que no ayuda. Cuando necesites recortar, elimina lo que no tiene relación con la vacante.
2. Sigue una estructura simple
Un orden que funciona para quienes están comenzando:
Nombre Apellido
Desarrolladora Front-end Junior | São Paulo, SP (acepto remoto)
[email protected] | linkedin.com/in/tu-perfil | github.com/tu-usuario | tusitio.dev
RESUMEN
2 o 3 líneas: quién eres, con qué trabajas y qué buscas.
HABILIDADES TÉCNICAS
Lenguajes: JavaScript, TypeScript, HTML, CSS
Frameworks: React, Node.js
Herramientas: Git, GitHub, Docker, Figma
PROYECTOS
Nombre del proyecto: qué hace, tecnologías y resultado. Link de GitHub y de la demostración.
EXPERIENCIA
Puesto, empresa, periodo, y lo que entregaste.
FORMACIÓN Y CURSOS
Curso, institución, año.
Si tienes poca experiencia profesional, coloca Proyectos antes de Experiencia. Quien tiene más tiempo de carrera hace lo contrario.
3. Escribe resultados, no solo tareas
Una lista de tareas dice lo que hacías. Un resultado dice lo que cambió por causa de tu trabajo. Usa esta fórmula: verbo de acción, lo que hiciste, la tecnología y el resultado.
Débil: Responsable de desarrollar pantallas del sistema.
Mejor: Desarrollé 12 pantallas en React con TypeScript y reduje de 5 a 2
minutos el tiempo de registro de clientes.
Los números del ejemplo son ilustrativos. Usa los tuyos, y cuando no sepas el número exacto, describe el efecto: "hizo que la carga fuera más rápida", "eliminó un error que bloqueaba el inicio de sesión". Nunca inventes métricas, porque puedes ser cuestionado sobre ellas en una entrevista.
4. Lista habilidades con honestidad
Agrupa las habilidades por tipo (lenguajes, frameworks, herramientas) e incluye solo lo que puedes explicar y usar. Evita barras de nivel, estrellas o porcentajes: nadie sabe lo que significa "80% de JavaScript". Si una tecnología aparece en el currículum, espera que pregunten sobre ella.
5. ¿Sin experiencia? Muestra práctica
Cuando aún no has tenido tu primer empleo en el área, lo que entra en lugar de la experiencia es práctica comprobable:
- Proyectos personales publicados en GitHub, con demostración en línea
- Cursos con certificación, citando lo que construiste en ellos
- Contribuciones en proyectos de código abierto, aunque sean pequeñas
- Trabajo voluntario, freelas y proyectos para amigos o para tu comunidad
- Hackathons, desafíos y competiciones de programación
¿Quieres armar o mejorar tu currículum? Crea el tuyo en Hcode Class y verifica si está organizado, claro y listo para enviar.
6. Adapta el currículum para cada vacante
Lee la descripción de la vacante y destaca en tu currículum las tecnologías y responsabilidades que coinciden con lo que ya has hecho. No es necesario reescribir todo: ajusta el resumen, el orden de las habilidades y los proyectos que aparecen primero. Algunos sistemas de selección leen el texto del archivo, así que usa las mismas palabras de la vacante cuando sean verdaderas para ti.
7. Cuida del formato
- Envía en PDF, con texto seleccionable, a menos que la vacante pida otro formato.
- Nombrar el archivo de forma clara, como
nombre-apellido-curriculum.pdf. - Usa una fuente legible, títulos claros y bastante espacio en blanco. Evita columnas complicadas, demasiados íconos y texto dentro de imágenes.
- Deja los links clicables y prueba todos antes de enviar.
- Usa un email profesional, preferiblemente con tu nombre.
- Foto, CPF, RG y estado civil no son necesarios. Solo informa lo que ayuda en la candidatura.
- Revisa el portugués. Un error tipográfico en el encabezado da la impresión de falta de cuidado.
Errores comunes en el currículum
- Más de una página al inicio de la carrera: lo esencial se pierde en medio del texto.
- Objetivo genérico: "buscar una oportunidad de crecimiento" no dice nada. Escribe el puesto y el área.
- Lista de tecnologías sin prueba: cada habilidad debería aparecer también en un proyecto o en una experiencia.
- El mismo currículum para todas las vacantes: la persona que lee se da cuenta cuando no fue pensado para esa oportunidad.
- Links rotos o sin destacar: si GitHub y el portafolio no son visibles, pierdes la mejor parte de tu candidatura.
Cómo armar un buen portafolio de desarrollador
El portafolio es la vitrina de tu trabajo. Es donde alguien verifica, en la práctica, lo que el currículum promete. Para quienes están comenzando, una combinación simple resuelve: un perfil organizado en GitHub, con el código de los proyectos, y una página propia, un sitio simple alojado gratuitamente, con la presentación y los enlaces.
1. Escoge de 3 a 5 proyectos
Calidad vale más que cantidad. Tres proyectos completos y bien explicados impresionan más que quince incompletos. Escoge proyectos que muestren habilidades diferentes:
- Una aplicación con registro, inicio de sesión y base de datos, que muestra que sabes armar un sistema completo
- Un proyecto que consume una API y maneja errores y cargas
- Un proyecto con pruebas automatizadas
- Un proyecto publicado en internet, con una dirección que cualquiera puede abrir
Proyectos hechos siguiendo un curso tienen valor, pero evita publicar la copia exacta del tutorial. Agrega algo tuyo, como una funcionalidad nueva, un diseño diferente o una regla de negocio propia, y explica lo que cambiaste.
2. Cuenta el problema, la solución y la tecnología
Para cada proyecto, responde a tres preguntas en pocas líneas: qué problema resuelve, cómo lo resolviste y con qué tecnologías. Una tarjeta de proyecto simple ya funciona:
Control de Gastos
Aplicación web para registrar y categorizar gastos mensuales.
Resuelve: quien anota gastos en hojas de cálculo y pierde el control al final del mes.
Stack: React, TypeScript, Node.js, PostgreSQL.
Destacar: gráficos por categoría y alerta al pasar del límite definido.
Enlaces: demostración | código en GitHub
3. Cuida el README
El README es lo primero que alguien ve al abrir el repositorio. Un README bien hecho vale más que un código bonito que nadie sabe cómo ejecutar. Una estructura que funciona:
# Nombre del proyecto
Una frase diciendo lo que hace el proyecto.
## Demostración
Enlace al proyecto en funcionamiento.
## Tecnologías
React, TypeScript, Node.js, PostgreSQL
## Cómo ejecutar
1. git clone ...
2. npm install
3. copia .env.example a .env y completa
4. npm run dev
## Decisiones técnicas
Por qué elegí cada herramienta y qué haría diferente.
## Próximos pasos
Lo que aún quiero mejorar.
4. Deja el proyecto funcionando
Quien evalúa tu portafolio no va a instalar nada para ver si funciona. Publica cada proyecto y deja el enlace en el README y en el currículum. Las instrucciones para ejecutar localmente también deben funcionar de verdad: prueba en una carpeta limpia, siguiendo solo lo que está escrito.
Un cuidado importante: nunca publiques contraseñas, tokens o claves de API en el repositorio. Usa variables de entorno, mantén el archivo .env fuera de Git y añade un .env.example solo con los nombres de las variables. Si algún secreto ya fue publicado, cámbialo inmediatamente.
5. Cuida del código y del historial
Quien tiene experiencia mira el repositorio con atención. Mantén las carpetas organizadas, usa nombres claros, escribe mensajes de commit que expliquen el cambio y elimina el código que no está en uso. Algunas pruebas y un linter configurado muestran madurez, incluso en proyectos pequeños.
6. Organiza tu perfil en GitHub y LinkedIn
- En GitHub, usa foto, nombre y una bio corta, y fija en el perfil los 3 a 6 repositorios que quieres mostrar.
- Crea el README del perfil (un repositorio con tu nombre de usuario) con una presentación rápida y los enlaces principales.
- En LinkedIn, mantén cargo, resumen y proyectos coherentes con el currículum, con enlace al portafolio.
- Si vas a configurar el acceso a GitHub por terminal, ve cómo agregar una clave SSH a GitHub.
7. Arma un sitio simple de portafolio
Una página con cuatro bloques es suficiente: quién eres, los proyectos (con la tarjeta de cada uno), las tecnologías que usas y el contacto. Debe cargar rápido, funcionar bien en el celular y tener enlaces que abran. Puedes publicarla gratuitamente, por ejemplo, con alojamiento en Firebase Hosting y dominio .com.br.
Errores comunes en el portafolio
- Demasiados proyectos y todos incompletos: prefiere pocos, pero finalizados.
- Repositorio sin README: quien abre no entiende qué es ni cómo verlo funcionando.
- Nombres como "prueba1" y "proyecto-final-v2": nombres claros muestran organización.
- Proyecto que no abre: el enlace del despliegue fuera de línea da la impresión de abandono.
- Secretos publicados en el código: además del riesgo de seguridad, es una señal de alerta para quien evalúa.
Cómo currículum y portafolio trabajan juntos
Los dos deben contar la misma historia. Los proyectos que aparecen en el currículum son los mismos que aparecen en el portafolio, con el mismo nombre, la misma descripción corta y enlaces directos. El currículum resume y el portafolio detalla. Deja el enlace del portafolio y de GitHub en el encabezado del currículum y, en cada candidatura, elige los proyectos más cercanos a la vacante para ir primero.
Actualiza los dos con cada nuevo proyecto o tecnología aprendida. Un portafolio estancado hace que peses en contra.
Lista de verificación final antes de enviar
- ☐ El currículum tiene una página, en PDF, con texto seleccionable
- ☐ El encabezado tiene el puesto deseado, email profesional, LinkedIn, GitHub y portafolio
- ☐ Cada experiencia o proyecto muestra resultado, no solo tarea
- ☐ Todas las habilidades listadas aparecen en algún proyecto o experiencia
- ☐ El currículum fue adaptado para la vacante
- ☐ Todos los enlaces han sido probados
- ☐ El portafolio tiene de 3 a 5 proyectos finalizados
- ☐ Cada proyecto tiene README, demostración en línea e instrucciones que funcionan
- ☐ Ningún secreto (contraseña, token o clave) está en el repositorio
- ☐ El perfil de GitHub y el de LinkedIn están organizados y coherentes con el currículum
Próximos pasos
Elige un proyecto tuyo y escribe hoy el README completo. Luego arma el currículum de una página con la estructura de esta guía y pide a alguien de confianza que lo lea y diga lo que entendió en pocos segundos. Ajusta lo que genere dudas, publica y comienza a postular.
Para seguir aprendiendo, conoce la plataforma de cursos de Hcode y sigue las próximas guías de carrera en el blog.
Preguntas frecuentes
¿Debo poner foto en el currículum?
No es necesario. Foto, CPF, RG y estado civil no ayudan en la candidatura. Informa solo lo que muestra que eres la persona adecuada para la vacante.
¿Cuántos proyectos debo tener en el portafolio?
De 3 a 5 proyectos finalizados, con README, demostración en línea y código en GitHub. Pocos proyectos bien explicados valen más que muchos incompletos.
¿Proyectos hechos en curso valen en el portafolio?
Valen, siempre que agregues algo tuyo (una funcionalidad nueva, otro diseño o una regla de negocio propia) y expliques lo que cambió en relación al tutorial.
¿Currículum en PDF o en Word?
PDF, con texto seleccionable, a menos que la vacante pida otro formato. Mantiene el formato en cualquier dispositivo.
¿Necesito tener un sitio de portafolio o solo GitHub es suficiente?
Para empezar, un GitHub organizado, con los repositorios principales fijados y buenos READMEs, ya ayuda mucho. Un sitio simple es un complemento, pero no es obligatorio.
¿Cómo armar el currículum sin experiencia profesional?
Coloca Proyectos antes de Experiencia y muestra práctica comprobable: proyectos publicados, cursos con lo que construiste, contribuciones en código abierto, freelas y hackathons.