Sitio oficial de JConf Perú, la conferencia anual organizada por Peru JUG sobre Java, Jakarta EE, Spring, GraalVM, arquitecturas nativas en la nube y temas afines.
- 🌐 Producción: https://jconfperu.com
- 🛠️ Stack: Astro 7 + Tailwind CSS 4 + Content Collections + TypeScript estricto
- 🚀 Deploy: Vercel, publicado por GitHub Actions al hacer push a
master
- Pre-requisitos
- Correr el sitio localmente
- Estructura del proyecto
- Cómo agregar una edición nueva
- Cómo agregar un speaker
- Cómo agregar un sponsor
- Cómo agregar una sesión / charla
- Cómo agregar un organizador
- Comandos útiles
- Despliegue
- Node.js 22 LTS (mínimo 22.23.4; versión recomendada en
.mise.tomly.nvmrc) - npm 10+
Con mise:
mise installTambién puedes usar fnm o nvm con .nvmrc.
npm ci
npm run devEl servidor de desarrollo arranca en http://localhost:4321 con HMR (recarga en caliente al editar contenido o componentes).
.
├── public/ Activos servidos tal cual (favicon, robots.txt)
├── src/
│ ├── assets/images/ Imágenes procesadas (WebP/AVIF al build)
│ ├── components/ Componentes Astro (.astro) reutilizables
│ ├── content/ Contenido del sitio en Markdown / Frontmatter
│ │ ├── editions/ Una edición por archivo: 2023.md, 2024.md…
│ │ ├── speakers/ Speakers (uno por archivo)
│ │ ├── organizers/ Organizadores
│ │ ├── sponsors/ Sponsors
│ │ └── sessions/ Sesiones (charlas) por edición
│ ├── content.config.ts Esquemas Zod de las collections
│ ├── layouts/Layout.astro Layout base con SEO + JSON-LD
│ ├── lib/ Helpers (editions, site, sessionize)
│ ├── pages/ Rutas del sitio (index, /agenda, /speakers, …)
│ └── styles/global.css Tokens de marca + Tailwind
├── astro.config.mjs Config de Astro (sitemap, mdx, tailwind)
├── vercel.json Config de Vercel + redirects de URLs antiguas
└── .github/workflows/ci.yml CI: typecheck + build
Esta es la operación más frecuente. Solo necesitas un archivo Markdown.
-
Copia
src/content/editions/2026.mdy renómbralo a2027.md. -
Edita el frontmatter con los datos del evento:
--- year: 2027 title: JConf Perú 2027 tagline: La conferencia para usuarios y desarrolladores Java. date: 2027-12-05T08:00:00-05:00 # null si aún no se confirma dateLabel: Fecha por anunciar # se muestra solo si date == null status: upcoming # upcoming | past featured: true # SOLO una edición debe ser true venue: name: Centro de Convenciones Cronos address: Av. El Derby 055, Surco city: Lima country: Perú mapsQuery: Av. El Derby 055 Lima stats: hours: 10 sessions: 14 countries: 8 speakers: 14 sessionizeEventId: "abc123xyz" # opcional, ID del evento en Sessionize cta: label: Comprar entradas href: https://... --- ## Sobre la edición 2027 Texto Markdown libre que se renderiza en la home.
-
Importante: marca la edición anterior como histórica. En
2026.md, cambia:status: past featured: false
-
Eso es todo. Al hacer
npm run build:/muestra automáticamente la ediciónfeatured: true(la más nueva).- Las ediciones
status: pastaparecen en/anteriorescon su propia página/anteriores/<año>. - Sitemap, JSON-LD
Eventy countdown se actualizan solos.
Tip: Si no quieres copiar contenido viejo, usa
git mvy deja el archivo antiguo intacto. Los archivos por año son independientes.
Crea un archivo en src/content/speakers/<año>/<slug>.md:
---
name: Jane Doe
role: Senior Engineer
company: Acme Corp
country: Brasil
photo: ../../../assets/images/speakers/2027/jane-doe.jpg # opcional
website: https://janedoe.dev
twitter: https://twitter.com/janedoe
linkedin: https://www.linkedin.com/in/janedoe/
github: https://github.com/janedoe
editions: [2027]
featured: false
---
Bio opcional en Markdown.Coloca la foto en src/assets/images/speakers/<año>/. Astro la procesa
automáticamente a WebP/AVIF responsivos.
Para la edición destacada, los speakers salen del embed HTML
view/SpeakerWallsi configurassessionizeSpeakersEmbedId. Sin ese ID se usa el JSON desessionizeEventId, y si tampoco está, los archivos locales.
Crea src/content/sponsors/<slug>.md:
---
name: Acme Corp
tier: platinum # platinum | gold | silver | community
logo: ../../assets/images/sponsors/acme.png
website: https://acme.com
editions: [2026, 2027] # años en los que patrocinó
---El logo aparecerá automáticamente en /sponsors, en el home (si la edición
es la destacada) y en la página histórica de cada año correspondiente.
Para ediciones donde mantenemos la agenda en el repo (ediciones pasadas),
crea src/content/sessions/<año>/<orden>-<slug>.md:
---
edition: "2027" # ⚠️ string, no número (es el id del archivo)
title: Domain-Driven Design en la práctica
speakerProfiles:
- name: Jane Doe
url: https://janedoe.dev
room: Sala A
startTime: "10:00"
endTime: "10:50"
order: 4 # determina el orden en la grilla
type: talk # talk | break | keynote | panel | opening | closing
youtubeUrl: https://...
facebookUrl: https://...
linkedinUrl: https://...
---Para la edición vigente,
sessionizeAgendaEmbedIdinserta el embedview/GridSmartysessionizeSpeakersEmbedIdel embedview/SpeakerWall.sessionizeEventIdqueda como respaldo JSON de speakers cuando no hay embed.
Cuando termine el evento:
- Exporta speakers y agenda desde Sessionize.
- Crea los registros en
src/content/speakers/<año>/ysrc/content/sessions/<año>/. - Elimina
sessionizeEventIdde la edición histórica para que el archivo no dependa de un servicio externo. - Cambia la edición a
status: pastyfeatured: false. - Instala Chromium una vez con
npx playwright install chromium, ejecutanpm testy revisa/anteriores/<año>en el preview.
La edición 2025 ya está archivada localmente siguiendo este proceso.
Crea src/content/organizers/<slug>.md:
---
name: Pedro Pérez
role: Comunidad y partnerships
photo: ../../assets/images/organizers/pedro.jpg
linkedin: https://www.linkedin.com/in/pperez/
twitter: https://twitter.com/pperez
editions: [2026, 2027]
order: 5 # orden ascendente; los más bajos van primero
---
Bio breve opcional.| Comando | Para qué sirve |
|---|---|
npm run dev |
Servidor de desarrollo en http://localhost:4321 |
npm run check |
Typecheck y validación de Content Collections |
npm run build |
Genera activos sociales y el sitio estático en dist/ |
npm run validate:site |
Valida enlaces, activos, metadata y redirects generados |
npm run test:site |
Smoke tests y Axe sobre el preview local |
npm test |
Ejecuta el gate local completo |
npm run audit |
Rechaza vulnerabilidades high/critical conocidas |
La primera ejecución de los tests de navegador requiere Chromium:
npx playwright install chromiumGitHub Actions publica el sitio en Vercel cuando el job de CI termina en verde:
- Producción: cada push a
masterdespliega a https://jconfperu.com. - Preview: cada Pull Request abierto desde este repositorio recibe una URL
*.vercel.app. - Build: la acción ejecuta
npm ciynpm run build, y Vercel publicadist/segúnvercel.json.
Los secrets del repositorio son VERCEL_TOKEN, VERCEL_ORG_ID y VERCEL_PROJECT_ID.
El job de CI sigue ejecutando auditoría, typecheck, build, validación del sitio
generado, pruebas de navegador y accesibilidad antes de desplegar.
Antes de mergear una edición o rediseño:
- CI debe estar completamente verde y sin vulnerabilidades high/critical no aceptadas.
- Un maintainer técnico revisa navegación, responsive, tema y fallback de Sessionize.
- Un organizador valida fecha, sede, agenda, speakers, sponsors, registro y textos.
- Se prueban mobile y desktop, social cards y las rutas históricas en el preview.
- La credencial antigua de Google Maps debe estar rotada o restringida por API y referrer.
Después del merge, verifica /, /agenda, /speakers, /anteriores/2025,
sitemap-index.xml, los redirects y la tarjeta social. Si falla un gate,
restaura inmediatamente el deployment anterior desde Vercel y revierte el merge.
/2024.html, /agenda.html, /payment-info.html e /index.html se redirigen
permanentemente desde vercel.json.
MIT — © Peru JUG