Skip to main content

Applications

OnEarly is built in two layers. A shared foundation — the substrate — handles content, sharing, history and the parts of the app every feature needs. Applications add the screens and logic for a particular kind of work, such as ordering a pathology test.

Terms​

TermMeaning
SubstrateThe shared foundation. In the backend: the content model (types, instances, permissions, history), notifications and APIs. In the app: navigation, sign-in, shared building blocks, a generic way to display any content, and views.
ApplicationCustom screens and logic for one or more content types, such as pathology ordering.
Content type and instanceA content type is a schema, stored as content. An instance is one record of it. See Health Network.
SurfaceA size at which content is shown: card or page.
ModeWhat you are doing with content on a surface: view, edit or create.
ViewA substrate layout across many instances: a table or a list.
Native and off-platformA native application runs inside OnEarly. An off-platform application is a separate product that uses the OnEarly API.
First party and third partyWho writes and runs the code: OnEarly, or someone else.
ActorAnyone or anything that can own content, be given access to it, or make a change. See People & Groups for the five kinds.

How the layers fit​

Applications depend on the substrate. The substrate never depends on an application, so any content still displays and shares correctly even where no application provides custom screens for it.

How the layers fit
How the layers fit

Applications today​

First party (OnEarly)Third party
NativePathology ordering, radiology requests, threads, scheduling, payment receiptsNot planned yet
Off-platformSeparate OnEarly products with their own app and backend. People sign in with OAuth; the backend calls the OnEarly API with a group API key.Outside apps you allow to use your account, such as AI assistants using OnEarly's MCP tools. See Connected apps.

Native applications are built directly into OnEarly. Each offers its own operations, such as the steps of a request. A separate OnEarly product acts as its group, so it sees only content shared with that group.

You can revoke an outside app you have allowed under Account → Connected apps, one app at a time. OnEarly's own apps and products can't be revoked there.

Surfaces and modes​

Each surface can be shown in each mode. Where an application provides no screen for a surface, the substrate's generic display is used.

SurfaceShown asTypical place
CardA summaryLists, search results, conversations
PageThe full viewWhen you open the content
ModePurpose
ViewRead the content.
EditChange content that exists.
CreateMake a new instance.

Content also appears as a list row or inside a conversation.

Views​

Views are provided by the substrate and work for any content type. You can save a view of your own content, or of a group's.

Views display as a table or a list. See Views.

On the roadmap

What we're working on​