# OWLF

> Open Wellbeing Log Format: an open file format for mood and wellbeing data.

## Docs

- [OWLF](/): Open Wellbeing Log Format. One open file for mood and wellbeing data, readable by any app.

## The format

- [Document](/format/document): The top-level object of a .owlf.json file.
- [Scales](/format/scales): How OWLF keeps each app's own mood and sleep steps.
- [Entries](/format/entries): One mood check-in or journal entry, with everything the app stored.
- [Dates and time](/format/dates-and-time): Why every entry sits on the local day the person saw, and how OWLF flags guesses.

## For adapter authors

- [Build an adapter](/adapter-authors): Turn one app's export into an OWLF document, as an npm package.
- [Conformance](/adapter-authors/conformance): The check every adapter passes before it ships.
- [Supported apps](/adapter-authors/supported-apps): Apps with an OWLF adapter, each tested with a real export.

## For app developers

- [Read and write OWLF](/app-developers): Validate OWLF files and convert app exports in the browser, in React Native or in Node.
- [Exporters](/app-developers/exporters): Turn an OWLF document into CSV, Excel or a printable PDF, and back.
- [Pixy import](/app-developers/pixy): Turn an OWLF document into a Pixy Mood Tracker import file.

## Reference

- [Specification](/reference/specification): The normative text of OWLF 0.1. Generated from spec/SPEC.md.
- [JSON Schema](/reference/json-schema): The machine-readable schema of an OWLF document.
- [Versioning](/reference/versioning): How OWLF versions change and what readers must do.

## Agent resources

- [llms-full.txt](/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at /openapi.json.
- [API catalog](/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [agent-readability.json](/agent-readability.json): Manifest of every agent-facing artifact on this site.