# Bovnar (BVNR)

> Unit-safe serialization for scientific and industrial systems — with a C99 reference implementation.

Bovnar is a self-describing data serialization format: every value carries its own type family, bit-width, numeric base, and physical unit inline, validated by the parser, with no external schema. This file maps the Markdown documentation and project resources.

## Documentation

- [Tutorial](https://www.bovnar.io/doc/0_bovnar_tutorial.md): A guided introduction to writing and reading Bovnar documents.
- [Specification](https://www.bovnar.io/doc/1_bovnar_spec.md): The complete format specification (spec 1.1): grammar, types, units, limits.
- [Unit system](https://www.bovnar.io/doc/2_bovnar_unit_system.md): The 163 physical units, SI/IEC prefixes, and 216 currencies, with dimensions and factors.
- [Read & Write C API](https://www.bovnar.io/doc/3_bovnar_readwrite_api.md): The C reader/writer/DOM API reference (bovnar.h, bovnar_dom.h).
- [Python bindings](https://www.bovnar.io/doc/4_bovnar_python_bindings.md): The pure-ctypes Python package: loads/dumps, streaming, DOM, Quantity, NumPy/Pint bridges.
- [EBNF grammar](https://www.bovnar.io/doc/5_bovnar.ebnf): The formal grammar, annotated against the reference lexer/validator.
- [FAQ](https://www.bovnar.io/doc/6_bovnar_faq.md): Common questions on types, units, limits, encoding, and the API.
- [Conformance](https://www.bovnar.io/doc/7_bovnar_conformance.md): The 319-case conformance suite and the IUT protocol for third-party implementations.
- [Unit & currency cheatsheet](https://www.bovnar.io/doc/8_unit_cheatsheet.md): Every unit symbol, prefix, and currency code in one reference table.
- [Streaming & framing](https://www.bovnar.io/doc/9_bovnar_streaming.md): Octet streams, frames, multiplexing/demultiplexing, and embedded documents.

## Project

- [Website](https://www.bovnar.io/): The Bovnar homepage and interactive browser playground.
- [Source (GitHub)](https://github.com/sothis/bovnar): The C99 reference implementation, Python bindings, and tooling (MIT-licensed).
- [IANA media type (text/vnd.bovnar)](https://www.iana.org/assignments/media-types/text/vnd.bovnar): The registered media type for .bvnr documents.
- [DOI — Documentation & Specification (1.1.0)](https://zenodo.org/records/21443296): Archived, citable release of the specification and documentation.
- [DOI — Source (1.1.0)](https://zenodo.org/records/21443009): Archived, citable release of the source code.

## Optional

- [Landing page (Markdown)](https://www.bovnar.io/index.md): A clean Markdown rendering of the homepage.
- [Full documentation (single file)](https://www.bovnar.io/llms-full.txt): The entire documentation set concatenated for one-fetch ingestion.