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.

Step 2: Manage screens
Use the three-dot menu next to a screen name to manage that screen.

- 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.
- 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.
Delete a screen
Select Delete. Engini asks you to confirm the deletion. Click Delete to remove the screen, or Cancel to keep it.
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.
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.
- Screen Properties - The general settings and behavior of the screen.
- Business Rules - The automations of the screen.
- Sub Screens - The screens that are connected inside this screen.
Screen Properties
The first tab holds the settings of the screen itself.
- Name - The name of the screen. It is shown in the screen tab and to the users of the app.
- Screen Color - Pick the color of the screen.
- Description - A short description of the screen’s purpose, to help you organize your screens.
- 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.
- Fields - The fields of the screen. Click it to expand the list.
- 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.



- Field Name - The name that identifies the field on the screen.
- Default Value - A value that is filled in automatically.
- Text direction - Left, Default or Right.
- Is Barcode - Tick it to use the field for barcode input or scanning.

- Default Value - The date that is filled in automatically.
- Format - How the date is displayed.
- Date type - Date, Date & Time or Time.

- Default Value - The number that is filled in automatically.
- Format - How the number is displayed.
- Is Barcode - Tick it to use the field for barcode input or scanning.

- Display Title - The text shown on the button.
- 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.
- Accessible from Main Screen - The screen is shown on the Screens page and in the Screens menu.
- Enable Exit Screen - Displays a Back button on the screen.
- Enable Record Navigation - A navigation panel appears on the Detailed view, to move between records.
- Display Records on Screen Entry - Populates the screen with its records when the user opens it.
- Enable Comments - Shows the comments badge on each record.
- Enable Files Gallery - Shows the record’s files behind a paperclip, so app users can open, add and download them. See Files Gallery.
- Enable Record Activity - Shows the record’s change history, the same Activity that the table’s record drawer carries.
- Can Add Record - Users can add new records from this screen.
- Can Edit Record - Users can edit existing records from this screen.
- Can Delete Record - Users can delete records from this screen.
- Can Filter - Enables filtering on the Preview. You choose which fields can be filtered in the Edit View window (see Step 4).
- Can Scan Barcode - Enables barcode scanning on the screen. Extra settings appear below it.

- Comments are Read-Only - Users can read the comments but not add or change them.
- Files are Read-Only - Users can preview and download the files but not add or delete them. See Files Gallery.
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
- Select the screen and open Screen Properties.
- Switch on Enable Files Gallery. The preview in the editor updates right away.
- Click Save.

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.


- 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.
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.
- Text Direction - The direction of the barcode text: Left, Default or Right.
- Autocomplete - Turn it on to let Engini fill in related values based on the scanned barcode. A Barcode search definition section opens.

- Search in Table - The table that is searched for the scanned value.
- Return Field - The field whose value is returned. It becomes available after you choose a table.
- 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.



- 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.
Preview and Detailed View
The two tabs under the title choose the view that you edit.
- 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.
- Shown in app - The fields that are displayed in the app.
- Hide all - Hides all the displayed fields.
- Hidden in app - The fields that are not displayed.
- Show all - Displays all the hidden fields.
- Collapse fields - Collapses the list to give the canvas more room. Click the same icon to expand it again.

- 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.


- Field - The field that the filter checks. Use the trash icon on the right to remove the filter.
- Condition - The comparison, such as Is Empty.
- Value - The value to compare with. Depending on the condition, it may not be needed.
- Add Filter - Adds another filter.
Sorting
The Sorting button sets the order of the records on the Preview.


- Field - The field to sort by. Use the trash icon on the right to remove the rule.
- Direction - Ascending or Descending.
- Add Sort - Adds another rule.
Label placement
Label placement sets where the field names appear: Side (beside the value) or Top (above the value).
Columns
Columns sets how many columns the fields are arranged in.
- 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.

Field type icons
Turn on Show field type icons to show the type icon next to each field name on the canvas.
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.
- 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.


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.
- Cancel - Closes the window and discards the changes.
- Save - Applies the changes to the screen.
Step 5: Business Rules
The Business Rules tab lists the rules of the screen.
- Rule switch - Turns the rule on or off.
- Rule menu - Opens the menu with Edit, Duplicate and Delete.
- Add Business Rule - Creates a new rule.
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.


- Connect Screen - Choose the screen to connect. The trash icon on the right removes the sub screen.
- Display in main form - Displays the connected screen inside the main form.
- Conditions - Defines when the sub screen is used. Click it to expand.
- Default values - Defines values that are filled in when the sub screen is used. Click it to expand.

- Field - The field to check. Use the trash icon on the right to remove the condition.
- Condition - The comparison, such as Is Empty.
- Value - The value to compare with.
- Add Condition - Adds another condition.

- Field - The field that receives the default value.
- Value - The default value.
- 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.

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.

- 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.

