Repositorio en GitHub: qué es, para qué sirve y cómo crearlo

Un repositorio en GitHub es el espacio donde puedes almacenar, organizar y compartir los archivos de un proyecto utilizando Git. En este artículo aprenderás qué es un repositorio, para qué sirve, cómo funciona y cómo utilizarlo para gestionar tus proyectos y trabajar en equipo.

1. ¿Qué es un repositorio en GitHub?

Un repositorio de GitHub es un espacio donde se almacena y organiza un proyecto de software junto con todos los archivos necesarios para desarrollarlo. Puede contener código fuente, documentos, imágenes, archivos de configuración y otros recursos relacionados con el proyecto.

Además de almacenar los archivos, un repositorio permite utilizar Git (sistema de control de versiones distribuido) para registrar los cambios realizados a lo largo del tiempo. De esta manera, es posible consultar el historial del proyecto, recuperar versiones anteriores y conocer quién realizó cada modificación.

Un repositorio puede pertenecer a una persona, una organización o un equipo de trabajo.

1.1. ¿Qué se puede guardar en un repositorio?

Dentro de un repositorio puedes encontrar diferentes tipos de archivos, por ejemplo:

• Archivos HTML.
• Archivos CSS.
• Archivos JavaScript.
• Archivos PHP.
• Archivos Python.
• Imágenes.
• Documentación.
• Archivos de configuración.
• Archivos README.
• Archivos .gitignore.
• Otros recursos necesarios para el proyecto.

Por ejemplo, un sitio web sencillo podría tener una estructura como esta:

mi-sitio-web/
├── index.html
├── estilos.css
├── script.js
├── imagenes/
└── README.md

Todos estos archivos pueden formar parte de un mismo repositorio.

2. ¿Para qué sirve un repositorio de GitHub?

Un repositorio sirve principalmente para almacenar, controlar, organizar y compartir un proyecto.

Pero sus posibilidades van mucho más allá de guardar archivos.

2.1. Guardar un proyecto

Puedes utilizar un repositorio para almacenar todo el código y los recursos de un proyecto.

Esto permite tener una copia del proyecto disponible en GitHub y acceder a ella desde diferentes dispositivos.

2.2. Controlar las versiones

Cuando Git está conectado con GitHub, cada commit permite registrar cambios realizados en el proyecto.

Por ejemplo:

Versión 1 → Crear página HTML
Versión 2 → Agregar estilos CSS
Versión 3 → Agregar JavaScript
Versión 4 → Corregir errores

Esto permite consultar cómo evolucionó el proyecto.

2.3. Compartir un proyecto

Un repositorio puede utilizarse para compartir un proyecto con otras personas.

Dependiendo de la configuración del repositorio, otras personas pueden simplemente consultar el contenido o también colaborar directamente.

2.4. Trabajar en equipo

Los repositorios de GitHub son especialmente útiles para proyectos desarrollados por varias personas.

Cada integrante puede trabajar en diferentes ramas y posteriormente integrar sus cambios mediante Pull Requests.

2.5. Respaldar el código

Un repositorio remoto en GitHub también puede funcionar como una copia remota del proyecto.

Si tienes el proyecto almacenado localmente en tu computadora, puedes utilizar:

git push

para enviar tus cambios al repositorio remoto.

3. Repositorio público y privado

Al crear un repositorio en GitHub, una de las decisiones más importantes es elegir si será público o privado. Esta configuración determina quién puede acceder al contenido del repositorio y es especialmente importante cuando trabajas con proyectos personales, profesionales o colaborativos.

3.1. ¿Qué es un repositorio público?

Un repositorio público es aquel cuyo contenido puede ser consultado por cualquier persona en Internet. Los usuarios pueden acceder al código, consultar los archivos, revisar el historial y, dependiendo de la configuración, interactuar con el proyecto.

Los repositorios públicos son muy utilizados para:

• Proyectos de código abierto.
• Proyectos personales.
• Ejemplos de programación.
• Tutoriales y proyectos educativos.
• Portafolios de desarrolladores.
• Bibliotecas y herramientas que quieres compartir.

Por ejemplo, si estás creando un proyecto para demostrar tus conocimientos de JavaScript, puedes crear un repositorio público como:

curso-javascript

De esta manera, otras personas podrán consultar el código y conocer cómo desarrollaste el proyecto.

3.2. ¿Qué es un repositorio privado?

Un repositorio privado restringe el acceso a las personas autorizadas. El contenido no queda disponible públicamente y puedes controlar quién puede trabajar o consultar el repositorio.

