Ir al contenido principal
CushLabs logoCUSHLABS.AI
Volver al Portafolio

AI Portfolio

A static portfolio system that syncs project data from GitHub repos into a filterable showcase

Video Demostrativo

Video Demostrativo

Capturas de Pantalla

1 / 10
Pagina principal del portafolio con seccion de proyectos destacados
Cuadricula del portafolio con filtrado por categoria
Cuadricula del portafolio en modo oscuro
Pagina de detalle del proyecto con carrusel de imagenes
Pagina de detalle — secciones de problema y solucion
Pagina de detalle — caracteristicas principales y metricas
Pagina de detalle con barra lateral de tecnologias
Pagina de vitrina de proyectos destacados
Cuadricula responsiva del portafolio en movil
Version en espanol del portafolio

El Desafío

Maintaining a portfolio across dozens of GitHub repositories creates a content management problem. Project descriptions, tech stacks, and status information scatter across READMEs and repo settings with no unified display layer. A separate portfolio site inevitably falls out of sync with the actual work.

La Solución

Each repository owns its portfolio entry through a version-controlled PORTFOLIO.md file at its root, keeping content co-located with the code it describes. A TypeScript sync script fetches and parses every file via the GitHub API, validates it through a Zod schema with backward-compatible transforms, and outputs a single static JSON file — with sync errors and warnings auto-reported as deduplicated GitHub Issues. The portfolio page drives search, category filtering, and sort entirely through URL params for shareable views, and Next.js serves statically generated pages with zero runtime API calls.

Características Clave

  • 21 projects aggregated from GitHub repos into a single filterable interface
  • Client-side search, category filtering, and sort — all via shareable URL params
  • Zero runtime API calls — fully static, sub-second page loads
  • Content managed through PORTFOLIO.md files co-located with source code
  • Sync issue notifications — errors and warnings auto-reported as GitHub Issues with deduplication and auto-close
  • Featured project showcase with curated top-6 selection
  • Dark mode with system preference detection

Resultados

  • 21 projects browsable by category with instant client-side search, filter, and sort
  • Zero runtime API calls — fully static pages with sub-second loads
  • Featured showcase highlighting the 6 strongest projects with detailed breakdowns
  • Filtered views shareable via URL — bookmarkable category and sort combinations

Proyectos Relacionados

¿Tienes un desafío similar?

Hablemos sobre cómo una solución así podría funcionar para tu equipo. Llamada gratis, sin compromiso.

Agendar Llamada Gratis