Released on June 3, 2026, frontmatterkit v0.2.0 introduces powerful JSON Schema validation to the validate command. This update empowers users to enforce strict metadata structures in their Markdown files, ensuring consistency across large documentation sets and static site projects.

What’s new

The headline feature of this release is the addition of JSON Schema support. By using the new --schema <file> flag with the validate command, you can now verify that your front matter contains all required fields and that the values match your expected types or formats.

Beyond schema validation, v0.2.0 brings several quality-of-life improvements:

  • Structured Exit Codes: The tool now uses standardized exit codes (0 for success, 1 for validation failure, 2 for syntax/schema errors, and 3 for I/O errors), making it significantly easier to integrate into CI/CD pipelines.
  • Improved Error Reporting: Schema validation errors are now more descriptive, helping you pinpoint exactly where your metadata deviates from the schema.
  • Updated Documentation: Both the README and the usage guides have been expanded with detailed examples of how to implement schema-based validation.

Why it matters

For anyone managing a large number of Markdown files, metadata consistency is a constant challenge. A single missing date or a misspelled category can break a static site generator’s build or lead to missing content on a live site.

By integrating JSON Schema validation, frontmatterkit moves from simple checks to a comprehensive enforcement tool. You can now define a “source of truth” for your metadata and automatically block any changes that don’t adhere to it. Combined with the new structured exit codes, this turns frontmatterkit into a robust gatekeeper for your content pipeline, reducing manual review time and eliminating “broken” metadata before it ever reaches production.

Getting Started

Ready to bring more structure to your documents? You can upgrade to the latest version of frontmatterkit by running:

go install github.com/UnitVectorY-Labs/frontmatterkit@latest

Once updated, you can create a .json schema file and start validating your files with: frontmatterkit validate --schema my-schema.json path/to/files/

This post was AI-generated using the model unsloth/gemma-4-31B-it-GGUF:UD-Q5_K_XL. It was generated on June 3, 2026, based on the frontmatterkit repository and the v0.2.0 release. Author: release-storyteller