Los repositorios privados pueden ser útiles para:

• Proyectos que todavía están en desarrollo.
• Trabajos profesionales.
• Proyectos empresariales.
• Código que no quieres publicar.
• Proyectos que contienen información que debe mantenerse restringida.

Por ejemplo:

sistema-gestion-empresa

podría mantenerse como repositorio privado mientras el equipo trabaja en su desarrollo.

3.3. Diferencias entre un repositorio público y privado

La diferencia principal está en el nivel de acceso al contenido:

Característica	Público	Privado
Código visible públicamente	Sí	No
Puede utilizarse para código abierto	Sí	No directamente
Acceso restringido	No	Sí
Adecuado para portafolios	Sí	Generalmente no
Adecuado para proyectos privados	No es lo habitual	Sí
Permite trabajar en equipo	Sí	Sí

3.4. ¿Cuál debería utilizar?

La elección depende del objetivo del proyecto.

Si quieres compartir tu código, crear un proyecto de código abierto, mostrar tus conocimientos o utilizar GitHub como portafolio, un repositorio público suele ser la opción más adecuada.

Si estás trabajando en un proyecto que no quieres hacer público, por ejemplo un desarrollo para un cliente o una aplicación empresarial en proceso de creación, puedes utilizar un repositorio privado.

Importante: independientemente de que un repositorio sea público o privado, evita subir contraseñas, claves API, tokens, credenciales u otra información sensible. El archivo .gitignore puede ayudarte a evitar que determinados archivos sean incluidos accidentalmente en Git.

4. Repositorio local y repositorio remoto

Cuando trabajas con Git y GitHub encontrarás constantemente los conceptos repositorio local y repositorio remoto. Aunque están relacionados, no son exactamente lo mismo.

La diferencia principal es dónde se encuentra cada repositorio:

• Repositorio local: está almacenado en tu computadora.
• Repositorio remoto: está almacenado en un servidor, por ejemplo, en GitHub.

Ambos pueden contener el mismo proyecto y mantenerse sincronizados mediante Git.

4.1. ¿Qué es un repositorio local?

Un repositorio local es el repositorio Git que se encuentra en tu computadora. Es el lugar donde trabajas directamente sobre los archivos del proyecto.

Por ejemplo, puedes tener un proyecto llamado:

mi-proyecto/
├── index.html
├── style.css
├── script.js
└── README.md

Si dentro de esa carpeta ejecutas:

git init

Git crea un repositorio local y comienza a realizar el seguimiento de los cambios que hagas en el proyecto.

Desde este repositorio puedes utilizar comandos como:

git status
git add .
git commit
git log
git branch

Todos estos comandos permiten trabajar con el historial y los cambios del proyecto directamente desde tu computadora.

4.2. ¿Qué es un repositorio remoto?

Un repositorio remoto es una copia del repositorio almacenada en un servidor externo. En este curso utilizaremos principalmente GitHub como servicio para alojar estos repositorios.

Por ejemplo, puedes tener:

Repositorio remoto
        ↓
     GitHub
        ↓
   mi-proyecto

El repositorio remoto permite almacenar y compartir el proyecto fuera de tu computadora.

También facilita el trabajo colaborativo, ya que diferentes desarrolladores pueden conectarse al mismo repositorio y enviar o descargar cambios.

4.3. ¿Cómo se relacionan el repositorio local y el remoto?

Lo habitual es trabajar primero en el repositorio local y posteriormente sincronizarlo con el repositorio remoto.

Por ejemplo:

 COMPUTADORA
     Repositorio local
            │
            │ git push
            ▼
         GITHUB
    Repositorio remoto

Cuando realizas cambios en tu computadora y quieres enviarlos a GitHub, utilizas git push.

Por ejemplo:

git add .
git commit -m "Agregar nueva funcionalidad"
git pushLenguaje del código: JavaScript (javascript)

El comando git push envía los commits del repositorio local al repositorio remoto.

4.4. ¿Cómo descargar cambios desde GitHub?

El proceso también puede realizarse en sentido contrario.

Si existen nuevos cambios en el repositorio remoto, puedes descargarlos a tu repositorio local utilizando:

git pull

El flujo sería:

       GITHUB
  Repositorio remoto
            │
            │ git pull
            ▼
     Repositorio local
        COMPUTADORA

De esta manera, tu proyecto local puede incorporar los cambios que fueron realizados en GitHub.

4.5. Ejemplo práctico

Imagina que estás desarrollando un sitio web.

