Overview

High-level developer map of the HeadlessX product repos and runtime architecture.

by @saifyxpro

HeadlessX development happens primarily in the product monorepo:

RepositoryRole
HeadlessXproduct monorepo for API, dashboard, worker, markdown service, and yt-engine

Main product apps

Inside HeadlessX:

  • apps/api for REST, SSE, jobs, auth, and MCP
  • apps/web for the operator dashboard
  • apps/go-html-to-md-service for content extraction support
  • apps/yt-engine for YouTube extraction and temporary save workflows

Runtime model

  • the dashboard and external clients talk to apps/api
  • the API uses PostgreSQL for state
  • queue-backed work runs through Redis and a worker
  • the API delegates markdown and YouTube tasks to dedicated services