KEPLIN Docs

App templates

What a template is, how to create an app from one, how to save an app as a template, how to delete one, and how a template from this platform becomes a system template.

A template is an app that serves as a starting point: the data model, the screens, the scripts and the reports, that is, everything that is design, ready to take a new name and get to work. It is the difference between opening a blank app and opening an app that already knows what it is.

Two families live side by side in the gallery, told apart by a badge:

Badge Where it comes from
System Installed by whoever manages the installation. It is the base offer, the same for everyone.
From this platform Saved here, from an app of this platform. Only this platform sees it.

Creating an app from a template

  1. Click New app, in the Dashboard header or in the sidebar, and pick the From a template card.
  2. The gallery shows the available templates, with the image, the name, the description and the version. Pick one.
  3. Type the New app name. The slug derives from it, as in any creation.
  4. If the template brings data tables, choose Where the data lives:
    • SQLite managed by Keplin, with no configuration: the app brings its own data file, and you can connect it to an external server later;
    • or a database server (PostgreSQL, MySQL, MariaDB, SQL Server or Oracle), with the connection details. Choose an empty database: the tables are created in that engine and, if they already exist, the creation stops before touching anything.
  5. If the template brings data, choose the App data language (the states, stages and priorities the app brings are created in that language) and, optionally, turn on Include sample data.
  6. Click Create from template.

The template gallery in the New app modal: the cards with name, version and the origin badge.
The template gallery in the New app modal: the cards with name, version and the origin badge.

The new app is yours from the first second: changing what it brings does not touch the template, and updating the template later does not touch the apps that were born from it.

Note

A template brings the APPLICATION, never the people: there are no user accounts, mailbox or uploaded files. And the schedules arrive turned off: a freshly created app does not start working on its own.

Saving an app as a template

Any app on this platform can serve as a starting point:

  1. Open the app's Settings, the General section, and, in Take this app, click Save as template.
  2. Give it a Name, a Description (what this template gives whoever starts from it) and a Version.
  3. Optional: in Preview (optional), click Pick an image (PNG or JPEG). The image appears on the gallery card.
  4. Click Save. The template goes into this platform's gallery.

The Save as template dialog, with name, description and version filled in.
The Save as template dialog, with name, description and version filled in.

Saving the same app again replaces its template: the identifier is the app's slug, and that is how the offer stays up to date without piling up copies.

Viewing and deleting this platform's templates

This platform's templates are listed in the platform Settings, in the Apps group, in the Templates section: the name, the version, the description, the app it came from, the date it was saved and the size.

To delete a template:

  1. On the template's row, click the bin icon.
  2. The confirmation appears on the row itself. Click Delete.

The template leaves the New app gallery. The apps already created from it do not change. System templates do not appear in this list and are not deleted here.

The Templates section of the Settings, with a template saved from an app
The Templates section of the Settings, with a template saved from an app

Taking a template to system template

A template saved here can become part of the installation's base offer:

  1. After saving, click Download .keplintemplate, in the dialog, or Download, in the Templates section of the Settings.
  2. Send the file to whoever manages the installation. That person uploads it in the back office and makes it visible to every platform.

The same file also installs on any other installation: it is a complete package, with no network dependencies.

Why can't I see…?

  • …the From a template card with templates? The gallery is empty while there are no system templates installed and no templates saved on this platform. Save an app as a template, or talk to whoever manages the installation.
  • …the original app's data in the template? That is by design: a template is the design, never the data of the people who use the source app.
  • …the Save as template button? It is for administrators, like everything that creates and manages apps.
  • …a way to delete the template in the New app gallery? The gallery is only for choosing. Templates are deleted in Settings › Templates.