Admin User Guide · Configuration Module

Your brand.
Your language.
Your buttons.

Configuration is where the platform stops looking like a generic template and starts looking like yours — colors, logos, button labels, extra report types, and full multi-language support, applied globally or per community, no app-store release required.

🎨 Branding & Themes 🧩 Custom Buttons 🌍 Multi-Language 🏘️ Per-Community Overrides 🖼️ Icon Library
4
Languages supported
1,425
Translation strings
12
Extra buttons per app
5
Button action types
Scroll to begin ↓
Overview

Configuration at a glance

Two tools, one goal: make the Citizen App and Responder App feel like they were built for your organisation.

Configuration module landing screen with Customizations and Translations cards
Configuration → Customizations (branding, colors, buttons) and Translations (language packs)

Every deployment of the platform serves a different organisation, community, or region — and each one wants its own look, its own report types, and its own language. Configuration puts every one of those decisions in the admin's hands instead of a developer's release cycle.

Customizations
Branding, colors, logos, and custom report buttons for the Citizen App and Responder App — set globally, or overridden per community.
Translations
A full translation table covering every screen and label in the platform, with per-language custom overrides and bulk import/export.

Global first, local second. Set a default look and language for the whole platform, then override colors, logos, or button sets for any individual community — a security estate can run its own branded app on the same underlying platform as everyone else.

Section 01

App Customization

Set the default look of the Citizen App home screen — logo, colors, and animation — with a live preview as you go.

Customizations opens on six cards covering every corner of app appearance, from platform-wide branding down to per-community overrides and the buttons responders and citizens press every day.

Customizations landing screen with six cards: App Customization, Community App Settings, Responder App, Community Responder App, Extra Buttons, Extra Buttons Responder, and Icon Gallery
Customizations → App Customization, Community App Settings, Responder App, Community Responder App, Extra Buttons (both apps), and the Icon Gallery

Logo, colors, and a live preview

App Customization controls the Citizen App's home screen at the platform default level — the look every community gets unless they set their own override. Upload a logo, scale it, add a subtle animation, and set the background and per-button colors, all reflected instantly in the phone preview on the right.

App Customization screen with logo upload, logo size slider, logo animation dropdown, button colors, and a live phone preview
App Customization → logo, size (50–400%), animation (Glow, and others), background and button colors, live phone preview
  • App Logo — a custom PNG replaces the default AWE Citizen mark on the home screen (recommended 450×350px, transparent background).
  • Logo Size — scale from 50% to 400% of default, useful for a wordmark logo that needs more room.
  • Logo Animation — add a subtle Glow or other effect so the home screen doesn't feel static.
  • Button Colors — set the app background color and the background color of every home-screen button (Panic, Fire, Suspicious Vehicle, and any Extra Buttons) individually.

Live Preview, always on. Every change to logo, size, animation, or color renders instantly in the phone mockup — nothing is applied to real users until Save Colors is pressed.

Section 02

Per-Community Branding

Give any community — an estate, a ward, a business district — its own branded Citizen App, without touching the platform default.

Community App Settings works the same way as App Customization, but scoped to a single selected community, with an Enable Custom Settings switch to opt that community out of the global look entirely.

Community App Customization screen for 24/7 Security with custom black theme and yellow branding shown in the live preview
Community App Customization → 24/7 Security's own black-and-yellow branded Citizen App, distinct from the platform default

Once Enable Custom Settings is on, the same Colors / Logo / Extra Buttons tabs from App Customization apply — but only to that community's residents. Every other community keeps the platform default until they're switched over too.

Use case. A gated estate or private security firm with its own visual identity — like the "24/7 Security" example above — gets the app to feel like their own product, while still running on the shared AWE platform underneath.

Section 03

Responder App Customization

The same branding controls, tuned for the Responder App's home dashboard — plus safety-critical interaction settings.

Responder App Customization mirrors the Citizen App tool, but themes the Responder home dashboard's grid of function tiles (Panic, Reports, Patrols, Health Check, Digital OB, Assignments, PTT Radio, News & Updates) instead of the citizen quick-actions.

Responder App Customization screen with logo, app background color, header background color, and a live preview of the responder home dashboard tiles
Responder App Customization → logo, app background, header background, and per-tile colors, previewed live against the real dashboard grid

This is also where per-community Responder App branding lives, for teams that need their own patrol app look — reached via the Community Responder App card, with the same community picker and Colors/Logo tabs pattern used elsewhere.

Community Responder App Customization community picker dropdown listing communities like 24/7 Security, Alexandra, Ward 1
Community Responder App → pick any community from the platform's full list to customize its responder app
Community Responder App preview for 24/7 Security showing custom logo and grayscale tile theme on the responder dashboard
24/7 Security's Responder App — custom logo and a muted grayscale tile theme, distinct from the platform default

Icon size, label size, and long-press protection

Beyond color, three settings tune how the dashboard actually behaves in the field — larger touch targets for gloved hands, bigger labels for readability in bright sunlight, and a long-press hold to stop a panic button firing by accident in a pocket or vest.

Button Icon Size, Button Label Size, and Long Press Duration sliders with a Try It Out test button
Icon Size and Label Size (50–200%), Long Press Duration (1s–5s) — with a live "Hold to test" button

Field safety, not just style. Long Press Duration exists specifically to prevent accidental panic activations — the default of 2 seconds balances speed in a real emergency against false alarms from a bag or holster.

