Skip to content
trinity-bytesPublic

Repository files navigation

Tranqui. Llega a tu destino con más tranquilidad.

Tranqui · Landing

Reportes anónimos que tus vecinos validan: mira qué pasa en tu zona, recibe alertas cerca de ti y elige por dónde ir.

tranqui.jahattrinidad.com

Deploy Release Astro 7 Tailwind CSS 4


Qué es

Landing informativa del proyecto académico Tranqui. Presenta la app, cómo funciona, su modelo de privacidad, los planes y el equipo. Es un sitio estático hecho con Astro 7 y Tailwind 4, sin runtime de React. La app Flutter vive en otro repositorio.

Hero de la landing en escritorio

Cómo funciona la app

Mapa de la zona
Mira tu zona
Reportar un incidente
Reporta
Validar un reporte
Tus vecinos validan
Alerta cercana
Recibe alertas
Ruta sugerida
Elige por dónde ir

Pantallas de demostración: mapas y cifras son ejemplos.

La landing

Sección de privacidad en escritorio Hero en mobile
  • Campo de glifos animado en canvas, que reacciona al cursor y al click.
  • Narrativa con scroll: cuatro pasos con el teléfono fijo; sin JavaScript o en pantallas bajas se leen apilados.
  • Accesible: menú con <dialog> nativo, FAQ con <details> y respeto por prefers-reduced-motion.
  • Imágenes optimizadas: Astro y Sharp generan AVIF y WebP en el build.

Desarrollo

Requisitos: Node.js 22.23.4 o superior y npm.

npm ci
npm run dev

Abre http://localhost:4321/.

Note

En Linux x64 sin AVX2 (CPUs anteriores a 2013), el compilador nativo de Astro 7 termina con Illegal instruction. El postinstall (scripts/astro-compiler-fallback.mjs) lo detecta y usa la versión WASI oficial del mismo compilador; en el resto de equipos y en CI no hace nada. Con npm ci --ignore-scripts ese paso no corre y, en esas CPUs, el build falla.

Verificación

Ejecuta los comandos de a uno, no en paralelo: el entorno de desarrollo tiene unos 3 GB de RAM.

npm run lint
NODE_OPTIONS=--max-old-space-size=768 npm run type-check
node --test --test-concurrency=1 tests/build-wrapper.test.mjs tests/astro-compiler-fallback.test.mjs
npm run build
npm run preview

build limita el heap de Node a 768 MiB y el pool de imágenes a un hilo, y conserva los argumentos de Astro (npm run build -- --outDir /tmp/tranqui-preview). El primer build tarda más por las imágenes; los siguientes reutilizan caché.

Tests de navegador (Playwright)

Instala Chromium una vez con npx playwright install chromium. Con npm run preview activo, ejecuta un script por vez:

node tests/navigation.mjs
node tests/glyph-field.mjs
node tests/narrative.mjs
node tests/trust-content.mjs
node tests/closing-content.mjs
node tests/integration.mjs
node tests/metadata.mjs
  • TEST_URL cambia la URL de prueba.
  • PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH usa un Chromium ya instalado.
  • QA_SCREENSHOT_DIR guarda capturas del test de integración fuera del repositorio.

Informe observado.

Estructura

src/
├── components/
│   ├── sections/   secciones de la landing
│   ├── ui/         primitivas, campo de glifos y capa de movimiento
│   └── layout/     header, diálogo mobile y footer
├── assets/landing/ fotos, retratos, pantallas y SVG aprobados
└── layouts/        BaseLayout con metadata y social cards
docs/
├── landing-spec/   copy, medidas y capturas originales de Figma
├── previews/       imágenes de vista previa (GitHub, Figma)
└── readme/         capturas de este README
odd/tasks/          plan de implementación, decisiones y evidencia

Despliegue

Cada push a main publica en GitHub Pages, en el dominio tranqui.jahattrinidad.com. El trabajo se integra en develop y llega a main con un release de git-flow. Detalles en DEPLOYMENT.md.

Contenido pendiente

Todavía no hay enlace de Google Play, páginas legales, enlaces del equipo ni destino de contacto aprobado, y no se publican destinos ficticios: el badge de Google Play está inactivo. Figma tiene seis preguntas frecuentes y solo la primera respuesta; las otras cinco quedan en los datos con answer: null, fuera de la página pública. Las metas no se presentan como logros.