Commands Reference

Complete reference for all Stringer CLI commands

Core Commands

stringer

The main command that detects your framework and guides you through the conversion process.

stringer
Stringer CLI main interface

The main Stringer CLI UI that shows your current commands, progress hints, and advanced navigation in one place.

What it does:

  • Auto-detects your framework (Vue or Nuxt)
  • Installs required i18n packages automatically
  • Creates framework-specific configuration files
  • Interactive workflow for convert and translate operations

Utility Commands

stringer login

Authenticate with Stringer services. (Running stringer will also automatically log you in)

stringer login

stringer -v

Check your Stringer CLI version.

stringer -v

stringer logout

Log out of Stringer services.

stringer logout

stringer help

Display help information.

stringer help

URL-based i18n Routing

Enable SEO-friendly locale prefixes in your URLs (e.g., /en-us/about, /fr-fr/about).

Quick Setup

  1. Enable URL-based routing during the convert flow, or run:
stringer url-i18n --enable
  1. What happens:
    • Your nuxt.config.ts strategy changes from no_prefix to prefix
    • Internal links are wrapped with localePath() automatically
    • A locale middleware is created for proper redirects

Enabling URL Routing

You can enable URL-based routing during the convert flow, or via the Advanced menu:

  1. Run stringer
  2. Select Advanced
  3. Select Enable URL-based i18n routing

Advanced CLI Menu at a Glance

The Advanced menu is the easiest way to repair routing, prefix links, or adjust URL behavior after the conversion flow.

Advanced CLI menu options

Choose "Advanced" during any stringer run to access repair URL routing, inspect middleware, or clear caches.

If You Have Routing Issues

If pages show 404 errors or infinite redirects after enabling URL-based routing:

  1. Run stringer
  2. Select Advanced
  3. Select Repair URL-based i18n routing

The repair flow fixes:

  • Middleware conflicts causing redirects
  • Incorrect route handling logic
  • i18n configuration issues
  • Missing localePath() wrappers on links

See Nuxt URL-based Routing for detailed setup.

Special Flags

--allow-legal-conversion

By default, Stringer skips files detected as legal documents (terms of service, privacy policies, etc.). To force conversion:

stringer --allow-legal-conversion

--clear-cache

Clear the local file cache and reprocess all files:

stringer --clear-cache

Interactive Mode

Stringer CLI runs in interactive mode by default, providing guided prompts:

stringer
# Auto-detects framework and guides you through conversion and translation

Next Steps

Introduction
Framework Guides