Descripción general

Express.js es un framework web rápido, sin opiniones y minimalista para Node.js. Ofrece funcionalidades robustas para construir aplicaciones web y APIs REST con un enfoque en la simplicidad y la flexibilidad.

Antes de empezar
Asegúrate de tener tu panel abierto - necesitarás las credenciales de Git que se muestran allí. Esta plantilla incluye Prisma ORM, Sequelize, MySQL2, autenticación JWT, Socket.io y plantillas EJS.

Inicio rápido

1

Crear repositorio desde plantilla

En tu panel, ve a la pestaña Tools & Deployment. Haz clic en el botón "New Repository", selecciona la plantilla de Express del menú desplegable, introduce un nombre de repositorio y un subdominio, y luego haz clic en "Create Repository".

2

Clona tu repositorio

git clone https://<git-server>/<username>/<repo-name>.git
cd <repo-name>
3

Instala las dependencias

npm install
4

Inicia el servidor de desarrollo

npm run dev

El servidor se ejecuta en http://localhost:3000 por defecto.

5

Sube tus cambios

git add .
git commit -m "Initial setup"
git push origin main
Cada push a Git despliega tu aplicación automáticamente. Consulta tu URL de trabajo del módulo en el panel para ver tu sitio en vivo.

Desarrollo local con Docker

Si no tienes Node.js instalado localmente, puedes usar Docker para ejecutar comandos de Express.

¿Qué es Docker?
Docker crea "contenedores" aislados con todo el software que necesitas (Node.js, npm) sin instalarlo en tu ordenador.

Ejecutar comandos con Docker

# Run npm install
docker run --rm -v $(pwd):/app -w /app node:lts npm install

# Run development server
docker run --rm -v $(pwd):/app -w /app -p 3000:3000 node:lts npm run dev

Estructura del proyecto

├── src/
│   ├── controllers/          # Manejadores de peticiones
│   ├── middleware/           # Middleware personalizado
│   ├── models/               # Modelos de la base de datos
│   ├── routes/               # Definiciones de rutas
│   └── server.js             # Configuración de la app Express
├── views/                    # Plantillas EJS
├── public/                   # Archivos estáticos
├── prisma/                   # Esquema de Prisma
├── package.json              # Dependencias
└── Dockerfile                # Configuración Docker
        

Tareas comunes

Crear una ruta

const express = require('express');
const router = express.Router();

router.get('/users', (req, res) => {
  res.json({ message: 'Get all users' });
});

module.exports = router;

Usar Prisma ORM

const { PrismaClient } = require('@prisma/client');
const prisma = new PrismaClient();

const users = await prisma.user.findMany();
const user = await prisma.user.create({
  data: { name: 'John', email: 'john@example.com' }
});

Comandos útiles

npm run dev Iniciar el servidor de desarrollo con nodemon
npm start Iniciar el servidor de producción
npx prisma migrate dev Ejecutar migraciones de Prisma

Resolución de problemas

Falló la conexión a la base de datos

Solución: Comprueba DATABASE_URL en el archivo .env. Formato: mysql://user:password@host:port/database

El puerto 3000 ya está en uso

Solución: Cambia PORT en el archivo .env o detén el otro proceso.

Flujo de despliegue

Cambio de código git push npm install ¡En vivo!
Para más información, visita la documentación oficial de Express.js.