awesome-repositories.com
Blog
MCP
awesome-repositories.com

Discover the best open-source repositories with AI-powered search.

ExploreCurated searchesOpen-source alternativesSelf-hosted softwareBlogSitemap
ProjectMCP serverAboutHow we rankPress
LegalPrivacyTerms
© 2026 Bringes Technology SRL·VAT RO45896025·hello@awesome-repositories.com
danielgtaylor avatar

danielgtaylor/aglio

0
View on GitHub↗

Aglio

Aglio is a command-line interface tool and static HTML renderer designed to convert API Blueprint specification files into readable, web-based documentation. It transforms structured API specifications into standalone HTML pages that can be hosted and distributed without a backend server.

The project includes a theme engine that allows for the customization of visual styles through CSS variables and layout template overrides. Users can apply built-in themes or integrate external modules to change how the documentation is rendered.

The tool supports modular document composition, enabling the merger of multiple specification and markdown files into a single document using relative path inclusions. It also provides a local development server with a live-reloading preview to view rendered changes in real time.

AI search

Explore more awesome repositories

Describe what you need in plain English — the AI ranks thousands of curated open-source projects by relevance.

Start searching with AI

Features

  • Static HTML Generators - Converts structured API specifications into standalone, non-interactive HTML files for static hosting.
  • AST to HTML Renderers - Transforms the parsed API specification abstract syntax tree into structured static HTML output.
  • Modular Document Composition - Merges multiple specification and markdown files into a single document through a recursive include mechanism.
  • Partial Document Inclusion - Embeds separate specification and markdown files into a single document using relative path partials.
  • API Specification Managers - Organizes large API definition files by merging multiple specifications into a single rendered document.
  • API Blueprint Rendering - Converts API Blueprint specification files into static HTML pages to create a readable website for developers.
  • API Documentation - Provides technical specifications and visual styling for API documentation using themes and CSS.
  • API Documentation Generators - Automatically generates static HTML documentation for API endpoints from specification files.
  • Documentation Themes - Implements a system of pre-built visual templates and layouts designed specifically for API documentation.
  • HTML Document Renderers - Transforms API Blueprint specification formats into structured HTML for web-based display.
  • Document Inclusion Tracking - Extracts all linked files within a document to trigger automatic build updates and file watching.
  • Document Parsing CLI Tools - Provides a command-line interface for triggering the conversion of API specifications into HTML.
  • Documentation Previewers - Renders API documentation files in real-time within a browser during the editing process.
  • Live Preview Servers - Provides a local server that renders documents and refreshes the browser automatically as source files change.
  • Source File Watching - Monitors source files and their relative inclusions to trigger automatic rebuilds during development.
  • CSS Variable Theming - Maps configuration variables to native CSS variables to control the visual theme of the documentation.
  • Theme Style Customizations - Allows overriding default design tokens for colors, fonts, and spacing via configuration to style the output.
  • Visual Style Customization - Provides mechanisms to apply custom CSS and layout variables to modify the overall appearance of the generated documentation.
  • Template Overrides - Allows replacing default HTML layout files with custom templates to change the overall structure of the documentation.
  • Custom Themes - Supports the application of built-in or custom visual themes specifically designed for API documentation interfaces.
  • Layout Wrappers - Injects rendered documentation content into customizable HTML wrappers to control page structure.
  • API Design Tools - Renders API Blueprint files into static HTML documentation.
  • API Documentation - Renders API Blueprint documentation to HTML.
  • Miscellaneous Tools - Renderer for API documentation.
4,741 stars·471 forks·CoffeeScript·29 views

Star history

Star history chart for danielgtaylor/aglioStar history chart for danielgtaylor/aglio

How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.

Projects sharing features with Aglio

These projects share indexed features with Aglio. Shared tags can include platform or build tooling; verify the primary use case before treating a result as a replacement.
  • alex-shpak/hugo-bookalex-shpak avatar

    alex-shpak/hugo-book

    4,051View on GitHub↗

    hugo-book is a documentation theme and static site framework for Hugo designed to create structured technical manuals, documentation books, and multilingual knowledge bases. It transforms directory structures into hierarchical navigation menus and formatted technical content. The framework includes a specialized OpenAPI documentation renderer that converts specifications into structured reference pages. It also provides a full-text client-side search integration and supports multilingual content with right-to-left layout mirroring. The project covers a wide range of content rendering capabil

    HTMLdocumentationhugohugo-theme
    View on GitHub↗4,051
  • redocly/redocRedocly avatar

    Redocly/redoc

    26,004View on GitHub↗

    Redoc is an API documentation generator that transforms standard API specification files into interactive, responsive, and highly customizable web-based documentation interfaces. It provides a three-panel layout that includes synchronized navigation, code samples, and search functionality, allowing developers to explore endpoints and schemas directly within a browser-based environment. Beyond rendering, the project functions as an API governance toolkit that enforces structural standards and quality rules across API definitions. It includes a suite of processing utilities for bundling, splitt

    TypeScriptapi-documentationdocumentation-generatordocumentation-tool
    View on GitHub↗26,004
  • markdoc/markdocmarkdoc avatar

    markdoc/markdoc

    8,520View on GitHub↗

    Markdoc is a documentation content framework that extends standard Markdown with custom tags, typed schemas, and reusable components, parsing content into an abstract syntax tree and rendering it as React elements or HTML. It provides a structured authoring system where documents are processed through an AST-based pipeline, enabling validation, transformation, and flexible output generation. The framework distinguishes itself through a schema-driven validation pipeline that checks document structure and attribute values against defined rules, and a pluggable renderer architecture that accepts

    TypeScriptauthoringdocumentationmarkdoc
    View on GitHub↗8,520
  • ymfe/yapiYMFE avatar

    YMFE/yapi

    27,722View on GitHub↗

    yapi is an API management platform designed to coordinate the development of RESTful APIs between frontend, backend, and quality assurance teams. It functions as a centralized system for documenting interface specifications, simulating server responses, and validating requests through a built-in testing client. The platform features an API code generator that transforms interface specifications into typed request functions and data models across multiple programming languages. It also includes a mock server capable of generating synthetic responses using schema-based generators and rule-based

    JavaScriptapiapi-managementapi-manager
    View on GitHub↗27,722
Compare all 30 related projects→

Frequently asked questions

What does danielgtaylor/aglio do?

Aglio is a command-line interface tool and static HTML renderer designed to convert API Blueprint specification files into readable, web-based documentation. It transforms structured API specifications into standalone HTML pages that can be hosted and distributed without a backend server.

What are the main features of danielgtaylor/aglio?

The main features of danielgtaylor/aglio are: Static HTML Generators, AST to HTML Renderers, Modular Document Composition, Partial Document Inclusion, API Specification Managers, API Blueprint Rendering, API Documentation, API Documentation Generators.

Which projects share features with danielgtaylor/aglio?

Projects with overlapping indexed features include: alex-shpak/hugo-book — hugo-book is a documentation theme and static site framework for Hugo designed to create structured technical manuals,… redocly/redoc — Redoc is an API documentation generator that transforms standard API specification files into interactive, responsive,… ymfe/yapi — yapi is an API management platform designed to coordinate the development of RESTful APIs between frontend, backend,… markdoc/markdoc — Markdoc is a documentation content framework that extends standard Markdown with custom tags, typed schemas, and… kitian616/jekyll-text-theme — This project is a responsive Jekyll static site theme designed for technical blogs, documentation, and multilingual… apidoc/apidoc — apidoc is a source-code API documentation generator that parses specialized annotations within comments to…