A command-line tool that generates Apple-style API documentation for Swift and Objective-C projects.
jazzy is a command-line utility that generates API documentation for Swift and Objective-C projects. It produces documentation that matches Apple's official reference style by using the Clang AST and SourceKit for accurate code analysis instead of simple text parsing. It solves the problem of creating professional, consistent documentation for Apple platform developers.
Swift and Objective-C developers, particularly those building libraries, frameworks, or SDKs for Apple platforms (iOS, macOS, etc.) who need to generate public API documentation.
Developers choose jazzy because it produces documentation that looks exactly like Apple's official references, supports both Swift and Objective-C with high accuracy, integrates with Dash for offline browsing, and offers extensive customization through themes and configuration.
Soulful docs for Swift & Objective-C
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Uses Clang AST and SourceKit instead of text parsing, ensuring precise representation of code structure and comments from both Swift and Objective-C.
Generates documentation that matches the look and feel of Apple's official reference documentation post-WWDC 2014, providing a professional and consistent appearance.
Documents both Swift and Objective-C projects, including mixed-language modules, and supports multiple modules in a single site with unified search and navigation.
Creates docsets for the Dash documentation browser, including web install buttons for easy offline access, as highlighted in the README.
Primarily designed for macOS; running on Linux requires manual installation and building of SourceKitten, adding significant setup complexity.
The feature for mixed Objective-C/Swift projects is explicitly noted as having 'some rough edges,' requiring pre-generated SourceKitten files and extra steps.
Does not support all Objective-C documentation keywords from Apple's HeaderDoc, limiting full compatibility for comprehensive Objective-C projects.
Advanced use cases, such as passing build arguments with commas, often require switching to a YAML config file instead of command-line flags, increasing setup time.