block / block/buzz-app

Add Brazilian Portuguese (pt-BR) localization support

Open
#32 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
TypeScript
Stars
1
Forks
2
Avg merge
7h 5m
Merged PRs (30d)
34

Description

## Motivation

We are evaluating Buzz for adoption by Brazilian teams across desktop, mobile, and the new web experience. Conversations work well in Portuguese, but the English-only application chrome is an adoption barrier for non-technical users.

I would like to contribute Brazilian Portuguese (`pt-BR`) support and help maintain it as the interface evolves.

## Proposed direction

I suggest an incremental, reviewable rollout:

1. Add the localization runtime with English as the source and fallback locale.
2. Detect the system/browser locale, with a persisted language override in Settings.
3. Extract one bounded surface first: navigation, onboarding, Messages, and their accessibility labels.
4. Add a human-reviewed `pt-BR` catalogue with key/interpolation parity tests.
5. Continue surface by surface instead of a repository-wide translation sweep.

The locale should use the BCP 47 tag `pt-BR` and display as `Português (Brasil)`.

## Prior art and coordination

The original `block/buzz` repository already has localization discussion in block/buzz#2929 and overlapping implementation attempts in block/buzz#5087, block/buzz#5152, and block/buzz#4250. I do not want to create another incompatible localization architecture.

Before turning the proposal into a ready-for-review implementation, could the maintainers clarify:

- Is `block/buzz-app` now the preferred target for new desktop/web localization work?
- Is `react-i18next` acceptable here, or would a repository-local message catalogue be preferred?
- Is an incremental first PR covering the main shell and Messages the desired review size?

## Contribution commitment

I am willing to implement the infrastructure, provide the initial Brazilian Portuguese translation, test the complete user journey in Portuguese, and review terminology updates over time.

Contributor guide

Open the contributing guide

Research direction

No files or tests are named. First clarify with maintainers whether buzz-app is the target, which localization architecture is preferred, and whether the proposed shell-and-Messages scope is appropriate; then inspect those surfaces and the existing locale setup. Done means an agreed incremental plan, runtime and fallback behavior, persisted locale selection, and reviewed pt-BR coverage with parity tests.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
frontend, internationalization
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.