# Application Localization: Locale Coverage Matrix

Coverage grid crossing string namespaces with target locales, percent cells with banded square indicators, a totals row, and a legend.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/locale-coverage-matrix
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Localization](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization)
- Created: 2026-07-02
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/locale-coverage-matrix.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-localization-locale-coverage-matrix
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, radix-ui
- shadcn/ui components: button
- Installs to: `@/components/blocks/application-pro/localization/locale-coverage-matrix`

## About this block

Locale Coverage Matrix crosses 7 string namespaces with
5 target locales, 480 strings in total. Every cell shows
the percent translated beside a small square that
darkens as coverage climbs: solid at 100%, faded through
the 80 and 50 bands, and outlined when an area needs
work, like Korean emails at 22%. Namespace rows carry
their string counts, nav at 42 up to settings at 120,
and the All namespaces row totals each locale, Spanish
at 99% down to Korean at 47%. A legend under the panel
decodes the four bands and the header offers an Export
coverage button.

Locales are typed with a LocaleCode union and every
namespace carries a full Record of coverage values, so a
missing cell is a type error rather than a blank. All
percents use tabular-nums and the grid scrolls
horizontally on small screens instead of wrapping.

## When to use

Reach for this block on the localization dashboard when
per language bars are not enough and the team needs to
see which area of the product drags each locale down.
Wire the cells to your translation store grouped by
namespace prefix and keep the band thresholds in one
function so the legend never drifts from the cells.

A natural flow around it on an Application Pro page:

**Before**

- [Translation progress card](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization)
- [Settings shell](https://www.shadcn-ui-blocks.com/blocks/application-pro/app-shells)

**After**

- [Translation table](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization)
- [String editor panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization)

## What you can display

One strong use is the namespace by locale coverage grid.
Other matrix configurations:

- **Feature areas as rows.** Swap namespaces for product
  areas so each owner sees their own surface per locale.
- **Release gate view.** Only the locales in the next
  release train, with the gate percent marked per cell.
- **Reviewed versus translated.** Two numbers per cell
  when approval lags behind raw translation volume.

> Tip: the outlined band is the call to action, sort the
> translator queue by the lightest cells and the matrix
> fills itself in.

## More in Application Localization

- [Format Settings](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/format-settings)
- [Glossary Manager](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/glossary-manager)
- [Language Switcher Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/language-switcher-blueprint)
- [Locale Fallback Chain](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/locale-fallback-chain)
- [Locale Preview Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/locale-preview-card)
- [Pseudo Locale Tester](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/pseudo-locale-tester)
- [RTL Preview Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/rtl-preview-panel)
- [String Editor Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/string-editor-panel)
- [Translation Progress Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/translation-progress-card)
- [Translation Table](https://www.shadcn-ui-blocks.com/blocks/application-pro/localization/translation-table)
