Communitygithub.com

YepAPI/skills

Padrões para next-intl e react-i18next, roteamento com localidade, extração de mensagens, pluralização, RTL e formatação com Intl API.

O que é skills?

Este skill fornece um conjunto de regras, padrões e práticas recomendadas para internacionalização (i18n) em aplicações React, cobrindo Next.js (App Router) com `next-intl` e SPAs React com `react-i18next`. Ele define uma estrutura clara para roteamento com localidade (ex.: `/en/about`, `/fr/about`), organização de arquivos de tradução por namespace e localidade, além de padrões seguros para pluralização (formato ICU), interpolação e formatação de datas, números e moedas usando as APIs nativas `Intl`. O skill também orienta sobre suporte a RTL (direita para esquerda) com propriedades CSS lógicas e boas práticas para carregamento sob demanda de traduções. É ideal para desenvolvedores que desejam implementar i18n de forma consistente e escalável em projetos React, evitando armadilhas comuns como strings hardcoded e concatenação de texto traduzido.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/i18n

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

i18n

Regras

  • Next.js App Router: usar next-intl — hook useTranslations(), NextIntlClientProvider, middleware para detecção de localidade
  • React SPA: usar react-i18next — hook useTranslation(), i18n.init() com i18next-http-backend para carregamento sob demanda
  • Roteamento com localidade: /en/about, /fr/about — usar middleware para detectar o cabeçalho Accept-Language e redirecionar
  • Arquivos de tradução: JSON por localidade por namespace — messages/en/common.json, messages/fr/common.json
  • Divisão por namespace: um namespace por funcionalidade/página — auth.json, dashboard.json, settings.json — carregar apenas o que a página precisa
  • Pluralização: usar formato de mensagem ICU — {count, plural, one {# item} other {# items}}
  • Interpolação: t('greeting', { name }) — nunca concatenar strings traduzidas
  • Data/número/moeda: usar Intl.DateTimeFormat, Intl.NumberFormat — nunca codificar formatos
  • Suporte RTL: usar dir="rtl" no <html>, propriedades CSS lógicas (margin-inline-start em vez de margin-left), testar com árabe/hebraico

Padrões

// next-intl: middleware.ts
import createMiddleware from "next-intl/middleware";
export default createMiddleware({
  locales: ["en", "fr", "de", "ar"],
  defaultLocale: "en",
});

// next-intl: uso no componente
import { useTranslations } from "next-intl";
function ProductCard({ price, date }: { price: number; date: Date }) {
  const t = useTranslations("products");
  const format = useFormatter();
  return (
    <div>
      <h2>{t("title")}</h2>
      <p>{format.number(price, { style: "currency", currency: "USD" })}</p>
      <p>{format.dateTime(date, { dateStyle: "medium" })}</p>
    </div>
  );
}

Evitar

  • Strings visíveis ao usuário codificadas — toda string deve passar por t()
  • Concatenação de strings para texto traduzido — usar interpolação ou formato ICU
  • Carregar todas as localidades de uma vez — carregar sob demanda por localidade e namespace
  • CSS left/right para layout — usar propriedades lógicas para compatibilidade RTL
  • Armazenar localidade apenas no localStorage — usar localidade baseada em URL para SEO e compartilhamento

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Habilidades Relacionadas