Configurar un entorno de desarrollo con Sails.js es más sencillo de lo que parece. Basta con instalar Node.js, el gestor de paquetes NPM y el propio framework para tener una aplicación corriendo en minutos. A continuación se explican los pasos exactos, la estructura de archivos generada y cómo levantar el servidor local.
¿Qué herramientas necesitas antes de empezar con Sails.js?
El primer requisito es Node.js, ya que Sails depende de NPM (Node Package Manager) para su instalación [0:22]. Desde la página oficial de Node.js se descarga el instalador correspondiente a tu sistema operativo. En el ejemplo se utiliza la versión LTS (Long Term Support) 12.14.1, que garantiza estabilidad [0:40].
Una vez finalizada la instalación, se verifica abriendo una terminal y ejecutando:
bash
npm -v
Este comando muestra la versión de NPM instalada [1:05]. Si no responde correctamente, estas acciones suelen resolver el problema:
- Reiniciar la terminal.
- Reiniciar la computadora.
- Volver a instalar Node.js.
¿Cómo se instala Sails.js de forma global?
Con Node listo, se ejecuta el siguiente comando para instalar Sails de manera global [1:30]:
bash
npm install sails -g
La bandera -g indica una instalación global, lo que permite usar el comando sails desde cualquier ubicación en la terminal. El proceso puede tardar hasta dos minutos dependiendo de la conexión a Internet y la capacidad de procesamiento [1:42].
Para confirmar que Sails quedó instalado correctamente se usa:
bash
sails -v
En el ejemplo se muestra la versión 1.2.3 [1:58].
¿Cómo se genera la estructura de archivos de un proyecto Sails?
Antes de generar el proyecto, conviene crear una carpeta contenedora. El comando mkdir (make directory) crea un nuevo directorio [2:20]:
bash
mkdir platzyride
cd platzyride
El comando cd (change directory) permite moverse dentro de la carpeta recién creada. Desde ahí se genera el proyecto de Sails [2:42]:
bash
sails new backend --no-frontend
Aquí hay un detalle fundamental: la bandera --no-frontend. Sails trabaja por defecto con el patrón MVC (modelo-vista-controlador), pero en un esquema cliente-servidor donde solo se necesita el backend, la vista no se genera [2:55]. Esto produce un proyecto más limpio y enfocado en la API.
¿Qué contiene la estructura de archivos generada?
Al abrir el proyecto en un editor de código como WebStorm, Visual Studio Code o Atom, se observan las siguientes carpetas principales [3:52]:
- api/: es el directorio donde se escribe la mayor parte del código. Dentro contiene subcarpetas para controllers, helpers, models y policies.
- config/: almacena las configuraciones por defecto del framework. Generalmente se mantienen tal cual y solo se modifican cuando es necesario.
- node_modules/: guarda todas las librerías y dependencias que la aplicación requiere para funcionar.
Al ser un proyecto recién creado, las subcarpetas dentro de api/ están vacías; los controladores y modelos se desarrollan conforme avanza el proyecto [4:05].
¿Cómo se levanta el servidor de Sails en local?
Para poner en marcha la aplicación se utiliza el comando sails lift [4:30]:
bash
cd backend
sails lift
Sails inicia el servidor en el puerto 1337 de localhost. Para verificar que todo funciona, basta con abrir el navegador y visitar:
http://localhost:1337
Si aparece el mensaje "Not Found", significa que el servidor está corriendo correctamente [4:50]. No hay vistas configuradas, por lo que esa respuesta es la esperada. En cambio, si el navegador muestra un error de conexión, conviene revisar la terminal en busca de mensajes de error entre los registros de info y debug.
Para detener el servidor se presiona Ctrl + C en la terminal [4:38].
Con estos pasos ya tienes un proyecto de Sails.js funcional, listo para empezar a construir controladores, modelos y rutas. Si tienes dudas sobre algún paso o quieres compartir tu experiencia configurando el entorno, déjalo en los comentarios.
