# Build Logs

Depending on the size and complexity of an application you are developing, you may require access to the build logs and output that occurs during a deploy (e.g. when pressing CTRL/CMD+S). Build logs allow you to see how your code is being compiled and further allow you to debug an application which fails to deploy.

## Real-time output

OXIDE has the ability to automatically bring up build logs when you perform deploy operations. When this is enabled, OXIDE will intelligently place the panel in a floating panel contained within a collapsed tray allowing you to follow along with a build while not disrupting your workspace. It will look like this:

![](https://2865107717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9TCHLR67eLHBOjPvHhud%2Fuploads%2Fgit-blob-d4e76a8a7619f782932f61175320fa23e8735782%2Foxide-build-logs-live-builds.png?alt=media)

### Show output when a build fails

To enable this feature, search for the setting below and make sure it is enabled:

![](https://2865107717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9TCHLR67eLHBOjPvHhud%2Fuploads%2Fgit-blob-52d541ea3b0d1c9e9becace6e516e8559fbf2831%2Foxide-build-logs-cmd-fails.png?alt=media)

As per the setting, this will only show the output when one or more build operation for a deploy action fails.

### Show output when a build starts

To enable this feature, search for the setting below and make sure it is enabled:

![](https://2865107717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9TCHLR67eLHBOjPvHhud%2Fuploads%2Fgit-blob-ca84026f70d561010e78e27b21276ee6cfc187c5%2Foxide-build-logs-cmd-starts.png?alt=media)

Both settings are also available in the `Settings` panel under the `Editing` category:

![](https://2865107717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9TCHLR67eLHBOjPvHhud%2Fuploads%2Fgit-blob-4e80366edf0eb619a559c5f93844d7ebfad4ff45%2Foxide-build-logs-settings.png?alt=media)

## Historic builds

To access the build logs for deploys which happened in the past, do the following:

1. Navigate to the relevant deploy event in the Deploy logs:

![](https://2865107717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9TCHLR67eLHBOjPvHhud%2Fuploads%2Fgit-blob-a925d9ea3b9b3f45bf6a1747f11228b17a8369e6%2Foxide-build-entry.png?alt=media)

2\. Expand the deployment operations information:

![](https://2865107717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9TCHLR67eLHBOjPvHhud%2Fuploads%2Fgit-blob-915a9a49d6e439aa19f1a95c05dc5f5a14895b0c%2Foxide-build-operation-pills.png?alt=media)

3\. Click on one of the build operation 'pills' to see more information:

![](https://2865107717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9TCHLR67eLHBOjPvHhud%2Fuploads%2Fgit-blob-b36c0c61de97f5c61537f65bf509d067c9766128%2Foxide-build-logs-output.png?alt=media)

This will bring up a panel that shows the verbose output for each build operation step.

## Deep integration with error lines

If an error occurs and a stack-trace is present, OXIDE will (in most circumstances) include a deep link to the source of the error.

![](https://2865107717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9TCHLR67eLHBOjPvHhud%2Fuploads%2Fgit-blob-c32e7c0542f46c5456394a85809db2dd9e3a43de%2Foxide-build-logs-deep-linking.png?alt=media)

This not only works for core application code, but also works for 'App packages' and 'App libraries' (TS apps).

![](https://2865107717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9TCHLR67eLHBOjPvHhud%2Fuploads%2Fgit-blob-641e935695d14f69b720068a1d49c48d26ce0ca9%2Foxide-build-logs-code-error.png?alt=media)

## Unit testing

If you are making use of unit testing inside [App packages](https://docs.journeyapps.com/reference/build/extending-your-app-with-custom-code/app-packages/app-packages-overview), you can view the test reports. OXIDE respects ANSI color output and also has support for emojis. This results in expressive and rich-formatted report output:

![](https://2865107717-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9TCHLR67eLHBOjPvHhud%2Fuploads%2Fgit-blob-58a01d8d340fc8972cae36593551ff267bff829a%2Foxide-build-logs-unit-tests.png?alt=media)