# Ramoira

> The open schema for what your brand means. Draft it free, publish it free, and give every producer the same page. Ramoira is an open schema format (brand.schema.json) and a free CLI and web app to draft, validate and publish it.

Drafting and publishing are free. Brand schemas are shown as candidates, not ratified. The CLI runs locally; run `npx ramoira init` to start. Published brands have two public, machine-readable endpoints:

- `GET https://ramoira.com/brands/{slug}/schema.summary.json`: Public rules, plus the Identity, Narrative and Voice layers of a published brand schema. Cached. Any agent can fetch it.
- `GET https://ramoira.com/brands/{slug}/status`: Publication state of a brand schema. Facts only, never a score.

## Docs

- [Ramoira integration docs](https://github.com/ramoira/docs): Public integration guides for spec 3.x and the push-and-review flow, written for agents and developers.
- [Ramoira brand schema specification (SPEC.md)](https://github.com/ramoira/brand-schema-spec/blob/main/SPEC.md): The open format specification for brand.schema.json.
- [Ramoira brand schema JSON Schema (SPEC.schema.json)](https://github.com/ramoira/brand-schema-spec/blob/main/SPEC.schema.json): The normative JSON Schema that validates a brand.schema.json file.
- [Ramoira drafting protocol (DRAFTING.md)](https://github.com/ramoira/brand-schema-spec/blob/main/drafting/DRAFTING.md): The plain protocol that npx ramoira init installs so your own coding agent can draft a schema.

## Tools

- [Ramoira CLI on npm](https://www.npmjs.com/package/ramoira): Run it with npx ramoira init. Commands: init, check, validate, push, pull, status.
- [ramoira/cli source](https://github.com/ramoira/cli): The open source CLI. It runs locally and connects to Ramoira only when you push a version for review.
- [ramoira/brand-schema-spec source](https://github.com/ramoira/brand-schema-spec): The specification repository, with worked examples (fictional brands), the reference validator and per-layer documentation.
- [Draft a Ramoira brand schema in your browser](https://ramoira.com/draft): Browser drafting. No account needed.

## Optional

- [Ramoira home page](https://ramoira.com/): overview; send Accept: text/markdown to get it as Markdown
- [Ramoira developer resources page](https://ramoira.com/docs): this index as a web page
- [Measuring Brand Identity (Ramoira whitepaper)](https://ramoira.com/whitepaper/index.html): research on measuring brand identity
- [Ramoira on GitHub](https://github.com/ramoira): all public repositories
- [Sitemap](https://ramoira.com/sitemap.xml): every public page