Skip to main content
Screens are the backbone of your app, defining its structure and user interface. Each new screen becomes an opportunity to design unique user interfaces and interactions, tailoring your app to your specific needs.

Step 1: Add a screen

When you create a new application, a starting point is already set: the first screen is generated automatically. The screens of your app appear as tabs at the top of the editor. To add another screen, click New Screen (the + button) next to the last tab. Engini - New Screen button The new screen opens in the editor with the name “New screen”. It is not connected to a table yet, so the canvas asks you to connect a Base Table before you can configure its views. Engini - A new screen Click Save at the top right of the editor to save the screen together with the rest of your changes.

Step 2: Manage screens

Use the three-dot menu next to a screen name to manage that screen. Engini - Screen three-dot menu The menu opens with three actions. Engini - Screen menu
  1. Move to - Moves the screen to another app. Open the list and choose the destination app. You can also tick Navigate to selected App to go to that app right away.
  2. Duplicate - Creates a copy of the screen in the same app.
  • Delete - Deletes the screen.

Duplicate a screen

Select Duplicate. A copy named “Copy of” followed by the original name is added as a new tab, and a “Screen duplicated” message appears. Engini - Duplicated screen

Delete a screen

Select Delete. Engini asks you to confirm the deletion. Click Delete to remove the screen, or Cancel to keep it. Engini - Delete screen confirmation

Refresh a screen

The Refresh button in the header of the screen preview reloads the records of the screen, so that recent changes are reflected. It appears once a Base Table is connected to the screen. Engini - Refresh button

Step 3: Adjust the screen

The properties panel is located on the right side of the editor. Through it you configure the selected screen, its business rules and its sub screens. It has three tabs. Engini - Properties panel tabs
  1. Screen Properties - The general settings and behavior of the screen.
  2. Business Rules - The automations of the screen.
  3. Sub Screens - The screens that are connected inside this screen.
How the records of the screen look in the app is configured separately, with the Edit View button (see Step 4).

Screen Properties

The first tab holds the settings of the screen itself. Engini - Screen Properties
  1. Name - The name of the screen. It is shown in the screen tab and to the users of the app.
  2. Screen Color - Pick the color of the screen.
  3. Description - A short description of the screen’s purpose, to help you organize your screens.
  4. Connect Base Table - Pick the table that provides the data of the screen. Your app reads its records directly from the table, and the table’s fields become available in the Fields section.
  5. Fields - The fields of the screen. Click it to expand the list.
  6. Direction Align - The layout direction of the screen: Left or Right.

Fields

After you connect a Base Table, the Fields section lists the table’s fields. For fields that have settings, the settings appear under the field name. Engini - Fields section To add a field to the table from the screen, scroll down to the end of the Fields list and click Add Field. Engini - Add Field button The list of field types opens. Engini - Field types The available types are Status, Labels, Text, Date, Collaborators, Number, Checkbox, URL, Files, Button and Dropdown. Choose a type to add the field, then set its name and settings. For more information about the field types, see the Tables guides. The trash icon next to a field deletes the field from the table, together with its data. Engini asks you to confirm first. The following types have settings of their own. The other types show only their name. Text fields have the following settings. Engini - Text field settings
  1. Field Name - The name that identifies the field on the screen.
  2. Default Value - A value that is filled in automatically.
  3. Text direction - Left, Default or Right.
  4. Is Barcode - Tick it to use the field for barcode input or scanning.
Date fields have three settings. Engini - Date field settings
  1. Default Value - The date that is filled in automatically.
  2. Format - How the date is displayed.
  3. Date type - Date, Date & Time or Time.
Number fields have three settings. Engini - Number field settings
  1. Default Value - The number that is filled in automatically.
  2. Format - How the number is displayed.
  3. Is Barcode - Tick it to use the field for barcode input or scanning.
Button fields trigger business rules when the user clicks them. Engini - Button field settings
  1. Display Title - The text shown on the button.
  2. Color - The color of the button.

Screen toggles

Below Direction Align there is a list of switches. Each one turns a behavior of the screen on or off. Engini - Screen toggles
  1. Accessible from Main Screen - The screen is shown on the Screens page and in the Screens menu.
  2. Enable Exit Screen - Displays a Back button on the screen.
  3. Enable Record Navigation - A navigation panel appears on the Detailed view, to move between records.
  4. Display Records on Screen Entry - Populates the screen with its records when the user opens it.
  5. Enable Comments - Shows the comments badge on each record.
  6. Enable Files Gallery - Shows the record’s files behind a paperclip, so app users can open, add and download them. See Files Gallery.
  7. Enable Record Activity - Shows the record’s change history, the same Activity that the table’s record drawer carries.
  8. Can Add Record - Users can add new records from this screen.
  9. Can Edit Record - Users can edit existing records from this screen.
  10. Can Delete Record - Users can delete records from this screen.
  11. Can Filter - Enables filtering on the Preview. You choose which fields can be filtered in the Edit View window (see Step 4).
  12. Can Scan Barcode - Enables barcode scanning on the screen. Extra settings appear below it.
