---
name: error-to-vi
description: >
  Translate build/runtime/type/deploy errors into plain Vietnamese with a short
  fix hint. Covers common Next.js, TypeScript, Supabase, npm, env, and deploy
  failures. Triggers: "dịch lỗi", "giai thich loi", "error nay la gi",
  "translate error", "loi build nay sua sao".
---

# error-to-vi — Error Translation to Vietnamese

## Purpose

Take raw English error output and return a plain Vietnamese explanation with
a simple fix instruction. Non-dev users see "Bi loi X, lam Y de sua" — not
a stack trace.

## Translation Table

### Next.js Build Errors

| English error | Vietnamese | Fix hint |
|--------------|-----------|----------|
| `Module not found: Can't resolve '...'` | "Khong tim thay module [...]. Co the chua cai dat." | `npm install <ten-package>` |
| `Type error: Type 'X' is not assignable to type 'Y'` | "Loi kieu du lieu: [...] khong phu hop." | "Kiem tra kieu du lieu tai dong loi, sua cho dung kieu." |
| `Error: NEXT_PUBLIC_ env var is missing` | "Thieu bien moi truong [...] trong .env.local" | "Mo .env.local va them bien nay." |
| `SyntaxError: Unexpected token` | "Loi cu phap tai dong [...]. Co the thieu dau ngoac hoac dau phay." | "Kiem tra dong loi, sua dau cu phap." |
| `Build failed because of webpack errors` | "Build bi loi do Webpack. Xem loi cu the ben duoi." | "Doc thong bao loi va sua theo huong dan." |
| `ENOSPC: no space left on device` | "May tinh het dung luong dia." | "Xoa thu muc .next/ va node_modules/, roi chay npm install lai." |

### Supabase Errors

| English error | Vietnamese | Fix hint |
|--------------|-----------|----------|
| `Invalid API key` | "API key Supabase sai hoac het han." | "Kiem tra NEXT_PUBLIC_SUPABASE_ANON_KEY trong .env.local" |
| `relation does not exist` | "Bang du lieu [...] chua duoc tao." | "Chay migration SQL trong Supabase dashboard." |
| `new row violates row-level security policy` | "Khong co quyen ghi vao bang [...] (RLS)." | "Kiem tra policy RLS trong Supabase dashboard." |
| `JWT expired` | "Phien dang nhap het han." | "Dang xuat va dang nhap lai." |
| `Email not confirmed` | "Email chua duoc xac nhan." | "Kiem tra hop thu va bam vao link xac nhan." |

### npm / Node Errors

| English error | Vietnamese | Fix hint |
|--------------|-----------|----------|
| `EACCES: permission denied` | "Khong co quyen truy cap. Khong dung sudo voi npm." | "Chay: `npm config set prefix ~/.npm-global`" |
| `npm ERR! peer dep missing` | "Thieu thu vien phu thuoc." | "Chay: `npm install --legacy-peer-deps`" |
| `Cannot find module 'next'` | "Chua cai Next.js. Chay: `npm install`" | `npm install` |
| `Error: listen EADDRINUSE :::3000` | "Cong 3000 dang duoc su dung boi chuong trinh khac." | "Chay: `npx kill-port 3000` roi thu lai." |

### Vercel Deploy Errors

| English error | Vietnamese | Fix hint |
|--------------|-----------|----------|
| `Build failed` | "Build that bai tren Vercel. Kiem tra logs." | "Vao Vercel dashboard > Deployments > xem logs chi tiet." |
| `Environment variable not found` | "Thieu bien moi truong tren Vercel." | "Vao Project Settings > Environment Variables va them bien." |
| `Function execution timeout` | "Ham chay qua lau (>10 giay)." | "Kiem tra cac API route co ket noi database cham khong." |

## Usage Pattern

When an error is encountered:
1. Match error text against table above (partial match OK)
2. Return: Vietnamese explanation + fix instruction
3. If no match: show generic message: "Co loi xay ra: [nguyen nhan co the]. Thu khoi dong lai voi `npm run dev`."
4. Log original English error to file `taw-error.log` for debugging