Examples / doxygen

Icey C++ API

A live C++20 API reference generated from Icey's Doxygen XML with Sourcey's native Doxygen tab.

Features demonstrated

  • Doxygen XML rendered through Sourcey's native Doxygen support
  • C++ classes, namespaces, functions, enums, and typedefs
  • Markdown guides beside generated API reference
  • Rich API reference index and sidebar navigation
  • Search and llms-full.txt output from the same build

Icey is the live C++ proof for Sourcey’s Doxygen support. The project keeps its normal Doxyfile and C++ comments, emits Doxygen XML, then lets Sourcey render that XML as part of the same static docs site as its guides and module docs.

This matters because Sourcey does not ask C++ projects to abandon Doxygen’s parser. The parser is the useful part. Sourcey replaces the output layer.

Source

The source is Icey’s C++20 codebase and Doxygen XML output. Icey’s docs config adds an API Reference tab with a doxygen source pointing at the generated XML directory:

{
  tab: "API Reference",
  doxygen: {
    xml: "../build/doxygen/xml",
    language: "cpp",
    index: "rich",
  },
}

The hand-written docs remain normal Markdown pages under guides, concepts, recipes, module notes, and operations material.

Output

The generated API reference gives Icey stable pages for the C++ surface while keeping the surrounding project docs in the same navigation, theme, search index, sitemap, and llms-full.txt output.

Why it matters

For C and C++ projects, Doxygen is usually already in the build. Icey shows the clean migration path: keep the parser, keep the comments, keep the Doxyfile, and ship a modern static docs site from the XML.

doxygenc++moxygenicey