Cómo pasar de cero a Create-React-App en Windows

Una guía obstinada sobre la configuración de un entorno de desarrollo web en Windows 10

He sido un desarrollador web profesional desde marzo de 2018 y usé tanto MacOs como Windows en ese momento. Mi sistema operativo preferido es Windows, por la única razón que prefiero la distribución del teclado.

Con Windows / Linux, me gusta tener mi tecla Ctrl como la tecla para usar para las operaciones de copiar y pegar y puedo usar mi meñique izquierdo en lugar de mi pulgar. De todos modos, dejemos atrás el razonamiento débil ya que ese no es el propósito de esta publicación.

Si no tiene una máquina con Windows, entonces esta publicación probablemente no sea para usted, si es diferente de lo que usa, no lo hace malo.

Veamos qué tiene que decir Ken al respecto:

Así que llevo unos 4 meses usando Windows en el trabajo a tiempo completo, y tbh no está nada mal.

- PATAGUCCI MANE (@ken_wheeler) 20 de diciembre de 2018

Esta es la actualización de mi guía de principios de año sobre la configuración de un entorno de desarrollo web en una máquina con Windows.

Esta guía cubrirá la instalación de Ubuntu, pero puede usar algunos de los otros sabores de Linux disponibles en la tienda de Windows, la configuración de Debian será muy similar a la de Ubuntu.

Objetivo de esta publicación

Para pasar de una nueva instancia de Windows 10 a algo con lo que pueda desarrollar aplicaciones web.

Estas instrucciones son para Windows 10 Fall Creators Update y versiones posteriores.

Qué vamos a cubrir:

  • Instalar WSL
  • Habilite WSL en su máquina
  • actualizar, actualizar y quitar automáticamente
  • Instalar nodo (con n)
  • Instalar código de Visual Studio
  • Instalar Windows Git
  • Instalar una terminal (Hyper)
  • ¡Instale Fish Shell!
  • Instalar Oh My Fish
  • Temas de peces con OMF
  • Configurar
  • Configuración de Git
  • Crear aplicación React
  • Usa SSH con GitHub
  • Configuración WSL SSH
  • Configuración SSH de Windows Git Bash
  • Cambiar la versión de WSL
  • ¡Envolver!

Instalar WSL

Puede instalar Ubuntu desde la tienda de Microsoft, que será la primera mitad de la instalación, la segunda será cuando abra la aplicación.

Habilite WSL en su máquina

La guía oficial lo cubre muy bien, pero voy a agregar las teclas de acceso directo aquí si no desea hacer clic con el mouse.

Sin embargo, antes de eso, si no ha seleccionado PowerShell como su símbolo del sistema predeterminado, puede seleccionarlo desde la página de configuración de la barra de tareas ubicada en la sección Personalización en la Configuración, sugiero que lo haga ahora:

Mientras estamos en ello, también deberíamos habilitar carpetas ocultas y agregar extensiones de archivos para tipos de archivos conocidos en el Explorador de archivos de Windows.

Abra el Explorador de archivos de Windows con la tecla Windows + e luego seleccione Ver en la cinta. Luego haga clic en el botón Opciones en el extremo derecho, esto abrirá el cuadro de diálogo Opciones de carpeta, desde aquí queremos seleccionar la pestaña Ver y seleccionar el botón de opción para archivos y carpetas ocultos con 'Mostrar archivos, carpetas y unidades ocultos', desmarque la opción de 'Ocultar extensiones para tipos de archivos conocidos' también. Haga clic en Aplicar y Aceptar.

La razón por la que estamos haciendo esto es para que podamos ver la .gitcarpeta en las estructuras del proyecto, también es necesaria para archivos como .envarchivos que se utilizan para la configuración del entorno.

Use la tecla de Windows + x, esto es lo mismo que hacer clic con el botón derecho en el ícono de Windows en el escritorio, esto abrirá el menú de enlace rápido. Desde aquí, debe seleccionar la opción Windows PowerShell (Admin), puede hacerlo presionando a en el teclado. Entonces, la tecla de Windows + x luego a, abrirá el indicador de control de cuenta de usuario (Admin), suponiendo que tenga derechos de administrador en su máquina, deberá hacer clic en Sí para continuar.

Copie el código aquí y péguelo en la ventana de PowerShell, Ctrl + v funcionará en PowerShell, presione enter para ejecutar el comando.

Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux

Se le pedirá que reinicie su máquina después de esto, lo que debe hacer.

Consulte el enlace para obtener una lista completa de los atajos de teclado de Windows.

Después de reiniciar, puede abrir el programa Ubuntu desde el menú de inicio y debería ocurrir la segunda instalación (de WSL en su sistema). Espere a que se complete, luego se le pedirá que cree un usuario y una contraseña para la cuenta. Deberá recordar la contraseña creada para el usuario, ya que se le pedirá que use sudoprivilegios.

