Configuring ApptiveTeams
ApptiveTeams is configured entirely through an ApptiveGrid Space — without writing a single line of code. This guide walks you through controlling the app's branding, tabs and content via grids.
Overview
ApptiveTeams is the employee app for your company. Employees sign in with their ApptiveGrid account and see the content you maintain in a so-called Team Space in ApptiveGrid: forms, links, news and web content. Change something in the Space and it shows up in the app right away — no app update required.
The app reads specific grids from your Team Space. Which grid serves which purpose is defined by keys — both on the grid level and on the field level. You can name grids and fields however you like; only the keys matter.
Requirements
- An ApptiveGrid account for your company and for every employee who should use the app.
- A Space in ApptiveGrid marked as a Team Space for ApptiveTeams (category apptiveTeams). The easiest way to start is with our Team Space template — get in touch.
- All employees invited as members of the Team Space.
- The ApptiveTeams app from the App Store (iOS) or Google Play (Android).
Getting started
- 01
Install the app
Download ApptiveTeams from the App Store or Google Play.
- 02
Sign in
Sign in with your ApptiveGrid account. Login opens the secure ApptiveGrid sign-in page in the browser.
- 03
Select your team
The app lists all Team Spaces you are a member of. If there is exactly one team, it opens automatically. You can switch anytime later via “Switch team” in the settings.
- 04
Go
The app loads branding, tabs and content from the Team Space. Use the refresh icon in the top right to reload the configuration.
The Team Space
A Team Space is a regular ApptiveGrid Space with the category apptiveTeams.
Only Spaces with this category are offered for selection in the app. Inside the Space, the app expects
three configuration grids, identified by their grid key:
| Grid key | Purpose |
|---|---|
config | App branding: logo, primary color, version |
tabs | The tabs of the bottom navigation bar |
settings | Additional entries on the settings screen |
Both regular (persistent) grids and virtual grids (views) are supported — virtual grids take precedence. All fields are likewise identified by their field keys; set them in the field settings of the respective grid.
App configuration config
The grid with the key config controls the app's
appearance. Only the first row is evaluated.
| Field key | Field type | Required | Description |
|---|---|---|---|
logo | Attachment (image) | Yes | Your company logo, shown e.g. above the tile view. |
primaryColor | Text | Yes | The app's primary color as a hex value, e.g. #1565C0. Tints icons, buttons and the active tab. |
version | Text / number | No | Version of the Team Space schema. Currently: 1. |
Tabs tabs
Every row in the grid with the key tabs becomes a
tab in the app's bottom navigation bar. The navigation bar only appears with
at least two tabs.
| Field key | Field type | Required | Description |
|---|---|---|---|
title | Text | Yes | Label of the tab. |
icon | Attachment (SVG) | Yes | Icon of the tab as SVG. The app tints the icon — use monochrome SVGs. |
type | Text / selection | Yes | Type of the tab: TilesGrid, CardList or WebView. |
gridUri | Grid reference | For TilesGrid & CardList | Reference to the grid that holds the tab's content (tiles or cards). |
uri | URL | For WebView | Web address displayed in the tab. |
Rows with missing required fields are skipped. You can use this to temporarily hide a tab, e.g. by clearing its title.
Tile view TilesGrid
A tab of type TilesGrid shows a grid of tiles —
ideal as a home screen with quick access to forms and links. Every row of the grid referenced via
gridUri becomes a tile.
| Field key | Field type | Required | Description |
|---|---|---|---|
title | Text | Yes | Label of the tile. |
icon | Attachment (SVG) | Yes | Icon of the tile (monochrome SVG). |
uri | URL | Yes | Target of the tile, e.g. an ApptiveGrid form link. |
actionType | Text / selection | Yes | How the target is opened (see below). |
Action types
| Value | Behavior |
|---|---|
formLink | Opens an ApptiveGrid form directly inside the app. |
internalLink | Opens the page inside the app. For ApptiveGrid links, the signed-in user is passed along so e.g. the “created by” field is set correctly. |
externalLink | Opens the page in the device's browser. |
Card view CardList
A tab of type CardList shows a list of cards with
image, headline and action button — ideal for news, announcements or tasks. Every row of the referenced
grid becomes a card.
| Field key | Field type | Required | Description |
|---|---|---|---|
headline | Text | Yes | Headline of the card. |
supportingText | Text | No | Description text below the headline. |
image | Attachment (image) | No | Image of the card. |
actionUri | URL | Yes | Target of the action button. |
actionType | Text / selection | Yes | formLink, internalLink, externalLink or triggerFlow. |
actionLabel | Text | No | Label of the action button. |
createdAt | Date & time | Yes | Creation time — shown on the card (e.g. “Today”, “Yesterday”). |
The action type triggerFlow opens the target in an
in-app browser — use it to start ApptiveGrid flows straight from a card.
WebView tab
A tab of type WebView embeds a web page directly
into the app. Instead of a grid reference, enter the desired web address in the
uri field — for example your intranet, a shift
schedule or an external portal.
Settings settings
The grid with the key settings lets you add custom
entries to the app's settings screen — for example links to your privacy policy, legal notice or help
center. Every row becomes an entry that opens the given URL.
| Field key | Field type | Required | Description |
|---|---|---|---|
title | Text | Yes | Label of the entry. |
url | URL | Yes | Address opened when tapped. |
Independently of this, the settings screen always contains: the signed-in user's profile, logout, switch team, app version and the option to delete the account.
Tips & troubleshooting
The app does not show a team.
Check that the Space has the category apptiveTeams and that the signed-in user has been invited as a member of the Space.
The bottom tab bar does not appear.
The navigation bar only shows with two or more valid tabs. Check that at least two rows in the tabs grid have all required fields filled in.
A tab, tile or card is missing.
Rows with missing required fields are hidden. Also verify that all field keys match exactly (they are case-sensitive).
Logo or color is not applied.
In the config grid, both logo and primaryColor must be filled — otherwise the row is ignored entirely. The color must be a hex value such as #1565C0.
Icons are not displayed.
Tab and tile icons must be SVG files. Since the app tints the icons, monochrome SVGs work best.
Changes do not show up in the app.
Tap the refresh icon in the top right of the app or restart the app.
Questions about the setup?
We are happy to set up your Team Space together with you — or provide a ready-made template as a starting point.
Get in touch