# Introduction

The `cbi18n` module will enhance your ColdBox applications with i18n capabilities, resource bundles and localization.

### Some Features

* Switching locales on the fly, stored in cookies, sessions or any other `cbstorages` provider
* Resource bundles: java properties files or JSON (nested or flat)
* Inherited resource bundles e.g   `main.properties`, `main_en.properties` or`main_en_US.properties`.
* Many locale specific functions:  date and time formats and parsing, country codes,  currency symbols
* Custom resource services

## Versioning

The ColdBox `cbi18n` Module is maintained under the [Semantic Versioning](http://semver.org) guidelines as much as possible.Releases will be numbered with the following format:

```
<major>.<minor>.<patch>
```

And constructed with the following guidelines:

* Breaking backward compatibility bumps the major (and resets the minor and patch)
* New additions without breaking backward compatibility bumps the minor (and resets the patch)
* Bug fixes and misc changes bumps the patch

## License

Apache License, Version 2.0.

## Important links

* Documentation: <https://coldbox-i18n.ortusbooks.com/>
* Source: <https://github.com/coldbox-modules/cbi18n>
* ForgeBox: <https://forgebox.io/view/cbi18n>

## System requirements

* Lucee 5+
* Adobe ColdFusion 2016+

### Discussion & Help

&#x20;The Box products  community for further discussion and help can be found here:

<https://community.ortussolutions.com/c/box-modules/cbi18n>

## Professional Open Source

![Ortus Solutions, Corp](https://2666107344-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LA-UVv1j7Lki-1Yt4mB%2F-LWqQCz-01xCyvmd31VP%2F-LWqQ_HEyQG2-R5NMRPM%2Fortus%20solutions%20logo.png?alt=media\&token=d1a381f0-260c-4d6e-b675-64bfb5198630)

The ColdBox `cbi18n` Module is a professional open source software backed by [Ortus Solutions, Corp](http://www.ortussolutions.com/services) offering services like:

* Custom Development
* Professional Support & Mentoring
* Training
* Server Tuning
* Security Hardening
* Code Reviews
* [Much More](http://www.ortussolutions.com/services)

### HONOR GOES TO GOD ABOVE ALL

Because of His grace, this project exists. If you don't like this, then don't read it, it's not for you.

> "Therefore being justified by **faith**, we have peace with God through our Lord Jesus Christ: By whom also we have access by **faith** into this **grace** wherein we stand, and rejoice in hope of the glory of God." Romans 5:5