actualizar, actualizar y quitar automáticamente

En el momento de escribir esto, la versión que he vinculado de Ubuntu es 18.04.1

La aplicación vinculada instalará la última versión estable de Ubuntu en Windows.

Puede comprobar qué versión de Ubuntu ha instalado con:

lsb_release -a

Si desea utilizar una versión LTS específica de Ubuntu, puede obtenerla en la Tienda Windows, aquí:

  • Ubuntu 16.04 LTS
  • Ubuntu 18.04 LTS

Ahora vamos a continuar con una actualización y actualizar todas las cosas, los tres comandos aquí actualizarán y actualizarán todo el software preinstalado que viene con la instalación de Ubuntu.

El siguiente código es tres comandos unidos con &&. La -ybandera es aceptar automáticamente los cambios que se realizarán con las actualizaciones. La eliminación automática eliminará los paquetes no utilizados que se hayan quedado en las actualizaciones.

Copie los siguientes comandos en su terminal de Ubuntu y ejecute el comando:

sudo apt update && sudo apt -y upgrade && sudo apt autoremove
Para pasar del 16.04 al 18.04 prueba do-release-upgradeen la terminal. Tenga en cuenta que esto lleva mucho más tiempo que simplemente eliminar la instalación actual de Ubuntu y comenzar de nuevo.

Ahora que la base ha sido instalada y actualizada, necesitamos instalar el paquete build-essential para compilar y construir otros paquetes, los siguientes paquetes que vamos a instalar lo necesitarán.

sudo apt install -y build-essential

De aquí en adelante, sugiero usar dos ventanas bash, una con sudo habilitado y la otra con permisos estándar.

es decir, abra un terminal y no ingrese sudoallí, en su lugar use el terminal al que se le ha otorgado ese permiso.

La razón de esto es que he descubierto que si instala el nodo como sudo, cada vez que desee ejecutar un npm installcomando, deberá otorgar permisos de sudo y todo puede volverse un poco tedioso. Y realmente no debería instalar paquetes npm con permisos sudo.

Instalar nodo (con n)

Let’s get our run-time on! If you use Node.js you will eventually have situations where you need to be able to switch Node versions, for this you may have heard to nvm (Node Version Manager) which by the way you can still use in WSL.

The reason for me opting for n over nvm is that in the past I experienced slow bash startup times whilst using nvm. Take a look at this WSL GitHub issue detailing it and the specific comment for the pros of using n.

Ok let’s install n, with n-install, the command doesn’t start with sudo so use it in the bash window you have with no sudo privileges.?

curl -L //git.io/n-install | bash

This will install the latest version of Node for us, follow the prompt on the terminal screen to reload bash:

# mine looks like this. /home/scott/.bashrc

Now check the versions of Node and npm we have installed with node -v && npm -v in the terminal.

Install Visual Studio Code

Install VSCode? What? This post is to set up WSL? Ok, so we’re going to presume that this is going from nothing to being able to web dev, so we’re going to need a text editor, and there’s nothing out there at the moment that comes close to VSCode, if you already have a text editor installed then skip to the next part.

Install the Windows version of VSCode from the Download section once installed we can enable WSL in the settings, the quickest way to do this is to open the integrated terminal in VSCode with the shortcut keys Ctrl+’ ? that’s and apostrophe. You will be prompted to select your default terminal, select WSL Bash.

Install Windows Git

There’s a bit of stumbling block getting Git support for VSCode, it’s well documented in the various issues mentioned in the linked issue.

There are workarounds as well with things like WSLGit which has its own set of issues, this all stems from users (me included) not wanting to have to install another binary for Git.

I have tried several variants when it comes to using Git with VSCode and the path of least resistance was biting the bullet and installing that additional binary, there’s an overhead with having to maintain and configure SSH keys for both Windows and WSL Git but it’s a one time setup.

Until the VSCode team incorporate WSLGit into VSCode I think this is the best option.

Install from git-scm.com the link will start downloading the install binary you can then open it and go through the install, you can keep clicking next through the install, I have selected a few options that I would like enabled.

For now, that is all we need to do, when it comes to authenticating with with GitHub using SSH we will use the Git Bash command line to configure the Windows side of things.

Install a Terminal (Hyper)

Now we have bash on Windows it’s time to install a nice Terminal app, because, let’s face it, the standard one is a bit basic.

Enter Hyper an electron based terminal app that is super themeable and configurable.

Download and install hyper for Windows, this will be the bare-bones version, it’ll look something like this:

You may notice that, this is the Windows Command prompt too — don’t worry, we’re going to configure that right now.

Open up the .hyper.js file located in the root of your user folder, or from Hyper itself use the shortcut key Ctrl+, to pop open the settings.

