Ongoing

Daoloth SSG — static site generator.

Architect @ Open Source

Static site generator in TypeScript optimised for SEO and AIO. Built in Zaragoza; it is the engine that generates this very site, barbosa.com.es.

Development of a custom Static Site Generator (SSG) in TypeScript, designed from the ground up to maximise visibility in classic search engines and in AI ecosystems (AIO).

Key Features

  • Modular architecture with an extensible theme and shortcode system
  • Automatic SEO optimisation: JSON-LD, Pretty URLs, sitemap, robots.txt, llms.txt
  • Built-in audit system with SEO and AIO scoring
  • CI/CD pipeline with Jenkins for automated deployment
  • Web Admin Tool for CRUD content management with real-time Markdown preview
  • Content types: posts, static pages and projects with typed frontmatter
  • Hugo-like shortcode system: youtube, alert, timeline, section, project and more
  • Draft support: a draft frontmatter field to hide work-in-progress content

Admin Tool

A local admin panel (Express + vanilla JS) on localhost:3001 to manage projects without touching files by hand:

  • Full CRUD over content/projects/*.md
  • Split-pane editor with real-time Markdown preview
  • Frontmatter validation and automatic slug generation
  • Visual reordering, status filters, toast feedback
  • Protection against path traversal and XSS

Technical Stack

The engine is built on TypeScript with EJS for templates, marked for Markdown processing, and gray-matter for frontmatter extraction. The shortcode system enables rich content without frontend framework dependencies. The admin tool uses Express.js with a vanilla SPA (HTML/CSS/JS) served as static files.

SEO and AIO Approach

The generator is designed so that content is citable by both classic search engines and generative AIs. Every page is served as complete HTML in the initial response — no JS hydration for the relevant content — so that any crawler that doesn't execute JavaScript sees all the text. On top of that foundation, the engine emits JSON-LD per page type (WebSite, Person, Service, CreativeWork, FAQPage, BreadcrumbList), a sitemap, robots.txt and an llms.txt consistent with the sitemap.

The built-in audit system scores every build along two axes — classic SEO and AIO — and reports actionable findings per page, turning optimisation into a measurable process on every deployment rather than guesswork. This very site is generated with Daoloth and serves as its testing ground.