Master Fullstack de Neoland

Repositorio para el Master de Fullstack de Neoland.

A continuación tenéis las instrucciones para configurar vuestro equipo.

Programas necesarios

Necesitas instalar los siguientes programas para llevar a cabo el curso:

• Google Chrome será nuestro tu para desarrollar
• VS Code es la herramienta que usarás para programar, y las extensiones que necesarias:
  • Live Preview es un servidor local para ver páginas html dentro de VS Code
  • Conventional Commits te ayudará a documentar cada cambio de código que subas al repositorio
  • commitlint se asegurará de que escribas bien los comentarios de los cambios en el repositorio
  • ESLint avisa de los errores que en el código, es una herramienta fundamental para agilizar nuestro trabajo
  • Stylelint igualmente se encargará de guiarte en la senda del buen programador, a la hora de editar estilos css
  • GitHub Pull Requests facilita la tarea a la hora de gestionar los cambios en el código dentro del repositorio
  • markdownlint te ayudará a escribir correctamente el marcado de los documentos de tipo markdown
• Git el sistema de control de versiones
  • Asegúrate de elegir la opción Git Bash durante la instalación
• NodeJS es el lenguaje de programación que usarás para el backend, y también para las herramientas de automatización
  • Una vez instalado, tendrás que añadir a las variables del sistema la ruta para el ejecutable de node:
    • En Windows:
      1. Busca el programa "Editar las variables de entorno del sistema"
      2. Pulsa el botón "Variables de entorno"
      3. Haz doble click en la línea que indica PATH
      4. Pulsa en "Nueva" y añade esta dirección (o la ruta de tu instalación): "C:\Program Files\nodejs"
      5. Modifica esta línea si te aparece C:\Users\<TU_USUARIO>\AppData\Roaming\npm a "C:\Program Files\nodejs\node_modules\npm\bin", o añádela si no está
    • En Mac:
      1. Abre VS Code
      2. Si no tienes abierta una ventana del terminal, ábrela desde el menú (View > Terminal)
      3. Ejecuta: cd ~/ y luego code .bashrc, se abrirá una ventana de edición en VS Code.
      4. Añade esta línea al archivo: PATH=/usr/bin/node:$PATH, guárdalo y ciérralo
    • En Linux:
      1. Abre el Terminal
      2. Ejecuta export PATH=$PATH:/usr/local/nodejs/bin
  • Recuerda que cada vez que modifiques las variables de entorno o rutas del sistema tienes que reiniciar todas las ventanas de terminal o VS Code que tengas abiertas para que recoja los cambios (en Windows tendrás que reiniciar el ordenador).
• NVM es una herramienta que nos permite cambiar de versiones de NodeJS fácilmente
  • Crea el directorio C:\Users\<TU_USUARIO>\AppData\Roaming\npm
  • Abre el Terminal y ejecuta curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
  • Reinicia el Terminal
  • Ahora puedes ejecutar nvm install 22, y cambiar fácilmente de versión de NodeJS a partir de ahora
• WSL es el subsistema de Linux, que necesitaremos en Windows para alguna tarea en particular
  • Descarga la última versión estable de WSL y ejecuta el instalador
  • Abre Windows PowerShell como administrador y ejecuta los comandos:
    • wsl --set-default-version 2
    • wsl --install -d Ubuntu
  • Te preguntará por un nombre y contraseña para Ubuntu (el usuario en minúsculas), ¡apúntalos en un lugar seguro para no perderlos!
  • Notarás que el terminal "ha cambiado", ahora estás en la versión del terminal de Ubuntu, ejecuta este comando (te pedirá el usuario y la contraseña):
    • sudo apt update
    • sudo apt upgrade
    • Con ésto ya tenemos Ubuntu actualizado, ejecuta exit para salir de la consola de Ubuntu y luego puedes cerrar la ventana del Power Shell
    • A partir de ahora tendrás disponible el Terminal de Ubuntu directamente dentro de Windows
• MongoDB es la base de datos documental que aprenderás durante el curso
  • Durante la instalación te preguntará si instalar Compass, es el editor visual para la base de datos, es importante instalarlo también
  • MonghoDB Shell es el intérprete de comandos para interactuar con la base de datos de MongoDB, también será necesario instalarlo

Configuraciones particulares

Git necesita identificar tu usuario a la hora de recibir el código, así que tienes que ejecutar estos dos comandos en el terminal para poder subir el código local al repositorio, usa el email que tengas configurado en github.com:

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

En nuestro caso vamos a trabajar con archivos que el sistema oculta habitualmente, así que tenemos que habilitar su visualización:

• En Windows: abre el explorador de archivo, en el menú selecciona Opciones, luego en la pestaña Ver desmarca la opción "Ocultar las extensiones de archivo para archivos conocidos".
• En Mac: ejecuta en el Terminal el comando: defaults write com.apple.finder AppleShowAllFiles true; killall Finder
  • Si en algún momento el Mac te muestra este error: Fix 'xcrun: error: invalid active developer path, missing xcrun', tendrás que ejecutar en el Terminal el comando xcode-select --install y seguir los pasos que te indique

Dando una nota de color al código

Vamos a darle un poco de color a VS Code y al Terminal para hacerlos más ergonómicos y agradables a la vista.

Nota: esta parte es opcional, puedes dejarla para otro momento si lo consideras conveniente.

• Instalamos las siguientes extensiones de VS Code:
  • Material Icon Theme para unificar los iconos de los archivos
  • Cascade theme un theme de color personalizado, adecuado para el trabajo contínuo con el código
  • GitHub Markdown Preview para trabajar más cómodamente con los documentos de tipo markdown con el formato de GitHub
• Tipografías adecuadas para el código: mi recomendación es usar MesloLGS NF
• Instalamos Oh My Zsh: sh -c "$(curl -fsSL https://raw.github.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
  • Puedes ajustar el theme como quieras, a mí me gusta usar el de Powerlevel10k: git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k, añadiendo ZSH_THEME="powerlevel10k/powerlevel10k" a tu archivo ~/.zshrc.
  • No olvides ejecutar p10k configure después de estos cambios
  • Ejecuta estos comandos a continuación: autoload -U zsh-newuser-install y zsh-newuser-install -f
  • Finalmente editamos el archivo ~/.bashrc añadiendo estas líneas:

if [ -t 1 ]; then
  exec zsh
fi

Con ésto ya puedes cerrar las ventanas de Terminal y VS Code y volver a abrirlas, verás todos los cambios aplicados