Two of the switches add a read-only option under them once they are on. Engini - Read-only options for comments and files
  1. Comments are Read-Only - Users can read the comments but not add or change them.
  2. Files are Read-Only - Users can preview and download the files but not add or delete them. See Files Gallery.
The Files Gallery gives app users one place to see and manage the files of a record, without leaving the app. You turn it on per screen.
Turn on the Files Gallery
  1. Select the screen and open Screen Properties.
  2. Switch on Enable Files Gallery. The preview in the editor updates right away.
  3. Click Save.
Engini - Turn on the Files Gallery Optional: switch on Files are Read-Only to let users view files but not change them (see Files are Read-Only).
What app users see
Once the gallery is on, each record shows a paperclip with its number of files:
  • Records list - on every record card.
  • Detailed view - in the bar at the bottom of the record. The bar is not shown while a new record is being added.
The user clicks the paperclip to open the gallery. Engini - Paperclip in the running app The gallery opens as a side panel on desktop and as a panel that slides up from the bottom on mobile. If Comments or Record Activity are on, they appear as tabs next to Files. Each file shows its name, type, size and where it is stored. Engini - Files Gallery open on a record The list and the paperclip count include:
  • Files uploaded to the Files Gallery.
  • Files in the record’s File fields.
  • Files attached to the record’s comments.
What app users can do
  • Preview - Click a file to open it in the viewer.
  • Download - Click the download icon next to a file.
  • Add files - Click Add file, or the upload icon beside the paperclip, and choose one or more files. You can also drag files onto the panel.
  • Delete - Click the trash icon next to a file. A file that came from a File field is removed from that field too.
Files are Read-Only
The Files are Read-Only switch appears only while Enable Files Gallery is on. It is off each time you turn the gallery on. Engini - Files Gallery with Files are Read-Only on
Good to know
  • The screen needs a Base Table.
  • You don’t need a File field in the table. The gallery is created the first time a user uploads a file.
  • Uploads follow the file types your account allows. A file of another type is not uploaded.

Barcode settings

When Can Scan Barcode is on, two more settings appear. Engini - Barcode settings
  1. Text Direction - The direction of the barcode text: Left, Default or Right.
  2. Autocomplete - Turn it on to let Engini fill in related values based on the scanned barcode. A Barcode search definition section opens.
Engini - Barcode search definition
  1. Search in Table - The table that is searched for the scanned value.
  2. Return Field - The field whose value is returned. It becomes available after you choose a table.
  3. Search In Field - The fields that are searched. Click Add Field to add a field, and repeat to add more.

Step 4: Edit the view

The Edit View button above the screen preview opens the window where you design how the records of the screen look. It is available once a Base Table is connected to the screen. Engini - Edit View button The device menu next to it switches the preview in the editor between Mobile and Desktop. Engini - Preview device button Choose the device you want to see. Engini - Preview device options The Edit view window opens as a dialog over the editor. Engini - Edit view window The window shows the screen name and its base table at the top. Below it:
  • The fields list on the left controls which fields are shown and how.
  • The canvas on the right shows the layout, and you place the fields on it by dragging.
  • A hint line under both explains how dragging works for the selected device.

Device

The Desktop and Mobile switch at the top right of the window chooses the device that you are editing. Every setting in the window is stored separately for each device, and separately for the Preview and the Detailed View. Engini - Device switch

Preview and Detailed View

The two tabs under the title choose the view that you edit. Engini - Preview and Detailed View tabs
  • Preview - How the records are listed on the main screen of the app.
  • Detailed View - How a single record looks when the user opens it.

Fields list

The list on the left holds the fields of the screen. Engini - Fields list
  1. Shown in app - The fields that are displayed in the app.
  2. Hide all - Hides all the displayed fields.
  3. Hidden in app - The fields that are not displayed.
  4. Show all - Displays all the hidden fields.
  5. Collapse fields - Collapses the list to give the canvas more room. Click the same icon to expand it again.
Each row in the list is one field. Engini - A field row On the Preview, a row has a drag handle, a filter icon and an eye icon:
  • The drag handle moves the field in the layout.
  • The filter icon makes the field available in the filter. It works only when Can Filter is on in the Screen Properties.
  • The eye icon hides the field from the app, or displays it again.

Initial Query

On the Preview, the Initial Query button sets which records are loaded when the screen opens. Engini - Initial Query button It opens a panel where you add filters. The button shows the number of filters that are set. Engini - Initial Query panel Each filter has the following parts. Engini - An initial query filter
  1. Field - The field that the filter checks. Use the trash icon on the right to remove the filter.
  2. Condition - The comparison, such as Is Empty.
  3. Value - The value to compare with. Depending on the condition, it may not be needed.
  4. Add Filter - Adds another filter.

Sorting