If the settings file (.hyper.js) opens in Notepad then you can set the default to be VSCode. In File Explorer (Use Windows key+e to open it) navigate to the file, it'll be in your User folder, right-click the file and select Properties, then Change for 'Opens with:' and select VSCode from the list.

Now we can set WSL as the shell path in Hyper, open the .hyper.jssettings file and search (Ctrl+f) for bash, we want to add the path to the WSL shell into the shell property defined in the file.

// amend shell path// WSL Bashshell: 'C:\\Windows\\System32\\bash.exe',

We can also change the appearance of Hyper from here by specifying font size and font family and also predefined themes, let’s quickly add in the hyper-adventure-time theme into the plugins section.

Open another Hyper tab with Ctrl+Shift+t, this will show the bash terminal for WSL now.

Quick orientation with the Hyper terminal keyboard shortcuts:

  • New tab = Ctrl+Shift+t
  • Close current tab = Ctrl+Shift+w
  • Cycle through tabs right = Ctrl+Shift+right arrow
  • Cycle through tabs left = Ctrl+Shift+left arrow

Now I’m going to configure some additional properties for Hyper, and change the theme to something a bit more subtle.

I purchased Dank Mono, if you want a similar font as OSS check out FiraCode.

Here’s what I changed:

module.exports = { config: { fontSize: 18, fontFamily: '"Dank Mono",...', cursorShape: 'BEAM', cursorBlink: true, copyOnSelect: true, plugins: ['hyper-altair'] }}

Install Fish Shell!

Ok, time to install the Fish Shell! This is a completely optional step, I like to use fish for the nice intellisense you get when navigating file structures, there are also some neat themes you can get with Oh My Fish

sudo apt -y install fish

Install Oh My Fish

Now we can install Oh My Fish (OMF) and get a nice terminal theme going on too, remember we talked about running commands with the correct permissions? Well this is one of those occasions, open a new tab first then paste in the following:

curl -L //get.oh-my.fish | fish

Fish themes with OMF

After installing OMF you can pick a theme, here you may notice that the text doesn’t fit in the screen on Hyper, a quick way to reset it is to maximise the window then back again, I did this with the Windows key+arrow up to maximise the Windows key+arrow down to restore it.

After installing omf I chose the theme agnoster, installed with omf install agnoster you can list out what is available and what you have already installed by selecting omf theme let's change it once more to the one theme, adjust the size of the window first as things are getting a bit cramped.

Have a play around there’s loads there, I prefer the one theme because you can see what version of node you’re running on, over on the far right. Here you can also see the intellisense for fish where it shows agnoster as a previous selection, if I wanted to select agnoster I could tab to complete the rest of the command.

Configure

So, now we have a swanky looking new terminal and a bare-bones VSCode install it’s time to get things moving.

I have a cheat-sheets repo detailing a lot of the configuration we’re about to go through here, if you find something useful along the way please drop a PR with the suggestion.

First up, in place of typing out fish each time I open a new terminal, and not replacing bash which you can do, but I prefer to use an alias. So what we're going to do is open up the .bashrc file and edit it.

From a new terminal type in nano ~/.bashrc, nano is a bash text editor. Scroll (or Page) down to the bottom of the file and add in an alias for fish, alias f=fish then to exit nano Ctrl+x and confirm changes with a y. Reload the .bashrc file like we did after using n to install Node . /home/scott/.bashrc but your username in place of mine ?, now we can use f instead of fish! Well done you saved yourself typing three extra characters!!!

Git config

Before we crack on with spinning up a Create React App instance we’re going to need to configure Git, via the .gitconfig file.

We’re going to use nano to add some settings for Git, both in WSL and Windows, this is the extra config I mentioned earlier, apologies!

First up we’ll config our bash environment and then move onto Git bash on Windows.

# open up the .gitconfig file in WSL bash# nano will create one if it doesn't existnano ~/.gitconfig

It’s nearly identical config for both environments apart from Windows uses the credential manager helper and WSL will need the cache helper.

# needed in Git Bash for Windows[credential] helper = manager# needed in WSL[credential] helper = cache[color] ui = true
[user] name = yourGitHubUserName email = [email protected]
[core] editor = code --wait

Make your changes then Ctrl+x to exit and confirm with y, that’s the first part of the Git config done.

In Git Bash for Windows do the same in the terminal, use nano to create a .gitconfig file and add the setting to it.

Create React App

Ok, we shall get create react app going so we can get Git configured with GitHub using SSH and start making changes to commit to a GitHub repo.

We’re going to use npx to make a starter React project with Create React App. If you want to have your projects somewhere else now is the time to navigate to that directory.

From the terminal enter:

# this will create a starter react project# called create-react-appnpx create-react-app create-react-app

This is creating the project in my home (~) folder, I've had to speed the gif up to 20x faster, it does take a while.?

Wheeeeeeeeeeeeeeeeeeeee!

