User Manual

Offline Screen

5/10/26
Offline Screen

Kuika’s Offline Screen feature is designed to ensure a seamless user experience when your apps lose their internet connection. With this feature, a specific screen is displayed to the user when there is no connection, and the app adapts to offline conditions.

Offline Screen Features

  • Single Screen Limit: Although a project can contain multiple offline screens, only one screen can have the “Default Offline Screen” role.
  • Connection Status: It activates automatically when the internet connection is lost. When the connection is restored, the user manually switches back to the Online Screen.
  • Device Features: Hardware features such as the camera or GPS can be used. However, backend calls that require an internet connection are not supported.
  • Actions: Only client-side actions can be used. Server-side actions are not supported.
  • Platform Compatibility: Can be used in web and mobile applications.
  • SQLite Offline Storage: Screens with the Works Offline option enabled write data directly to the local SQLite database on the device.
  • Automatic Synchronization: Data saved in offline mode is automatically transferred to the server via the defined sync mechanism when a connection is established.
  • Editable Offline Tables: Tables marked with “Enable Editing” are downloaded as editable in offline mode, and any changes made are sent to the server during synchronization.
  • Column-Based IsDirty Tracking: In Upsert operations performed in offline mode, the IsDirty mechanism tracks which columns have been modified. This ensures that only the modified columns are sent to the server during synchronization.

Using Offline Screen

  1. Screen Design
    • Create the screen that will operate offline in the UI Design module.
    • Add images via the Image Library instead of the API.
    • Do not use elements or actions that require an internet connection.
  2. Role Assignment
    • Select the relevant screen from the Screens list in the left panel.
    • Go to the Properties tab in the right panel.
    • Enable the Works Offline option.
    • The relevant screen automatically receives the Default Offline Screen role.
  3. Data Configuration
    • Select the tables to be used offline.
    • Use the Schema Only option to download only the schema structure.
    • Enable the Enable Editing option for tables that need to be edited.
  4. Platform-Specific Build
    • Export the app for iOS or Android.
    • When the internet connection is lost on the device:
      • The user is notified.
      • The Offline Screen opens automatically.

By following these steps, you can ensure that your app provides a user-friendly and functional experience even in offline mode.

Glossary

No items found.

Alt Başlıklar