> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linguolink.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding Translations

> Add translation keys and values with a scalable naming strategy.

## Key Naming

Use dot notation for predictable structure:

```txt theme={null}
auth.login.title
auth.login.submit
errors.network.timeout
```

## Workflow

1. Add the key
2. Add source language value
3. Add descriptions for translator context
4. Fill target locales

## Validation Rules

* Keep keys lowercase and dot-separated
* Avoid ambiguous names like `text1` or `label2`
* Preserve placeholders such as `{name}` and `{count}`

## Good Example

```txt theme={null}
auth.login.title
auth.login.email_label
auth.login.submit_button
```