Section 04

Extra Buttons

Add up to 12 custom buttons per app — each one wired to a report type, a URL, a phone call, an email, or a full integrated module.

Extra Buttons is where the platform becomes genuinely configurable rather than just re-skinned. Every custom button gets a label, an icon, a background color, a sort order, and — critically — an Action Type that decides what actually happens when it's tapped.

Extra Buttons screen for the Citizen App showing 12 configured buttons including Crime Report, Smart Monitoring, GBV Report, Drug Dealings Report, and SAPS Intervention
Extra Buttons (Citizen) → 12/12 slots used — Crime Report, Smart Monitoring, Service Issue, GBV Report, Drug Dealings, Watch, Illegal Dumping, Road Maintenance, Noise Violation, Anonymous Report, SAPS Intervention, Send Feedback

Five action types

Admin RBAC rights allow any Extra Button to be wired to one of five action types — from a simple in-app report through to launching a fully separate specialised module:

📋
Create Report
🔗
Open URL
📞
Call Phone
✉️
Send Email
🧩
Module
Edit Button modal for SAPS Intervention showing label, icon, action type Create Report, report type, background color, sort order, and active toggle
Edit Button → label, icon, action type, optional report type, background color, sort order, active toggle
Edit Button Action Type dropdown open, showing Create Report, Open URL, Call Phone, Send Email, and Module options, with Module selected
Action Type dropdown → Module is selected here, launching a specialised integrated module like FaceMap or Virtual Guardian directly from the button
Action TypeWhat it doesTypical use
Create ReportOpens the standard in-app report form, pre-tagged with a report typeCrime Report, GBV Report, Noise Violation
Open URLLaunches an external link in-app or in the device browserSmart Monitoring dashboard, YouTube channel
Call PhoneDials a pre-defined number directly from the buttonA control room hotline or estate security desk
Send EmailOpens a pre-addressed email, optionally with a subject templateFormal complaints or feedback routed to a specific inbox
ModuleDeep-links straight into one of the platform's specialised modulesFaceMap, Virtual Guardian, VOI, Agent Awe, GUNS

Need something more custom? If none of the five action types fit — a bespoke workflow, a third-party system integration, or custom logic beyond a report, call, or link — a fully customised module can be developed to your specification. Chat to our Dev Team to scope it out.

Responder App gets its own button set

Extra Buttons (Responder) works identically, but populates the Responder App's Reports screen instead — typically wired to Module actions that launch specialised field tools rather than citizen report types.

Extra Buttons (Responder) screen showing 5 of 12 buttons: FaceMap, VOI - Vehicle of Interest, Virtual Guardian, Agent Awe, and GUNS
Extra Buttons (Responder) → 5/12 used: FaceMap, VOI, Virtual Guardian, and Agent Awe (all Module type), plus GUNS (Report type)
Create New Button modal with label, icon upload/gallery picker, action type Create Report, report type, background color, and active toggle
Create New Button → pick or upload an icon, choose the action type, and set a background color before publishing
Section 05

Icon Gallery

A shared, categorised icon library every Extra Button draws from — upload once, reuse everywhere.

Rather than uploading a fresh image for every button, the Icon Gallery keeps a searchable, categorised library — Emergency, Municipal, Community, Transport, Utilities, Security, Health, and Other — so a consistent icon set can be reused across every community's buttons.

Icon Gallery screen showing a grid of icons with names and categories, including security-bulletin, armed-response, Guarding, TECHNOLOGY, and several character mascot icons tagged Emergency
Icon Gallery → search by name, filter by category, see each icon's uploaded dimensions
Upload Icons modal with drag-and-drop area and a category dropdown listing Emergency, Municipal, Community, Transport, Utilities, Security, Health, Other
Upload Icons → drag-and-drop PNG, JPG, SVG, or WebP, multiple at once, tagged with a shared category

Recommended size. Upload square icons at 64×64px or larger — they render at 64×64px in the Citizen App regardless of source size, and PNG with a transparent background looks cleanest against colored button backgrounds.

Section 06

Translations

Every label, alert, and message in the platform, in four languages — with custom overrides and bulk import/export.

Translation Management covers the platform's full string table — 1,425 translation keys across English, isiZulu, isiXhosa, and Afrikaans — organised by category so a specific screen's copy can be found and adjusted without wading through the whole set.

Translation Management screen with totals for 1425 total, 357 English, 356 isiZulu, isiXhosa, and Afrikaans translations, a search bar, language and category filters, and a list of isiZulu alert translations
Translation Management → 1,425 total strings across 4 languages, filterable by category (Alerts, Navigation, Dashboard, Forms, and more)
✏️
Custom vs. Base Translations
Base Translations are the platform defaults; Custom Translations let an admin override specific strings — a rebrand, a regional dialect preference, or a client-requested wording change.
📤
Export / Import
Export the full table (or a single language) for offline review or professional translation, then re-import — including Import All Languages for a full refresh in one pass.
Add Custom Translation modal with language dropdown, translation key, translation value, category, and description fields
Add Custom Translation → dot-notation key (e.g. dashboard.myAlarms), the translated value, and a category for organisation

Dot-notation keys. Every string is addressed like alerts.confirmCancel or dashboard.myAlarms — nested by screen and context, so the same key resolves consistently across languages and stays stable even as wording changes.