Tableros Kanban colaborativos con actualizaciones en tiempo real: arrastra y suelta tarjetas entre listas y todos los que tengan el tablero abierto lo ven al instante, sin recargar la página.
Cuenta de prueba: demo@kanbanflow.app / demo1234 (o el botón "Probar con la cuenta demo" en la página principal). La demo trae 3 tableros con tarjetas, fechas límite, comentarios, chat e historial; las otras cuentas (ana@, carlos@ y lucia@kanbanflow.app) usan la misma contraseña, para probar el tiempo real con dos navegadores.
| Documento | Contenido |
|---|---|
| Guía del código | Cómo está construido: servidor con Socket.io, autenticación, control de acceso, drag & drop en tiempo real y subida segura de archivos, con fragmentos del código explicados |
| Base de datos (PostgreSQL) | Modelo de datos, diagramas entidad-relación, decisiones de diseño y 10 consultas con su resultado real |
Es un proyecto de portafolio construido para demostrar un stack distinto al de mis otros proyectos: TypeScript de punta a punta, una base de datos relacional con un ORM (en vez de SQL crudo), colaboración en tiempo real vía WebSockets, y un flujo de autenticación con Auth.js.
- Arrastrar y soltar entre listas y dentro de una misma lista, con dnd-kit.
- Tiempo real: crear, editar, mover o eliminar tarjetas/listas se propaga al instante a todos los clientes conectados al tablero vía Socket.io.
- Presencia en vivo: ves los avatares de quién más tiene el tablero abierto ahora mismo.
- Colaboración: invita a alguien por correo (debe tener cuenta) para que edite el tablero contigo.
- Comentarios por tarjeta, fecha límite, y descripción.
- Cuentas reales: registro con contraseña cifrada (bcrypt) o la cuenta demo para probar sin registrarse.
- Modo oscuro con persistencia en
localStoragey sin parpadeo al cargar.
PostgreSQL con Prisma: 9 tablas, claves foráneas con borrado en cascada desde el tablero, índice único para que nadie esté dos veces en un tablero e índices compuestos para el chat y el historial. Detalle completo en docs/BASE-DE-DATOS.md.
![]() |
![]() |
| Modelo entidad-relación de tableros, listas y tarjetas | Progreso de cada tablero calculado en SQL |
![]() |
![]() |
| PostgreSQL rechaza una invitación duplicada | Claves foráneas con CASCADE y RESTRICT |
| Capa | Tecnología |
|---|---|
| Framework | Next.js 16 (App Router) + TypeScript |
| Estilos | Tailwind CSS v4 |
| Base de datos | PostgreSQL + Prisma ORM |
| Autenticación | Auth.js (NextAuth v5), credenciales + bcrypt |
| Tiempo real | Socket.io sobre un servidor Node personalizado |
| Drag & drop | @dnd-kit |
| Animaciones | Framer Motion |
| Tests | Vitest + Testing Library |
Socket.io necesita un proceso Node persistente para mantener las conexiones WebSocket abiertas, algo que no encaja con funciones serverless de vida corta. Por eso server.ts envuelve el manejador de peticiones de Next.js y adjunta Socket.io al mismo servidor HTTP — ambos corren en el mismo proceso, así que las rutas API pueden emitir eventos por WebSocket importando el mismo singleton (src/lib/socket.ts) que usa el servidor. Esto también significa que el despliegue debe ser a un host que corra un proceso Node persistente (Railway, Render, Fly.io), no a funciones serverless puras como Vercel.
- El cliente que arrastra una tarjeta actualiza su estado local al instante (optimista).
- Al soltar, hace
POST /api/boards/:id/reordercon el orden final de las listas afectadas (máximo 2: origen y destino). - El servidor valida que esas listas/tarjetas pertenezcan al tablero, persiste el nuevo orden en una transacción de Prisma, y emite
board:reordereda todos los sockets en la salaboard:{id}— incluido quien hizo el cambio, para que el estado converja igual en todos los clientes.
- Node 20+
- Una base de datos PostgreSQL (local o en la nube — Neon y Railway tienen niveles gratuitos)
npm install
cp .env.example .env
# edita .env con tu DATABASE_URL real y un AUTH_SECRET (genera uno con: npx auth secret)
npm run db:push # crea las tablas en tu base de datos
npm run db:seed # crea la cuenta y el tablero de demostración
npm run dev # http://localhost:3000| Script | Qué hace |
|---|---|
npm run dev |
Servidor de desarrollo (Next.js + Socket.io) con recarga automática |
npm run build |
Build de producción de Next.js |
npm start |
Sirve el build de producción a través del servidor personalizado |
npm test |
Corre la suite de Vitest |
npm run lint |
ESLint |
npm run db:studio |
Abre Prisma Studio para inspeccionar la base de datos |
src/
app/ # Rutas (App Router): landing, login, registro, tableros
api/ # Rutas de API: auth, boards, lists, cards, comments
boards/[boardId]/ # Vista de un tablero
components/
board/ # Componentes específicos del tablero (columnas, tarjetas, dnd)
context/ # SocketContext: una única conexión de Socket.io compartida
lib/ # prisma, auth, validación (zod), acceso a tableros, socket
types/ # Tipos compartidos entre API y UI
server.ts # Servidor HTTP personalizado: Next.js + Socket.io en el mismo proceso
prisma/schema.prisma # Modelo de datos
- Aprovisiona una base de datos Postgres (Neon, Railway, Supabase...).
- Despliega a un host con proceso Node persistente — Railway o Render son las opciones más simples porque corren
npm startdirectamente (a diferencia de Vercel, pensado para funciones serverless, que no sostiene la conexión WebSocket de Socket.io). - Variables de entorno en el host:
DATABASE_URL,AUTH_SECRET,NEXTAUTH_URL(la URL pública del deploy). - Corre
npm run db:push(odb:migratesi usas migraciones) ynpm run db:seeduna vez contra la base de datos de producción.
MIT













