Monorepo Structure
Current workspace layout for the HeadlessX product repo and its docs companion.
by @saifyxpro
HeadlessX
What each area does
| Path | Purpose |
|---|---|
apps/api | Express API, SSE routes, MCP, auth, jobs |
apps/web | operator dashboard and scraper playground |
apps/go-html-to-md-service | markdown extraction helper |
apps/yt-engine | yt-dude based extraction and temporary media packaging |
docs | product setup and endpoint references |
infra/docker | Docker files and compose stack |
Root workspace files
| File | Purpose |
|---|---|
package.json | root scripts for pnpm, Nx, Knip, and service runners |
nx.json | Nx task defaults and cache behavior |
mise.toml | mise tasks for dev, build, lint, format, and knip |
knip.json | Knip workspace entrypoints and ignore rules |
.env | shared runtime config for the product workspace |
pnpm-workspace.yaml | pnpm workspace package layout |
Companion docs app
This separate repo owns the public docs system and landing page, not the product runtime itself.
Was this page helpful?