Skip to content

Releases: alejandrocuba/alejandrocuba-website

v4.0.0 - Stack Modernization, SSR Syntax Highlighting, and AI Agent Discovery Protocols

30 May 05:15
a416a25

Choose a tag to compare

This major release represents a complete modernization of the website architecture, migrating from legacy build tools to a modern Vite pipeline, introducing Server-Side Rendering (SSR) for syntax highlighting to optimize Core Web Vitals, and implementing standard protocols for AI Agent Discovery and Authentication.

Key Highlights

Infrastructure & Build System Modernization

  • Vite Migration: Replaced the legacy Grunt-based pipeline with Vite and Vituum for fast builds and hot module reloading.
  • CI/CD Upgrades: Modernized GitHub Actions workflows to use actions/checkout and actions/setup-node v6 compatible with Node 24.
  • Dependency Updates: Upgraded all packages to their latest versions and pruned obsolete vendor dependencies (e.g. jQuery, PostCSS).

Performance & Core Web Vitals (LCP & INP)

  • SSR Syntax Highlighting: Migrated code syntax highlighting to build time using server-side PrismJS compilation, removing client-side prism.min.js to eliminate runtime parsing and rendering blocks.
  • Critical CSS Inlining: Implemented a custom Vite plugin (inline-css-plugin) to inline critical styles directly into the pre-rendered HTML, removing render-blocking CSS tags.
  • Asset Optimization: Migrated all portfolio and static assets to highly compressed WebP format.
  • Font Loading: Refactored Google Fonts imports to target specific weights and implemented asynchronous font loading.

Accessibility (a11y) & SEO Enhancements

  • A11y Refactoring: Normalised the console template structure and flattened navigation links to ensure screen-reader friendliness.
  • Footer Improvements: Added automated copyright year generation and simplified boilerplate copyright declarations.
  • SEO Cleanups: Standardised header hierarchy (ensuring exactly one <h1> per page) and improved OpenGraph/Twitter social meta-tags.

AI Agent Discovery & WebMCP Integration

  • Discovery Protocols: Implemented standard .well-known endpoints for AI client negotiation:
    • /.well-known/oauth-authorization-server
    • /.well-known/oauth-protected-resource
    • /.well-known/openid-configuration
    • /.well-known/jwks.json
    • /.well-known/api-catalog
  • WebMCP Support: Integrated WebMCP communication (webmcp.js) and registered a WebMCP server card under /.well-known/mcp/server-card.json.
  • Agent Capabilities: Added structured registration protocols (auth.md) and a skill catalog under /.well-known/agent-skills/ to describe developer portfolio details programmatically.

What's Changed

New Contributors

Full Changelog: v3.0.0...4.0.0