Paxl es un editor visual de landing pages. Montas la página con bloques, la ves en escritorio, tablet y móvil, la editas con otras personas a la vez y la publicas con su propia dirección. El frontend es Next.js con React y TypeScript, y el backend, Django con Channels para el tiempo real.
01 En corto
02 Mi papel
Trabajé con Claude Code y con Codex. Las reglas para los agentes están en el propio repositorio, y cada decisión y cada fallo importante quedan escritos. Así cada cambio se puede revisar por lo que hace y por cómo se comprobó.
03 Cómo funciona
El navegador solo habla con Next.js. Next pasa a Django las llamadas a /api, así que las cookies de sesión son del mismo sitio y JavaScript nunca ve el token de sesión. El servidor manda: cada página tiene un número de versión, y todo lo que entra en un bloque, venga del editor, del WebSocket, de la IA o de una versión restaurada, pasa por la misma función de validación.
Navegador
Next.js
Django
El editor abre el WebSocket directamente con Django, con un ticket de un solo uso.
El WebSocket no lleva la página: solo avisa de que algo ha cambiado y retransmite lo que se escribe en el bloque bloqueado. La página publicada se genera en el servidor desde una copia congelada, y al publicar Django avisa a Next para que renueve la caché.
Los tres tienen su entrada en el registro de decisiones del repositorio, con el contexto y lo que se descartó.
Colaboración · ADR-024
Cada autoguardado mandaba la página entera y ganaba el último. Si una persona borraba un bloque y otra guardaba después, el bloque volvía.
Ahora cada página tiene una versión. Un guardado hecho sobre una versión vieja recibe un 409 con la página actual, y el editor fusiona en tres vías sin perder ninguna edición. Se probó con dos navegadores reales: 13 comprobaciones, tres pasadas seguidas sin un fallo.
IA · ADR-023
Una demo pública no puede gastar una clave de pago, y con una clave en el servidor cualquiera podía agotarla. En modo demo, que viene activado, Paxl no llama a ninguna IA: sirve una de diez páginas de ejemplo escritas a mano y lo dice en pantalla.
Con tu propia clave de Gemini o Anthropic genera de verdad, y la clave no se guarda. Lo que devuelve la IA pasa por la misma validación que el editor.
Publicar · ADR-017 y 019
Al principio la página pública leía los bloques en vivo, así que cada autoguardado cambiaba lo que veían los visitantes mientras aún se editaba. Ahora publicar guarda una copia, y nada llega al público hasta que vuelves a publicar.
La página pública se genera en el servidor y se queda en caché hasta la siguiente publicación. La prueba de esa caché encontró otro fallo: una página despublicada respondía 200 en lugar de 404.
04 Calidad
Hay más de 3.000 pruebas automáticas. GitHub Actions las ejecuta en cada push a main y en cada pull request, repartidas en cuatro trabajos, y el resultado de cada ejecución se puede ver en el repositorio.
05 Galería
Capturas de Paxl en local, con un asador inventado, Casa Tomillo, hecho con la plantilla de restaurante de Paxl. Las cuentas y los mensajes también son inventados. El vídeo es de un par de días antes y algunos detalles de la interfaz han cambiado.
06 Estado
Paxl funciona en local y el código está en GitHub, con el CI en verde. Todavía no tiene demo pública: me falta subirlo a un alojamiento. Está pensado para un alojamiento gratuito con una sola instancia, y tiene límites conocidos:
Software libre: Next.js, React, Zustand, Tailwind CSS, next-intl, Django, Django REST Framework, Channels y Playwright.