En tu computadora tienes:

mi-sitio/
├── index.html
├── style.css
└── script.js

Esta carpeta está vinculada con un repositorio de GitHub.

Realizas una modificación en index.html y después ejecutas:

git add index.html
git commit -m "Actualizar página principal"
git pushLenguaje del código: JavaScript (javascript)

El cambio queda registrado en tu repositorio local mediante el commit y posteriormente se envía al repositorio remoto de GitHub.

Si otra persona realiza cambios en GitHub, puedes obtenerlos en tu computadora mediante:

git pull

Por eso, en un proyecto colaborativo es habitual utilizar este flujo:

Trabajar localmente
       ↓
   git add
       ↓
  git commit
       ↓
   git push
       ↓
     GitHub
       ↓
  git pull
       ↓
Actualizar local

4.6. ¿El repositorio local y el remoto tienen que ser idénticos?

No necesariamente.

Pueden existir cambios en el repositorio local que todavía no hayan sido enviados a GitHub. También puede haber cambios en GitHub que todavía no hayas descargado a tu computadora.

Por eso es importante entender que Git permite sincronizar ambos repositorios, pero no significa que estén permanentemente sincronizados.

4.7. ¿Cómo se relacionan Git y GitHub?

Git y GitHub no son lo mismo.

Git es el sistema de control de versiones que permite registrar y administrar los cambios de un proyecto.

GitHub es una plataforma que permite alojar repositorios Git y proporciona herramientas adicionales para colaborar, gestionar proyectos y compartir código.

Un flujo habitual sería:

Computadora
    ↓
Repositorio local
    ↓
git commit
    ↓
git push
    ↓
GitHub
    ↓
Repositorio remoto

5. ¿Cómo crear un repositorio en GitHub?

Crear un repositorio en GitHub es un proceso sencillo.

Antes de comenzar necesitas tener una cuenta de GitHub.

Si todavía no tienes una, puedes consultar el artículo específico sobre cómo crear una cuenta en GitHub.

Paso 1: Iniciar sesión en GitHub

Ingresa a GitHub e inicia sesión con tu cuenta.

Una vez dentro, podrás acceder a tu perfil y administrar tus repositorios.

Paso 2: Crear un nuevo repositorio

Desde GitHub selecciona la opción para crear un nuevo repositorio.

También puedes acceder a esta opción desde el menú de creación de GitHub.

Paso 3: Escribir el nombre del repositorio

Debes elegir un nombre para identificar el proyecto.

Por ejemplo:

mi-primer-proyecto

Es recomendable utilizar nombres:

• Claros.
• Descriptivos.
• Fáciles de recordar.
• Relacionados con el proyecto.

Paso 4: Agregar una descripción

Puedes agregar una breve descripción para explicar qué contiene el repositorio.

Por ejemplo:

Sitio web creado como proyecto de aprendizaje de HTML y CSS.

La descripción no es obligatoria, pero puede ayudar a otras personas a comprender rápidamente el propósito del proyecto.

Paso 5: Elegir la visibilidad

GitHub permite elegir entre diferentes niveles de visibilidad según las opciones disponibles para el repositorio.

En términos generales, un repositorio puede ser:

• Público: otras personas pueden acceder a él.
• Privado: el acceso está restringido.

La elección depende del tipo de proyecto y de quién necesita acceder a él.

Paso 6: Agregar un README

Durante la creación del repositorio puedes elegir agregar un archivo README.md.

Este archivo suele utilizarse para explicar:

• Qué es el proyecto.
• Para qué sirve.
• Cómo instalarlo.
• Cómo utilizarlo.
• Cómo contribuir.
• Información adicional.

Por ejemplo:

mi-primer-proyecto/
└── README.md

El README será especialmente importante cuando comiences a trabajar con documentación en GitHub.

Paso 7: Crear el repositorio

Una vez configuradas las opciones, puedes crear el repositorio.

GitHub generará el espacio donde posteriormente podrás almacenar los archivos de tu proyecto.

6. ¿Qué contiene un repositorio de GitHub?

Un repositorio puede contener mucho más que archivos de código.

6.1. Archivos del proyecto

Aquí se encuentra el código y los recursos utilizados por la aplicación o sitio web.

Por ejemplo:

index.html
style.css
script.js
Lenguaje del código: CSS (css)

6.2. README.md

El archivo README.md contiene información sobre el proyecto.

Es uno de los archivos más importantes para documentar un repositorio.

6.3. .gitignore