The Sorting button sets the order of the records on the Preview. Engini - Sorting button It opens a panel where you add sorting rules. The button shows the number of rules that are set. Engini - Sorting panel Each rule has the following parts. Engini - A sorting rule
  1. Field - The field to sort by. Use the trash icon on the right to remove the rule.
  2. Direction - Ascending or Descending.
  3. Add Sort - Adds another rule.

Label placement

Label placement sets where the field names appear: Side (beside the value) or Top (above the value). Engini - Label placement

Columns

Columns sets how many columns the fields are arranged in. Engini - Columns on mobile
  • On Mobile you can choose 1 or 2 columns. Two columns are available only with Top labels, because two labels beside their values do not fit a phone’s width.
  • On Desktop you can use up to 12 columns.
On Desktop, use the stepper to set the number of columns. The canvas shows an empty cell for every position. Engini - Columns on desktop

Field type icons

Turn on Show field type icons to show the type icon next to each field name on the canvas. Engini - Show field type icons

Arrange the fields

On Mobile, drag a field up or down, in the list or on the canvas, to change its position. When the screen has two columns, the fields fill the columns in order. On Desktop, drag a field card onto a cell of the canvas to place it. Dropping a card on an occupied cell swaps the two cards.

Detailed View settings

On the Detailed View, each field in the list has three more icons next to the eye icon. Engini - Detailed View field options
  • Required - The asterisk. The user must provide a value before the record can be saved.
  • Readonly - The pen. The user cannot edit the value.
  • Edit on Add View - The pen with a plus. It works with a read-only field, and lets the user enter the value when adding a new record. It is available only after Readonly is on.
The Initial Query and Sorting buttons are available only on the Preview. Under the fields, a Buttons section lists the button fields of the screen. Use the eye icon to show or hide each button. Engini - Buttons list The shown buttons appear in an action bar at the bottom of the record. Drag a button inside the bar to change its order. Engini - Action bar on the desktop canvas

Save the view

Click Save to apply your changes to the screen, or Cancel to discard them. Save does not save the app itself: after it, click Save at the top right of the editor to save the app. Engini - Save and Cancel
  1. Cancel - Closes the window and discards the changes.
  2. Save - Applies the changes to the screen.

Step 5: Business Rules

The Business Rules tab lists the rules of the screen. Engini - Business Rules tab
  1. Rule switch - Turns the rule on or off.
  2. Rule menu - Opens the menu with Edit, Duplicate and Delete.
  3. Add Business Rule - Creates a new rule.
To learn how to build a rule, see the Business Rules guide.

Step 6: Sub Screens

Sub screens let you connect screens within your app. You can show one screen inside another, making a connected user experience. Open the Sub Screens tab in the properties panel. Engini - Sub Screens tab If no sub screen exists yet, click Add Sub Screen. Only saved screens can be connected, so save the app first if you just created the other screen. Engini - Add Sub Screen The first available screen is connected right away. Each connected screen has the following settings. Engini - Sub screen settings
  1. Connect Screen - Choose the screen to connect. The trash icon on the right removes the sub screen.
  2. Display in main form - Displays the connected screen inside the main form.
  3. Conditions - Defines when the sub screen is used. Click it to expand.
  4. Default values - Defines values that are filled in when the sub screen is used. Click it to expand.
Open Conditions to add a condition. Engini - Sub screen conditions
  1. Field - The field to check. Use the trash icon on the right to remove the condition.
  2. Condition - The comparison, such as Is Empty.
  3. Value - The value to compare with.
  4. Add Condition - Adds another condition.
Open Default values to add a default value. Engini - Sub screen default values
  1. Field - The field that receives the default value.
  2. Value - The default value.
  3. Add Default Value - Adds another field and value.

Step 7: History and versions

The History button (the clock icon) at the top right of the editor, next to the settings, opens a drawer with two tabs.
  • History - The runs of the app’s Business Rules.
  • Versions - The saved versions of the app itself.
Engini - History button in the App Editor

Versions

Every time you save the app, Engini keeps a version of it. The Versions tab lists the versions of the last 45 days, newest first. Each row shows the date and time of the save and the user who made it.
  • The newest version carries the Current Version badge.
If the app has no saved versions yet, the tab shows No versions yet. Engini - Versions tab with the Current Version badge Click a version to open it in the editor as a read-only preview. You cannot edit the app while you preview a version. The Save button at the top is replaced by Back to current version, and a bar at the bottom of the editor shows the date of the version. The actions are:
  • Export - The download icon in the bottom bar saves the version as a JSON file.
  • Restore Version - In the bottom bar. Loads the version into the editor.
  • Back to current version - At the top right. Leaves the preview and returns to the app as it is now.
Engini - Version preview with Restore Version You can also click the three dots at the end of a row and choose Restore this version or Export, without opening the preview first. Engini - Version row menu Restoring does not change the app yet. The editor shows App version restored. Save to persist changes., and the version replaces the app only when you click Save. Until then, leave the page without saving to keep the app as it was.