🎉 v1.0

Get started

  • Welcome
  • Documentation
  • Pricing
    Soon

Tools

  • I18n MCP
  • CLI
  • CI/CD Integrations
  • Compiler
    Alpha
  • Connect Your Engine

Resources

  • Languages
  • LLM Models
  • Guides

Company

  • Enterprise
  • CareersHiring!
Dashboard

Lingo.dev Compiler

  • How it works
  • Setup

Framework Integration

  • Next.js
  • Vite + React

Configuration

  • Configuration Reference
  • Translation Providers
  • Build Modes

Features

  • Manual Overrides
  • Custom Locale Resolvers
  • Automatic Pluralization
  • Locale Switching

Development

  • Development Tools
  • Project Structure

Guides

  • Best Practices
  • Migration Guide
  • Troubleshooting

Troubleshooting

Max PrilutskiyMax Prilutskiy·Updated 5 days ago·4 min read

Alpha

The Lingo.dev Compiler is in alpha. It is unstable, not recommended for production use, and APIs may change between releases.

Solutions for common issues when using the Lingo.dev Compiler. Each section describes the symptom, cause, and fix.

Installation issues#

Configuration issues#

Translation issues#

Performance issues#

Port conflicts#

Next Steps#

Configuration Reference
Verify your configuration options
Build Modes
Understand translate vs cache-only
Development Tools
Pseudotranslator and translation server
Migration Guide
Migrating from the old package

Was this page helpful?