El archivo .gitignore permite indicar qué archivos o carpetas no deben ser incluidos en el control de versiones.

Por ejemplo:

node_modules/
.env

6.4. Commits

Los commits representan registros de cambios realizados en el proyecto.

Cada commit puede incluir:

• Los archivos modificados.
• El autor.
• La fecha.
• Un mensaje descriptivo.
• Un identificador único.

6.5. Ramas

Un repositorio puede contener diferentes ramas.

Por ejemplo:

main
desarrollo
login
nueva-funcionalidad

Las ramas permiten trabajar en diferentes funcionalidades sin modificar directamente la rama principal.

6.6. Issues

Los Issues permiten registrar tareas, errores, preguntas o propuestas relacionadas con el proyecto.

6.7. Pull Requests

Los Pull Requests permiten proponer cambios para que puedan ser revisados antes de incorporarlos a otra rama.

7. ¿Cómo subir un proyecto local a un repositorio de GitHub?

Una vez creado el repositorio en GitHub, puedes conectarlo con un proyecto que tengas en tu computadora.

Supongamos que ya tienes un proyecto Git local.

Primero puedes comprobar su estado:

git status

Después puedes agregar los archivos:

git add .

Crear un commit:

git commit -m "Primer commit"
Lenguaje del código: JavaScript (javascript)

Después puedes conectar el repositorio local con el repositorio remoto de GitHub:

git remote add origin URL_DEL_REPOSITORIO

Finalmente puedes enviar los cambios:

git push -u origin main

De esta manera, los archivos que estaban en tu computadora pasan a estar disponibles en el repositorio de GitHub.

8. ¿Cómo descargar un repositorio de GitHub?

También puedes hacer el proceso inverso.

Si existe un repositorio en GitHub y quieres obtener una copia en tu computadora, puedes utilizar:

git clone URL_DEL_REPOSITORIO
Lenguaje del código: PHP (php)

Por ejemplo:

git clone https://github.com/usuario/mi-proyecto.git
Lenguaje del código: PHP (php)

Git descargará el repositorio y creará una copia local.

Este procedimiento será especialmente importante cuando aprendas el comando Git clone.

9. ¿Cómo actualizar un repositorio?

Cuando otras personas realizan cambios en el repositorio remoto, puedes obtener esos cambios en tu computadora utilizando:

git pull

El flujo puede representarse así:

GitHub
   ↓
git pull
   ↓
Repositorio local

Por otro lado, cuando realizas cambios localmente y quieres enviarlos a GitHub:

Repositorio local
   ↓
git add
   ↓
git commit
   ↓
git push
   ↓
GitHub

10. Beneficios de utilizar repositorios en GitHub

Los repositorios de GitHub ofrecen numerosas ventajas.

1. Control de versiones
   • Puedes consultar la evolución de un proyecto y recuperar versiones anteriores.
2. Trabajo colaborativo
   • Varias personas pueden participar en el desarrollo del mismo proyecto.
3. Acceso desde diferentes dispositivos
   • El repositorio remoto permite acceder al proyecto desde otros equipos siempre que tengas los permisos correspondientes.
4. Organización
   • GitHub permite organizar código, documentación, tareas y diferentes aspectos relacionados con un proyecto.
5. Historial de cambios
   • Puedes consultar quién realizó determinados cambios y cuándo se realizaron.
6. Portafolio profesional
   • Los repositorios públicos pueden formar parte del perfil de un desarrollador y servir como muestra de sus conocimientos y proyectos.
7. Proyectos de código abierto
   • GitHub facilita que desarrolladores de diferentes lugares puedan consultar, utilizar y contribuir a proyectos públicos.

11. Ejemplos de usos reales de un repositorio de GitHub

Los repositorios pueden utilizarse en proyectos muy diferentes.

Ejemplo 1: Crear un sitio web

Un desarrollador puede crear un repositorio para almacenar:

index.html
style.css
script.js
imagenes/
README.md

Posteriormente puede utilizar GitHub Pages para publicar el sitio web.

Ejemplo 2: Crear una aplicación JavaScript

Un proyecto podría tener:

src/
package.json
README.md
.gitignore

Los desarrolladores pueden trabajar en diferentes funcionalidades utilizando ramas.

Ejemplo 3: Trabajar en equipo

Imaginemos que dos desarrolladores trabajan en una aplicación.

El desarrollador A crea:

feature-login

Mientras que el desarrollador B trabaja en:

feature-dashboard

Cada uno puede realizar sus cambios y posteriormente crear Pull Requests para integrarlos en la rama principal.

Ejemplo 4: Crear un portafolio

Un desarrollador puede utilizar varios repositorios públicos para mostrar sus proyectos.

Por ejemplo:

portfolio
sitio-web
app-javascript
proyecto-api

Esto puede ayudar a mostrar experiencia práctica.

Ejemplo 5: Proyecto de código abierto

Un desarrollador puede publicar un proyecto para que otras personas puedan:

• Consultar el código.
• Informar errores.
• Proponer mejoras.
• Crear Forks.
• Enviar Pull Requests.

12. ¿Qué es la rama principal de un repositorio?

La rama principal es la rama que normalmente contiene la versión principal del proyecto.

En muchos repositorios modernos su nombre es:

main

Sin embargo, un repositorio puede tener muchas otras ramas.

Por ejemplo:

main
├── desarrollo
├── login
└── nueva-funcionalidad

Esto permite desarrollar diferentes características sin modificar directamente la versión principal.

12.1. ¿Qué relación existe entre un repositorio, una rama y un commit?

Estos tres conceptos están estrechamente relacionados.

Podemos imaginarlo de la siguiente manera:

Repositorio
│
├── main
│   ├── Commit 1
│   ├── Commit 2
│   └── Commit 3
│
└── desarrollo
    ├── Commit 4
    └── Commit 5

• El repositorio contiene el proyecto.
• Las ramas permiten trabajar sobre diferentes líneas de desarrollo.
• Los commits registran los cambios realizados.

Comprender esta relación será fundamental para aprender posteriormente ramas, merge y Pull Requests.

13. Buenas prácticas para crear un repositorio en GitHub

Al crear un repositorio es recomendable seguir algunas buenas prácticas.

13.1. Utilizar nombres descriptivos

En lugar de:

proyecto1

es preferible algo como:

tienda-online

o:

curso-javascript

13.2. Crear un README

Un README ayuda a explicar rápidamente el objetivo del proyecto.

13.3. Utilizar .gitignore

Evita subir archivos innecesarios o información que no debería formar parte del repositorio.

13.4. No subir contraseñas ni claves privadas

Nunca deberías almacenar directamente información sensible como:

contraseñas
tokens
claves API
credenciales

13.5. Realizar commits descriptivos

Es preferible:

git commit -m "Agregar formulario de contacto"
Lenguaje del código: JavaScript (javascript)

que utilizar mensajes poco descriptivos como:

git commit -m "cambios"
Lenguaje del código: JavaScript (javascript)

13.6. Mantener el repositorio organizado

Una estructura clara facilita el mantenimiento y permite que otras personas comprendan mejor el proyecto.

14. Preguntas frecuentes sobre los repositorios de GitHub

¿GitHub guarda automáticamente mis archivos?

No. GitHub no sincroniza automáticamente todos los cambios realizados en tu computadora.

Normalmente debes utilizar Git para registrar los cambios y comandos como git push para enviarlos al repositorio remoto.

¿Puedo eliminar un repositorio?

Sí. GitHub permite eliminar repositorios, aunque debes hacerlo con cuidado porque esta acción puede provocar la pérdida de información almacenada en el repositorio remoto.

¿Puedo cambiar el nombre de un repositorio?

Sí. GitHub permite cambiar el nombre de un repositorio, aunque después puede ser necesario actualizar la URL remota utilizada por determinados proyectos locales.

¿Puedo compartir un repositorio con otras personas?

Sí. Dependiendo de si el repositorio es público o privado y de los permisos configurados, puedes permitir que otras personas consulten o colaboren en el proyecto.

¿Puedo utilizar GitHub sin instalar Git?

Sí. Puedes crear y administrar determinados contenidos directamente desde la interfaz web de GitHub.

Sin embargo, para trabajar de manera completa con Git y desarrollar proyectos localmente, es muy recomendable aprender a utilizar Git desde la terminal o desde herramientas como Visual Studio Code.

15. Conclusión

Un repositorio de GitHub es mucho más que una carpeta donde almacenar código. Es el espacio central desde el que puedes organizar un proyecto, conservar su historial, trabajar con ramas, colaborar con otras personas y compartir tu código.

Comprender el funcionamiento de los repositorios es fundamental para avanzar en GitHub, ya que prácticamente todas las herramientas de la plataforma están relacionadas con ellos.

Una vez que conozcas los repositorios, podrás comenzar a trabajar con conceptos fundamentales como git push, git clone, git pull, ramas, Pull Requests, Issues y colaboración en equipo.