So, now that we have spun up a React app to work on we should make a change and then add it to GitHub.

Navigate to the create-react-app folder in the terminal and open the project. You can open VSCode with the code . command, the . denotes the current folder in the terminal.

This will open VSCode at the root of the create-react-app project, make sure everything is working as expected by running the start script in npm.

npm run start

If you want to see what scripts are available in the current project you can also use npm run which will list defined npm commands from the package.json file.

Se abrirá una ventana que muestra la página de inicio básica de Create React App, vamos a agregar un h1 al App.jsmódulo y luego lo confirmaremos, a través del menú de control de fuente en VSCode.

Tenga en cuenta que esta es una guía en funcionamiento para un entorno de desarrollo, no voy a detallar el desarrollo en React

Mientras el terminal está ocupado iniciando la página create-react-page, podemos abrir otra pestaña en Hyper con Ctrl + Shift + t y abrir VSCode con el code .comando, navegar hasta el App.jscomponente y agregarle una <etiqueta h1> justo antes.e the t; etiqueta con

; ¡Hola React!

en eso.

Now the landing page should show the newly added h1, we can confirm that the file is changed in Git by doing a git status from the terminal. Then we can commit it from either the terminal or the IDE (VSCode) my preference is to use VSCode as the visual diffing of files is great.

Commit the changes with Ctrl+Enter if you have not selected the file you want to commit you will get a dialogue telling you there are no staged changes to commit, you can select the files (in this case only the App.jsfile) by clicking the plus next to the file. Hitting Ctrl+Enter again will commit the changes with a message, you can check that there are no changes to commit with git status from the terminal or visually from the Source Control section in VSCode.

Ok, time to add our super sweet code changes to a repository on GitHub for the world to see!

Next up we’re going to go through adding the local changes we’ve made to a GitHub repository. If you haven’t got a GitHub account and are following along now may be a good time to set one up.

Use SSH with GitHub

First up, we’re going to make a repository on GitHub and push the changes we have made to it, here we’re going to click the + button in the top right of the GitHub home page, enter a repository name and GitHub will give you some defaults to choose from. As we have already made change locally we can ignore the first several commands but we do need the command to add the remote:

git remote add origin [email protected]:spences10/cra.git

And to push the changes up to GitHub git push -u origin master but we're going to get an error, as we haven't set up SSH.

WSL SSH Config

Abra una nueva pestaña de bash en Hyper e ingrese y ls -al ~/.sshverifique que no haya rsaarchivos antes de hacer esto.

Notarás que estamos haciendo esto en bash en lugar de Fish.

Si no hay nada allí, genere nuevas claves con:

# add your email address ?ssh-keygen -t rsa -b 4096 -C [email protected] 

Ahora ls -al ~/.sshmostrará dos archivos adicionales:

# there should be a private and public key-pairid_rsaid_rsa.pub

Inicie el agente SSH:

eval "$(ssh-agent -s)"

Agregue la clave RSA a SSH con:

ssh-add ~/.ssh/id_rsa

Ahora es el momento de agregar la clave SSH pública a GitHub, en WSL vamos a copiar la clave SSH pública cat ~/.ssh/id_rsa.puben Hyper. Luego podemos copiar de Hyper a una nueva clave SSH.

Finalmente, autentíquese con GitHub:

ssh -T [email protected]

Configuración SSH de Windows Git Bash

Para Windows Git Bash, vamos a copiar nuestras claves SSH que acabamos de generar en WSL en Windows Git Bash, existen algunas diferencias sutiles al autenticarse con Windows Git Bash.

Desde Hyper, copie los archivos SSH de Linux a Windows:

cp ~/.ssh/* /c/Users/spenc/.ssh/

Inicie el agente SSH:

eval `ssh-agent -s`

Agregue la clave al agente SSH:

ssh-add ~/.ssh/id_rsa

Autenticar:

ssh -T [email protected]

Now the additional set up for SSH is done we should be able to go back to Hyper and push our change to GitHub.

Also, you may have noticed that the SSH Key ? token went from black to green on the settings screen there this indicates that you have authenticated.

Change WSL version

If you want to use a different version of Ubuntu, Debian or any of the other available distributions of Linux from the Windows store with Hyper you will need to change the default version from PowerShell:

# list available versionswslconfig /l# set defaultwslconfig /setdefault Debian

Wrap up!

That’s it! We have gone from scratch to a functioning web development environment. There are several other personal things I’m now going to add to my install now which is aliases for both Git and Fish shell. If you are interested in them I have a cheat-sheet for Fish with a list of all my aliases I use, the same for my .gitconfig you can find that in my dotfiles repo

Thanks for reading ?

This was originally posted on my Gatsby blog you can view it here please take a look at my other content if you enjoyed this.

Follow me on Twitter or Ask Me Anything on GitHub.

You can read other articles like this on my blog.