---
title: "Catalog API"
description: "Reference the files and IDs that connect application text to published languages."
canonical_url: "https://docs.linguana.dev/docs/reference/catalog"
markdown_url: "https://docs.linguana.dev/docs/reference/catalog.md"
x_farming_labs_generated_preamble: true
---

# Catalog API
URL: /docs/reference/catalog
LLM index: /llms.txt
Description: Reference the files and IDs that connect application text to published languages.

# Catalog API

`@linguanahq/catalog` is the shared contract between compiler, API, translation workflow, and React runtime. Its current `SCHEMA_VERSION` is `1.0`.

## Schemas and types

The package exports Zod schemas and inferred types for message locations, placeholders, message context, manifest messages, diagnostics, manifests, and catalogs.

## Identity and hashing

- `normalizeSource(source)` creates the semantic identity input.
- `parseMessagePlaceholders(source)` parses ICU placeholders.
- `stableMessageId(input)` combines source locale, source, context, and optional explicit ID.
- `contentHash(value)` hashes canonical JSON.
- `manifestHash(manifest)` hashes manifest content.

Formatting-only source changes should preserve normalized identity. Context or explicit ID changes may intentionally create a different message.

## Catalog integrity

`createCatalog(input)` adds integrity evidence to an immutable catalog. `verifyCatalog(catalog)` recomputes and checks it. The runtime additionally verifies requested project, environment, and locale before rendering.

## Compatibility

Keep catalog, compiler, server, and runtime versions aligned. A schema parse or integrity failure is a hard rejection, not a warning that may be ignored.

## See also

[Find text in your app](/docs/getting-started/connect-your-app) · [Show translated content](/docs/build-with-code/show-translated-content)

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).