Back to Knowledge Base
What are Custom Apps?
Applies to CoCoCo platform v1.0.0-rc.31. What this article describes was checked on that version, except the Kiosk Mode and Job View kinds, which are described from the platform’s source.
Custom apps are small applications you build in the console and run on your instance — a shop-floor terminal, a control board, a checklist. You create and edit them under Developer → Custom Apps. The editor has three tabs: Settings (name, handle, kind), Code (the app’s template and script, optionally a server part) and Preview.
The kind decides where an app appears
Section titled “The kind decides where an app appears”Every app has a Kind, chosen on the Settings tab. It is the only thing that decides where the app shows up:
| Kind | Where it appears |
|---|---|
| Sidebar Page | in the sidebar, in the section Apps; clicking it opens the app at /apps/<handle>. New apps start as this kind. |
| Dashboard Tab | as a tab on Home (see Home and Dashboard Tabs) — not in the sidebar |
| Kiosk Mode | only for users in kiosk mode who are bound to the app; they see nothing else |
| Job View | a view embedded in job details; in this version the console itself has no place that shows it |
The Handle is part of the app’s address: a Sidebar Page app with the handle press-board opens at /apps/press-board.
Where to go next
Section titled “Where to go next”- To build a first app step by step, see How to Create Your First Custom App.
- Custom apps can also be placed on a dashboard, with the card Custom App (see How to Build, Export and Import a Dashboard).