diff --git a/docs/resources/projects/imgs/access-library-values.avif b/docs/resources/projects/imgs/access-library-values.avif new file mode 100644 index 00000000..502f2f7c Binary files /dev/null and b/docs/resources/projects/imgs/access-library-values.avif differ diff --git a/docs/resources/projects/libraries.md b/docs/resources/projects/libraries.md index 23749337..85c7b513 100644 --- a/docs/resources/projects/libraries.md +++ b/docs/resources/projects/libraries.md @@ -234,6 +234,89 @@ You can easily upgrade to newer versions of the libraries as they become availab  +## Library Values + +**Library values** are essentially variables created and used by a library author and intended to have their values set by the library user. These values allow library author to create configurable variables that are useful in different contexts, such as API keys, global settings, or other project-specific configurations. These values allow library users to input specific data required for the library to function properly in their project. + +For example, If someone has built a library that uses OpenAI API, they would define a Library Value for the OpenAI API key. As the user of the library, when you import, you must provide your own API key to ensure the library functions properly. + +By using Library Values, the library author allows users to adapt the library to their own configurations without hardcoding sensitive or project-specific data, like API keys, into the library itself. + +### Create Library Values as Author + +The library author defines the variable name, data type (e.g., string, enum), whether the variable is nullable, and an optional default value. + +To create library values, navigate to **Settings and Integrations > App Settings > Publish as Library > Library Values** section and click **+ Add Value**. + +