# i18n4e: i18n for Express Js ๐จ๐
[](https://badge.fury.io/js/i18n4e)
[](https://www.npmjs.com/package/i18n4e)
i18n4e is a package that offers a modern, quick and easy way to add internationalization support to your Express Js application.
## ๐ Installation
```bash
npm install i18n4e
```
or
```bash
yarn add i18n4e
```
### In the client:
```html
```
or
```html
```
# ๐ Docs
To see the full documentation, please visit the [official documentation](https://i18n4e.vercel.app/docs).
# ๐ Simple Usage In 6 Steps
1. Install the package
```bash
npm install i18n4e
```
2. Import the package
```javascript
const {i18n4e} = require('i18n4e');
```
3. Create a _locales folder in the root of your project and add the locales files
```
project
โโโ node_modules
โโโ package.json
โโโ index.js
โโโ _locales
โโโ en
โ โโโ translation.json
โโโ pt_br
โ โโโ translation.json
โโโ es
โโโ translation.json
```
4. Add variables in the translation.json files for each language
โโโ en/**translation.json**
```json
{
"hello-world": "Hello World!"
}
```
โโโ pt_br/**translation.json**
```json
{
"hello-world": "Olรก Mundo!"
}
```
โโโ es/**translation.json**
```json
{
"hello-world": "Hola Mundo!"
}
```
5. In your view files (example: index.ejs or index.html) add i18nID attributes to the elements you want to translate
```html
Hello World!
```
6. Start i18n4e on your file by passing your app express
```javascript
i18n4e.init(app,{
defaultLang:'en', // define the main language
})
```
Its done! Now your application is ready to be translated into multiple languages.
**For more examples and configurations, please visit the [Examples](https://github.com/luiisp/i18n4e/tree/main/examples/).**
# ๐ญ Philosophy
**i18n4e**, created with โค๏ธ by [Luiisp](https://github.com/luiisp), is a package with the philosophy of demystifying the difficulty of implementing i18n in web applications. At a high level, you can make various complex configurations using only boolean options.
# ๐ฆ Benefits
- Modern syntax written with typescript
- Fast and Scalable Execution
- ES6/ESM and Common Js support
- Easy to use
- Change language by session support
- HTML/EJS support
# ๐ถ๏ธ Examples
We have several ready-made project examples using i18n4e that you can view and use as you wish.
#### [Click to see them ๐](https://github.com/luiisp/i18n4e/tree/main/examples)
# ๐ช Contributing
**We welcome contributions to the i18n4e project!** If you would like to contribute, **please follow these steps:**
1. Fork the repository on GitHub.
2. Clone your forked repository to your local machine.
3. Create a new branch for your changes.
4. Make your desired changes to the codebase.
5. Test your changes to ensure they work as expected.
6. Commit your changes and push them to your forked repository.
7. Submit a pull request to the main i18n4e repository.
Please make sure to follow our [contribution guidelines](CONTRIBUTING.md) and adhere to our [code of conduct](CODE_OF_CONDUCT.md) when contributing.
We appreciate your contributions and look forward to working with you!
# ๐ License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
> inspired by chrome.i18n
> *Created with โค๏ธ by [luiisp](https://github.com/luiisp)*