Skip to content

Conversation

@fabrobles92
Copy link

@fabrobles92 fabrobles92 commented Dec 12, 2025

Description

There is a clerk component I am rendering for the Spanish audience in my app that does not have translation in spanish and shows nothing:

image

Translation of English version:
image

Checklist

  • pnpm test runs as expected.
  • pnpm build runs as expected.
  • [NA] (If applicable) JSDoc comments have been added or updated for any package exports
  • [NA] (If applicable) Documentation has been updated

Type of change

  • 🐛 Bug fix
  • 🌟 New feature
  • 🔨 Breaking change
  • 📖 Refactoring / dependency upgrade / documentation
  • other:

Summary by CodeRabbit

  • Documentation
    • Added/updated Spanish localizations for organization workflows (es-ES, es-MX, es-CR, es-UY): organization selection, creation form labels/placeholders/buttons, titles, subtitles, action labels, and sign-out text.
  • Chores
    • Added a changeset documenting these Spanish localization updates.

✏️ Tip: You can customize this high-level summary in your review settings.

@changeset-bot
Copy link

changeset-bot bot commented Dec 12, 2025

🦋 Changeset detected

Latest commit: e02e511

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 5 packages
Name Type
@clerk/localizations Patch
@clerk/clerk-js Patch
@clerk/ui Patch
@clerk/chrome-extension Patch
@clerk/expo Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@vercel
Copy link

vercel bot commented Dec 12, 2025

@fabrobles92 is attempting to deploy a commit to the Clerk Production Team on Vercel.

A member of the Team first needs to authorize it.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Dec 12, 2025

Walkthrough

Added a changeset and updated Spanish localization files (es-CR, es-ES, es-MX, es-UY) to replace previously undefined keys with concrete translations for taskChooseOrganization (chooseOrganization, createOrganization, signOut) UI strings.

Changes

Cohort / File(s) Summary
Changeset
.changeset/sour-spies-clap.md
New changeset file containing two patch entries (for @clerk/localizations and @clerk/clerk-js) with document separators (---) and the description "Update Spanish localizations for taskChooseOrganization". No functional code added.
Spanish localization updates
packages/localizations/src/es-CR.ts, packages/localizations/src/es-ES.ts, packages/localizations/src/es-MX.ts, packages/localizations/src/es-UY.ts
Populate previously undefined keys under taskChooseOrganization.chooseOrganization, taskChooseOrganization.createOrganization, and taskChooseOrganization.signOut with concrete Spanish strings (action labels, button text, form placeholders, form labels, subtitles, titles, and sign-out text).

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

  • Repetitive, value-only updates across parallel locale files.
  • Review focus:
    • Consistency of accents/typos (e.g., "Cerrar sesión", "Ingresá" vs "Ingrese").
    • Correct usage of interpolation tokens like {{identifier}}.
    • Regional phrasing differences between locales.

Poem

🐰 Salté entre archivos con orejas en acción,
Puse acentos y textos con mucha atención.
"Crear", "Unirse", "Cancelar" en su lugar,
Ahora en español la interfaz puede cantar.
¡Brinco contento por esta localización! 🥕✨

Pre-merge checks and finishing touches

✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly and specifically describes the main change: adding Spanish translations for the taskChooseOrganization component across multiple Spanish locales.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 25c189f and e02e511.

