# Loccy

> Open-source i18n devtooling for React and Vue: inline translation previews, AI extraction and translation in VS Code, and a CLI linter for CI/CD.

Loccy is two tools sharing one `loccy.yaml` config: a VS Code extension (inline translation previews, in-place editing, usage navigation, key renaming, and AI extraction and translation) and `@loccy-dev/lint`, an offline CLI linter that catches unused keys, missing translations, and unsorted locale files in CI. It supports React and Vue i18n libraries. The extension's core features and the linter are free and open source; AI features need a Pro subscription.

## Docs

- [Overview](https://loccy.dev/docs): Loccy documentation: open-source i18n devtooling for React & Vue web apps.
- [Extension](https://loccy.dev/docs/extension): The Loccy VS Code extension: preview, edit, extract, and translate i18n strings inline.
- [Installation](https://loccy.dev/docs/extension/installation): Install the Loccy IDE extension and sign in for AI features.
- [Core features](https://loccy.dev/docs/extension/core-features): The free, local features of the Loccy IDE extension: previews, in-place editing, usage maps, renaming, and more.
- [AI features](https://loccy.dev/docs/extension/ai-features): AI-powered extraction, translation, and copywriting workflows in the Loccy IDE extension.
- [Troubleshooting](https://loccy.dev/docs/extension/troubleshooting): Fix the two most common Loccy display issues (no inline previews and missing-translation warnings) and the non-standard setups behind them.
- [Get started](https://loccy.dev/docs/linter): Install the Loccy linter and set up loccy.yaml — free, offline, for React & Vue.
- [Command reference](https://loccy.dev/docs/linter/commands): Reference for the Loccy linter: init, lint, and format.
- [Config](https://loccy.dev/docs/config): Reference for loccy.yaml: modules, keys, types, defaults, and translation layout.
- [Styleguide](https://loccy.dev/docs/config/styleguide): The styleguide section of loccy.yaml: product, voice, mechanics, per-locale rules, glossary, do-not-translate terms, and key naming.

## Optional

- [Full documentation as one file](https://loccy.dev/llms-full.txt): Every docs page concatenated as markdown
- [Homepage](https://loccy.dev/): Product overview, feature walkthrough, and pricing
- [Config JSON schema](https://loccy.dev/schemas/config.schema.json): Machine-readable schema for `loccy.yaml`
- [GitHub](https://github.com/loccy-dev/monorepo): Source for the extension, the linter, and the shared packages
- [npm](https://www.npmjs.com/@loccy-dev/lint): The `@loccy-dev/lint` linter package
- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=loccy.loccy): Install the extension in VS Code
- [Open VSX](https://open-vsx.org/extension/loccy/loccy): Install the extension in Cursor, Windsurf, and other VS Code forks
- [Discord](https://discord.gg/btztGrejXU): Community and support