3.0 KiB
Leer esto en otro idioma: Inglés, Español, Chino Simplificado
Contribuyendo
¡Nos ❤️ encantaría que contribuyas a Pingvin Share y nos ayudes a hacerlo mejor! Todas las contribuciones son bienvenidas, incluyendo problemas, sugerencias, pull requests y más.
Para comenzar
Si encontraste un error, tienes una sugerencia o algo más, simplemente crea un problema (issue) en GitHub y nos pondremos en contacto contigo 😊.
Para hacer una Pull Request
Antes de enviar la pull request para su revisión, asegúrate de que:
-
El nombre de la pull request sigue las especificaciones de Commits Convencionales:
<tipo>[ámbito opcional]: <descripción>
ejemplo:
feat(share): agregar protección con contraseña
Donde
tipo
puede ser:- feat - es una nueva función
- doc - cambios solo en la documentación
- fix - una corrección de error
- refactor - cambios en el código que no solucionan un error ni agregan una función
-
Tu pull requests tiene una descripción detallada.
-
Ejecutaste
npm run format
para formatear el código.
¿No sabes como crear una pull request? Aprende cómo crear una pull request
-
Crea un fork del repositorio haciendo clic en el botón
Fork
en el repositorio de Pingvin Share. -
Clona tu fork en tu máquina con
git clone
.
$ git clone https://github.com/[your_username]/pingvin-share
-
Trabajar - hacer commit - repetir
-
Haz un
push
de tus cambios a GitHub.
$ git push origin [nombre_de_tu_nueva_rama]
- Envía tus cambios para su revisión. Si vas a tu repositorio en GitHub, verás un botón
Comparar y crear pull requests
. Haz clic en ese botón. - Inicia una Pull Request
- Ahora envía la pull requests y haz clic en
Crear pull requests
- Espera a que alguien revise tu solicitud y apruebe o rechace tus cambios. Puedes ver los comentarios en la página de la solicitud en GitHub.
Instalación del proyecto
Pingvin Share consiste de un frontend y un backend.
Backend
El backend está hecho con Nest.js y usa Typescript.
Instalación
- Abrimos la carpeta
backend
- Instalamos las dependencias con
npm install
- Haz un
push
del esquema de la base de datos a la base de datos ejecutandonpx prisma db push
- Rellena la base de datos ejecutando
npx prisma db seed
- Inicia el backend con
npm run dev
Frontend
El frontend está hecho con Next.js y usa Typescript.
Instalación
- Primero inicia el backend
- Abre la carpeta
frontend
- Instala las dependencias con
npm install
- Inicia el frontend con
npm run dev
¡Ya está todo listo!
Testing
Por el momento, solo tenemos pruebas para el backend. Para ejecutar estas pruebas, debes ejecutar el comando npm run test:system
en la carpeta del backend.