📒 Files selected for processing (1)
  • .changeset/sour-spies-clap.md (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • .changeset/sour-spies-clap.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 9

🧹 Nitpick comments (2)
packages/localizations/src/es-CR.ts (1)

855-860: Align “action__suggestionsAccept” wording with the rest of the file (Pedir vs Solicitar).

This file already uses both “Pedir unirse” (e.g., organizationList.action__suggestionsAccept) and “Solicitar unirse” (e.g., organizationSwitcher.action__suggestionsAccept). Consider standardizing to one term for the same action to avoid UI inconsistency.

packages/localizations/src/es-MX.ts (1)

855-862: Consider aligning “Pedir unirse” wording with existing “Solicitar unirse” to keep Spanish (MX) consistent.
In this same file, organizationSwitcher.action__suggestionsAccept uses “Solicitar unirse”, while this new segment uses “Pedir unirse”. I’d standardize to one.

   taskChooseOrganization: {
     chooseOrganization: {
       action__createOrganization: 'Crear nueva organización',
       action__invitationAccept: 'Unirse',
-      action__suggestionsAccept: 'Pedir unirse',
+      action__suggestionsAccept: 'Solicitar unirse',
       subtitle: 'Unirse a una organización existente o crear una nueva',
       suggestionsAcceptedLabel: 'Pendiente de aprobación',
       title: 'Elegir una organización',
     },
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 1eaef8e and 5ba4fca.

📒 Files selected for processing (5)
  • .changeset/sour-spies-clap.md (1 hunks)
  • packages/localizations/src/es-CR.ts (1 hunks)
  • packages/localizations/src/es-ES.ts (1 hunks)
  • packages/localizations/src/es-MX.ts (1 hunks)
  • packages/localizations/src/es-UY.ts (1 hunks)
🧰 Additional context used
📓 Path-based instructions (10)
**/*.{js,jsx,ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

All code must pass ESLint checks with the project's configuration

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
**/*.{js,jsx,ts,tsx,json,md,yml,yaml}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

Use Prettier for consistent code formatting

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
packages/**/src/**/*.{ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

TypeScript is required for all packages

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
**/*.{ts,tsx,js,jsx}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

Follow established naming conventions (PascalCase for components, camelCase for variables)

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
packages/**/src/**/*.{ts,tsx,js,jsx}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

packages/**/src/**/*.{ts,tsx,js,jsx}: Maintain comprehensive JSDoc comments for public APIs
Use tree-shaking friendly exports
Validate all inputs and sanitize outputs
All public APIs must be documented with JSDoc
Use dynamic imports for optional features
Provide meaningful error messages to developers
Include error recovery suggestions where applicable
Log errors appropriately for debugging
Lazy load components and features when possible
Implement proper caching strategies
Use efficient data structures and algorithms
Implement proper logging with different levels

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
**/*.ts?(x)

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

Use proper TypeScript error types

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
**/*.{ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/typescript.mdc)

**/*.{ts,tsx}: Always define explicit return types for functions, especially public APIs
Use proper type annotations for variables and parameters where inference isn't clear
Avoid any type - prefer unknown when type is uncertain, then narrow with type guards
Implement type guards for unknown types using the pattern function isType(value: unknown): value is Type
Use interface for object shapes that might be extended
Use type for unions, primitives, and computed types
Prefer readonly properties for immutable data structures
Use private for internal implementation details in classes
Use protected for inheritance hierarchies
Use public explicitly for clarity in public APIs
Use mixins for shared behavior across unrelated classes in TypeScript
Use generic constraints with bounded type parameters like <T extends { id: string }>
Use utility types like Omit, Partial, and Pick for data transformation instead of manual type construction
Use discriminated unions instead of boolean flags for state management and API responses
Use mapped types for transforming object types
Use conditional types for type-level logic
Leverage template literal types for string manipulation at the type level
Use ES6 imports/exports consistently
Use default exports sparingly, prefer named exports
Document functions with JSDoc comments including @param, @returns, @throws, and @example tags
Create custom error classes that extend Error for specific error types
Use the Result pattern for error handling instead of throwing exceptions
Use optional chaining (?.) and nullish coalescing (??) operators for safe property access
Let TypeScript infer obvious types to reduce verbosity
Use const assertions with as const for literal types
Use satisfies operator for type checking without widening types
Declare readonly arrays and objects for immutable data structures
Use spread operator and array spread for immutable updates instead of mutations
Use lazy loading for large types...

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
**/*.{js,ts,jsx,tsx}

📄 CodeRabbit inference engine (.cursor/rules/monorepo.mdc)

Use ESLint with custom configurations tailored for different package types

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
**/*.{js,ts,jsx,tsx,json,md,yml,yaml}

📄 CodeRabbit inference engine (.cursor/rules/monorepo.mdc)

Use Prettier for code formatting across all packages

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
packages/localizations/**/*

📄 CodeRabbit inference engine (.cursor/rules/monorepo.mdc)

Organize localization translations in packages/localizations/ with support for 30+ languages and RTL language support

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
🧠 Learnings (1)
📚 Learning: 2025-12-12T19:54:17.554Z
Learnt from: wobsoriano
Repo: clerk/javascript PR: 7447
File: packages/localizations/src/en-US.ts:904-905
Timestamp: 2025-12-12T19:54:17.554Z
Learning: In Clerk's JavaScript localization files (packages/localizations/src/*.ts), undefined values for localization keys are intentional and should not be flagged as issues. When a key is undefined, the system uses the default message from the API response as a fallback. Do not flag these as errors; preserve this expected behavior.

Applied to files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-MX.ts
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-UY.ts
🔇 Additional comments (2)
packages/localizations/src/es-UY.ts (1)

855-860: LGTM!

The translations for the organization selection flow are correct and appropriate for Uruguayan Spanish.

packages/localizations/src/es-ES.ts (1)

857-864: LGTM!

The translations in this section are accurate, natural, and consistent with the rest of the file.

@wobsoriano wobsoriano changed the base branch from main to release/core-2 December 12, 2025 21:21
@wobsoriano wobsoriano changed the base branch from release/core-2 to main December 12, 2025 21:21
@jigar-clerk jigar-clerk self-requested a review December 15, 2025 15:45
Co-authored-by: coderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
@pkg-pr-new
Copy link

pkg-pr-new bot commented Dec 15, 2025

Open in StackBlitz

@clerk/agent-toolkit

npm i https://pkg.pr.new/@clerk/agent-toolkit@7449

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@7449

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@7449

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@7449

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@7449

@clerk/dev-cli

npm i https://pkg.pr.new/@clerk/dev-cli@7449

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@7449

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@7449

@clerk/express

npm i https://pkg.pr.new/@clerk/express@7449

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@7449

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@7449

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@7449

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@7449

@clerk/react

npm i https://pkg.pr.new/@clerk/react@7449

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@7449

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@7449

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@7449

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@7449

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@7449

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@7449

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@7449

commit: e02e511

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between abeac27 and c340065.

📒 Files selected for processing (5)
  • .changeset/sour-spies-clap.md (1 hunks)
  • packages/localizations/src/es-CR.ts (1 hunks)
  • packages/localizations/src/es-ES.ts (1 hunks)
  • packages/localizations/src/es-MX.ts (1 hunks)
  • packages/localizations/src/es-UY.ts (1 hunks)
✅ Files skipped from review due to trivial changes (1)
  • .changeset/sour-spies-clap.md
🚧 Files skipped from review as they are similar to previous changes (2)
  • packages/localizations/src/es-CR.ts
  • packages/localizations/src/es-MX.ts
🧰 Additional context used
📓 Path-based instructions (10)
**/*.{js,jsx,ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

All code must pass ESLint checks with the project's configuration

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
**/*.{js,jsx,ts,tsx,json,md,yml,yaml}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

Use Prettier for consistent code formatting

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
packages/**/src/**/*.{ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

TypeScript is required for all packages

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
**/*.{ts,tsx,js,jsx}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

Follow established naming conventions (PascalCase for components, camelCase for variables)

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
packages/**/src/**/*.{ts,tsx,js,jsx}

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

packages/**/src/**/*.{ts,tsx,js,jsx}: Maintain comprehensive JSDoc comments for public APIs
Use tree-shaking friendly exports
Validate all inputs and sanitize outputs
All public APIs must be documented with JSDoc
Use dynamic imports for optional features
Provide meaningful error messages to developers
Include error recovery suggestions where applicable
Log errors appropriately for debugging
Lazy load components and features when possible
Implement proper caching strategies
Use efficient data structures and algorithms
Implement proper logging with different levels

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
**/*.ts?(x)

📄 CodeRabbit inference engine (.cursor/rules/development.mdc)

Use proper TypeScript error types

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
**/*.{ts,tsx}

📄 CodeRabbit inference engine (.cursor/rules/typescript.mdc)

**/*.{ts,tsx}: Always define explicit return types for functions, especially public APIs
Use proper type annotations for variables and parameters where inference isn't clear
Avoid any type - prefer unknown when type is uncertain, then narrow with type guards
Implement type guards for unknown types using the pattern function isType(value: unknown): value is Type
Use interface for object shapes that might be extended
Use type for unions, primitives, and computed types
Prefer readonly properties for immutable data structures
Use private for internal implementation details in classes
Use protected for inheritance hierarchies
Use public explicitly for clarity in public APIs
Use mixins for shared behavior across unrelated classes in TypeScript
Use generic constraints with bounded type parameters like <T extends { id: string }>
Use utility types like Omit, Partial, and Pick for data transformation instead of manual type construction
Use discriminated unions instead of boolean flags for state management and API responses
Use mapped types for transforming object types
Use conditional types for type-level logic
Leverage template literal types for string manipulation at the type level
Use ES6 imports/exports consistently
Use default exports sparingly, prefer named exports
Document functions with JSDoc comments including @param, @returns, @throws, and @example tags
Create custom error classes that extend Error for specific error types
Use the Result pattern for error handling instead of throwing exceptions
Use optional chaining (?.) and nullish coalescing (??) operators for safe property access
Let TypeScript infer obvious types to reduce verbosity
Use const assertions with as const for literal types
Use satisfies operator for type checking without widening types
Declare readonly arrays and objects for immutable data structures
Use spread operator and array spread for immutable updates instead of mutations
Use lazy loading for large types...

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
**/*.{js,ts,jsx,tsx}

📄 CodeRabbit inference engine (.cursor/rules/monorepo.mdc)

Use ESLint with custom configurations tailored for different package types

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
**/*.{js,ts,jsx,tsx,json,md,yml,yaml}

📄 CodeRabbit inference engine (.cursor/rules/monorepo.mdc)

Use Prettier for code formatting across all packages

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
packages/localizations/**/*

📄 CodeRabbit inference engine (.cursor/rules/monorepo.mdc)

Organize localization translations in packages/localizations/ with support for 30+ languages and RTL language support

Files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
🧠 Learnings (1)
📚 Learning: 2025-12-12T19:54:17.554Z
Learnt from: wobsoriano
Repo: clerk/javascript PR: 7447
File: packages/localizations/src/en-US.ts:904-905
Timestamp: 2025-12-12T19:54:17.554Z
Learning: In Clerk's JavaScript localization files (packages/localizations/src/*.ts), undefined values for localization keys are intentional and should not be flagged as issues. When a key is undefined, the system uses the default message from the API response as a fallback. Do not flag these as errors; preserve this expected behavior.

Applied to files:

  • packages/localizations/src/es-ES.ts
  • packages/localizations/src/es-UY.ts
🔇 Additional comments (3)
packages/localizations/src/es-ES.ts (1)

847-870: LGTM! Translations are accurate and consistent.

The Spanish translations for taskChooseOrganization are well done:

  • Proper use of formal "usted" register appropriate for es-ES (Spain)
  • Correct spelling with accents ("sesión")
  • Locale-appropriate terminology ("Sesión iniciada como" instead of Latin American "Logueado como")
  • Consistent with similar translations elsewhere in the file
packages/localizations/src/es-UY.ts (2)

855-856: LGTM! Translations are accurate.

The chooseOrganization translations are well done and consistent with Uruguayan Spanish conventions.

Also applies to: 858-860


863-874: LGTM! Proper Uruguayan Spanish conventions followed.

The createOrganization and signOut translations correctly use:

  • Informal "vos" register (Ingresá, tu) appropriate for es-UY
  • Correct spelling with accents (sesión)
  • Latin American terminology (Logueado como) suitable for Uruguay

@jigar-clerk jigar-clerk changed the title Add translations in Spanish for taskChooseOrganization json Object feat(clerk-js,localizations): Add translations in Spanish for taskChooseOrganization json Object Dec 15, 2025
@vercel
Copy link

vercel bot commented Dec 15, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
clerk-js-sandbox Ready Ready Preview, Comment Dec 15, 2025 4:47pm

@jigar-clerk
Copy link
Contributor

Closing this in favor of: #7468

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants