mansi.kansara
da64f769da
- Added optional MCP integration settings in project-brief.yaml, allowing for environment-based server configurations. - Introduced conventions for strict package imports to enhance code organization and maintainability. - Updated brief schema to validate new MCP properties and ensure correct usage. - Implemented MCP JSON builder to generate .cursor/mcp.json based on project brief settings. - Enhanced resolver to include MCP configuration in generated files when enabled. This update improves integration capabilities and enforces coding standards across the project.
56 lines
1.8 KiB
Cheetah
56 lines
1.8 KiB
Cheetah
---
|
|
description: "Localization / i18n conventions for {{PROJECT_NAME}}"
|
|
globs: ["lib/l10n/**", "lib/**/*.dart", "test/**/*.dart"]
|
|
alwaysApply: false
|
|
---
|
|
|
|
# Localization Standards — {{PROJECT_NAME}}
|
|
|
|
## Supported locales: {{LOCALES_LIST}}
|
|
|
|
## Setup
|
|
- Use Flutter's built-in `AppLocalizations` (generated from `.arb` files)
|
|
- ARB files: `lib/l10n/app_en.arb`, `lib/l10n/app_fr.arb`, etc.
|
|
- Never hardcode user-facing strings — always use `context.l10n.stringKey`
|
|
|
|
## AppLocalizations access
|
|
```dart
|
|
// In widgets:
|
|
final l10n = AppLocalizations.of(context)!;
|
|
Text(l10n.welcomeMessage) // ✅
|
|
|
|
// Extension for convenience:
|
|
extension LocalizationX on BuildContext {
|
|
AppLocalizations get l10n => AppLocalizations.of(this)!;
|
|
}
|
|
Text(context.l10n.welcomeMessage) // ✅
|
|
```
|
|
|
|
## ARB file format
|
|
```json
|
|
{
|
|
"welcomeMessage": "Welcome back, {name}!",
|
|
"@welcomeMessage": {
|
|
"description": "Shown on home screen after login",
|
|
"placeholders": {
|
|
"name": { "type": "String", "example": "Alice" }
|
|
}
|
|
},
|
|
"itemCount": "{count, plural, =0{No items} =1{1 item} other{{count} items}}",
|
|
"@itemCount": {
|
|
"placeholders": {
|
|
"count": { "type": "int" }
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Rules
|
|
- **NEVER** hardcode user-facing strings as string literals in widget files
|
|
- **Technical keys** (route paths, storage/analytics keys, JSON fields): one shared module (e.g. `lib/core/constants/app_strings.dart`) — no duplicated literals across features
|
|
- All new strings added to ALL locale ARB files simultaneously — broken translations break builds
|
|
- Use ICU message format for plurals and gendered strings
|
|
- Date/time formatting: use `intl` package `DateFormat` — never `date.toString()`
|
|
- Currency: use `NumberFormat.currency(locale: locale)` — never manual formatting
|
|
- RTL support: wrap with `Directionality` where needed; test with Arabic locale
|