Screens

Budibase apps are single-page applications that contain either a single screen or multiple screens.

Adding a screen

When adding a screen, you can either add a blank screen or add an autogenerated screen.

Blank screens

When adding a blank screen, you will be prompted to enter a path for the new screen.
Capital letters and spaces are not allowed, however the modal will conveniently convert these to lowercase and hyphens if needed as you type.

Upon clicking Continue, you will have the option to assign the access role for the screen.
Both the role and path of a screen can be changed at any stage after the screen is created.

Autogenerated screen

An autogenerated screen, is a screen generated from a table's data. Budibase is smart, it can read your data and generate tables and side panels for managing that data. When you add an autogenerated screen, Budibase will add a screen with a single preset Table block.

📘

Prior to v2.2

The original autogenerated screen functionality created multiple linked screens. Newer versions of Budibase are backwards compatible with this method, which can still be built using URL variables.
The advantage of side panels is convenience for the user and developer, as well as better app performance.

Adding autogenerated screens

When you add a List view screen, you will see a list of all of the available tables you have, grouped by datasource:

Click the Confirm button to create a table block screen with the appropriate settings.

This screen with its table and side panels will provide you with full CRUD functionality, allowing your users to create, read, update and delete data.

Home screen

To assign a home screen, tick Set as home screen.

To indicate that it is the home screen, you will see a house icon in the screens panel.

Modal screen

A screen can be opened as a modal from linked Table rows, as well as from the Navigate To action.

Within the target screen you can use the Close Screen Modal Action to close the modal and return you to the original screen.

Access level

Screens are grouped and displayed by the chosen access level. If you have many screens, you can also use the search bar.

The access level can be changed for any screen in the settings panel.
App specific roles will determine if a user has the necessary permissions to see the screen.

Background color

Similar to containers, it is possible to add a background color to your screen.

Video tutorial