How to Set Up i18n in NestJS — with Vietnamese Translations

fadow — Fri, 15 May 2026 09:15:07 +0000

Most i18n tutorials stop at English and Spanish. If you're building for Vietnamese users, you need proper tone marks, natural phrasing, and a setup that doesn't fight you.

Here's how I built a NestJS i18n system that auto-detects Accept-Language and returns error messages in Vietnamese or English.

1. Install nestjs-i18n

npm install nestjs-i18n

2. Create translation files

src/i18n/
├── vi/
│   ├── validation.json
│   └── response.json
└── en/
    ├── validation.json
    └── response.json

vi/validation.json:

{
  "EMAIL_INVALID": "Email không hợp lệ",
  "PASSWORD_MIN_LENGTH": "Mật khẩu phải có ít nhất 6 ký tự",
  "USER_NOT_FOUND": "Không tìm thấy người dùng",
  "EMAIL_EXISTS": "Email đã tồn tại",
  "FORBIDDEN": "Bạn không có quyền truy cập"
}

vi/response.json:

{
  "LOGIN_SUCCESS": "Đăng nhập thành công",
  "REGISTER_SUCCESS": "Đăng ký thành công",
  "LOGOUT_SUCCESS": "Đăng xuất thành công"
}

3. Register I18nModule

// app.module.ts
import { I18nModule, HeaderResolver } from 'nestjs-i18n';
import * as path from 'path';

@Module({
  imports: [
    I18nModule.forRoot({
      fallbackLanguage: 'vi',
      loaderOptions: {
        path: path.join(__dirname, '/i18n/'),
        watch: true,
      },
      resolvers: [new HeaderResolver(['accept-language'])],
    }),
    // ... other imports
  ],
})
export class AppModule {}

4. Use in exception filters

// http-exception.filter.ts
import { I18nContext } from 'nestjs-i18n';

@Catch(HttpException)
export class HttpExceptionFilter implements ExceptionFilter {
  catch(exception: HttpException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const i18n = I18nContext.current();
    const response = ctx.getResponse<Response>();
    const status = exception.getStatus();
    const message = exception.message;

    // Translate if the message is a dot-notation key like "validation.EMAIL_INVALID"
    const translated = i18n?.translate(message) ?? message;

    response.status(status).json({
      statusCode: status,
      message: translated,
      timestamp: new Date().toISOString(),
    });
  }
}

5. Auto-detect language from headers

The Accept-Language header resolver does this automatically. The frontend sends Accept-Language: vi or en — NestJS picks it up. Zero extra code.

Vietnamese-specific gotchas

Tone marks: nest-i18n stores JSON as UTF-8. Vietnamese characters (ắ, ễ, ở) work natively. No special handling needed.
Polite phrasing: Vietnamese error messages should sound respectful. "Vui lòng nhập email" (Please enter email) not "Nhập email" (Enter email).
Placeholders: Use {min} and {max} — they work with nestjs-i18n's interpolation:

  "NAME_LENGTH": "Tên phải có từ {min} đến {max} ký tự"

That's it. Your NestJS API now speaks Vietnamese natively.

If you don't want to set this up from scratch, I built a NestJS Vietnam Starter Kit with i18n, JWT auth, RBAC, Docker, and 36 tests — ready to go.

How I built a NestJS + Next.js starter kit with i18n (vi/en) — and why you should too

fadow — Fri, 15 May 2026 06:12:56 +0000

After setting up the same NestJS backend boilerplate for the Nth time, I realized I was spending 1-2 days just configuring auth, i18n, Docker, Redis, Swagger — before writing a single line of business logic.

So I built two starter kits. Not vibe-coded. Clean code. Tested. Production-ready.

What's inside

🔥 NestJS Vietnam Starter ($8)

JWT auth (access + refresh tokens) + RBAC (admin/user roles)
Bilingual i18n (Vietnamese + English) — auto-detects Accept-Language
MongoDB + Redis + Bull queues
Docker Compose — one command to run everything
Auto-generated Swagger docs
Rate limiting, validation pipes, exception filters
36 tests (unit + e2e) — all green

⚡ Next.js Vietnam Starter ($13)

Next.js 16 App Router + React 19 + Tailwind v4
Dark mode + bilingual i18n
Auth pages (login/register) wired to the NestJS backend
Dashboard, profile page, PayOS payment template
Fully responsive, mobile-first

Tech stack
NestJS TypeScript MongoDB Redis Docker Next.js 16 React 19 Tailwind v4

Why I built this

Most starter kits are English-only. Vietnamese devs building for local markets need i18n from day one, with proper tone marks — not machine-translated garbage. These kits ship with natural Vietnamese translations alongside English.

Also, I got tired of Googling the same setup steps every project.

Try it

No free tier yet. But 7-day no-questions-asked refund if it doesn't save you time.

Built to use. Not to flex.

DEV Community: fadow