app.json is an essential file that stores a lot of important information that is used by the Jovo app and the Jovo CLI.
app.json is used by many features of Jovo, for example to build platform specific project files with the Jovo CLI, or to add different stages for more convenient deployment.
Here is a list of all elements that can be added to the
||Alexa Skill project config|
||Google Action project config|
||Includes natural language understanding tools like
||References the location of the source code of the app/
||Overrides app configurations from
||Endpoint for the voice platforms to reach your app. Default: Jovo Webhook.|
||Deployment information (e.g. if hosted on Lambda, but endpoint is API Gateway)|
||Different deployment stages|
||Default stage to use if not defined differently in the environment variables|
For example, the following Jovo CLI commands create the
app.json and add both
googleAction as platform projects:
This is what the resulting
app.json looks like:
As you can see above, an
endpoint is automatically added to the file with your unique Jovo Webhook endpoint. You can also access your webhook url with this:
Alternatively, you can reference values from your
environment variables like so:
These environment variables are usually stored in a
.env file or in your cloud environment, for example AWS Lambda.
With the Jovo CLI, you can create and deploy project files (e.g. language models) that are specific to each voice platform.
The introduction already shows how a freshly created
app.json looks like after initializing both platforms
googleAction. In the following section, you will learn about additional configurations to the voice platform projects.
The following elements can be added to the
In the deployment process with the Jovo CLI (
askProfile are by default taken from the existing
config in the
/platforms/alexaSkill/.ask folder. Specifying those in the
app.json to override the existing platform files is especially useful if you have different versions of the Alexa Skill in separate developer accounts (see Stages).
You can also add information to go into the
skill.json. You can basically add or override any element that you can find in the skill manifest:
To add an object, make sure to add the same path it has in the
skill.json. The below example (from our Alexa Audioplayer Template) adds the Audioplayer Directive to the Alexa Skill:
The deployment communication between the Jovo CLI and the Google Action is going through a Dialogflow agent. This is why project configuration settings are added to a
dialogflow object inside the
Updating a Dialogflow Agent through from the Jovo CLI needs an authentication process with a
keyFile, which can be downloaded and placed in your project directory. For more information, take a look at the example in our Knowledge Base: Deploy a Dialogflow Agent with the Jovo CLI.
Similar to additional elements that go into the
skill.json for the
alexaSkill object, you can also add specific elements to a Dialogflow agent by adding the whole like in the the
agent.json file, like so:
For example, you can add a header to your
webhook like this:
For every platform, an
nlu element is added for additional options regarding natural language understanding tooling. For example:
Right now, the built-in
alexa nlu for Amazon Alexa and
dialogflow for Google Assistant are supported.
For the language model conversion, a
lang object can be added to the
In the above example, the object specifies the following process for the
jovo build command:
You may already know the App Configuration that is done in
app/app.js in the
app.json, you can override some of the configurations made in the Jovo app, by adding the
This is especially helpful if you want to use different configurations for different stages. For example, it is common to add different types of databases to different environments, like in the example below:
app.json, you can also add or override specific elements of your language model in the
models folder. Learn more about the Jovo Language Model here.
Changing the invocation name is especially useful for different stages if you want to make sure you know which version of your voice app you're currently talking to.
For example, you can override the language model for the
en-US locale like thos:
NOTE: Currently, the invocation name can only be specified in the
models folder for Alexa Skills. For Google Actions, you need to change them in the Actions on Google Console.
You can also add whole intents and inputs and any element that you can find in your e.g.
en-US.json in the Jovo
For example, you can add an intent to specific stages like so:
Jovo allows you to define multiple staging environments like
prod in your
The elements inside a stage are merged into the elements outside the stage with the ability to override configurations. You can also add a
defaultStage element (although not necessary):
For an overview of staging examples, take a look at our Knowledge Base: Staging Examples.
A stage is active when one of the following is true (by default, only the elements outside the
stages are used):
Sometimes (for example, if you are using an API Gateway), your
endpoint might differ from the destination where the code is located (the
You can add a
host object to specify where the code is hosted. Right now,
lambda is supported to deploy your code to AWS Lambda. This is how you can set it up:
Note: If you're only building an Alexa Skill, der is no need to specify a host with the same information that is already in the
endpoint. This is mostly important if you also want to host your Google Action on AWS Lambda and make it accessible through an API Gateway.
Any specific questions? Just drop them below. Alternatively, you can also fill out this feedback form. Thank you!