Adding a New Language to the Project

This guide will walk you through the steps required to add a new language to the project.

Prerequisites

Before you begin, ensure you have the following:

Access to the project’s source code
Basic understanding of the project’s internationalization setup
The language code for the new language (e.g., fr for French, es for Spanish)

Steps to Add a New Language

Create a New Language File

Navigate to the directory where language files are stored. This is typically a folder named locales or i18n.
```
cd apps/client/locales
```
Create a new file for the language you want to add. For example, to add French, create a file named fr.json.
```
touch /fr/peppermint.json
```
Add Translations

Open the newly created language file and add the necessary translations. Use the existing language files as a reference for the structure.

Copy the contents of the English file and translate it to the new language.
```
{
  "welcome": "Bienvenue",
  "login": "Connexion",
  "logout": "Déconnexion"
}
```
Update Language Configuration

If your project has a configuration file for supported languages (e.g., config.js or i18n.js), add the new language to the list of supported languages.
```
// i18n.js
export const supportedLanguages = ["en", "fr", "es"];
```
Test the New Language

Start your application and switch to the new language to ensure that translations are displayed correctly. This might involve changing a language setting in your application or using a URL parameter.

This requires you to have the application running.
```
yarn install --legacy-peer-deps
cd apps/api && npm run db:migrate
cd ../../
yarn dev --filter=client --filter=api
```
Access the application and switch to French:
```
http://localhost:3000/fr/
```
Update Documentation

If your project includes user documentation, update it to reflect the addition of the new language. This might include updating language selection instructions or adding a note about the new language support.
Commit Your Changes

Once you have verified that the new language is working correctly, commit your changes to the version control system.
```
git add .
git commit -m "Add French language support"
git push origin your-branch-name
```

Additional Resources

Troubleshooting

If you encounter any issues, consider the following:

Ensure that the language file is correctly formatted and contains all necessary translations.
Verify that the language configuration is updated to include the new language.
Check the console for any errors related to missing translations.

Feel free to reach out to the project maintainers if you have any questions or need further assistance. Happy localizing!

Project Setup Guide