Glossary
Ubrella uses a small, fixed vocabulary. The same words appear in the app, the docs, the API and the code. Where several words could mean the same thing, we picked one and avoid the others.
| Term | Meaning | We avoid |
|---|---|---|
| Workspace | The container that owns all of your projects and integrations. One per person during the beta. | account, portfolio (as a noun) |
| Project | One real thing you ship and care about as a unit — an app, a SaaS, a website, a service. The umbrella under which sources are grouped. Always your record. | app (as a noun), product |
| Platform | A label on a project: iOS, Android, Web, Website, API. Descriptive only. | target, channel |
| Integration | A connected provider account (GitHub · olivermark). Several per provider are fine. | connection, connector |
| Source | One thing discovered inside an integration that belongs to a project — a repository, a RevenueCat project, a PostHog project. | external project, provider project |
| Assign / assigned | Placing a source under a project. Only you do this; the system never does. | connect (reserved for integrations), link, map |
| Match | The system’s proposal that a source belongs to a project, with a confidence score. Becomes an assignment only when you confirm. | auto-assign |
| Unassigned source | A discovered source under no project. Visible, silent. | orphan, ignored |
| Metric | A normalised number describing a project over a period — revenue · 7d. Always carries its source. | observation, KPI, data point |
| Event | Something that happened to a project at a specific moment — PR #182 merged. Never a PostHog analytics event. | activity, log entry |
| Snapshot | The set of a project’s metrics for one day. The unit of history. | daily summary, rollup |
| Timeline | A project’s events in chronological order, across all its sources. | activity feed, log |
| Baseline | A metric over the 7 days before the current 7-day window. | average, trend, expected |
| Attention item | One concrete thing that may need you to act. Produced by rules, never by the assistant alone. Open, resolved or dismissed. | alert, notification, incident |
| Pulse | A project’s state — Healthy, Attention, Critical, Unknown — derived purely from open attention items. | health, status, score |
| Daily brief | The once-a-day written summary of the workspace. | digest, report |
| Sync | The once-a-day read of every integration. | refresh, poll |
| Ask | The assistant. Works from Ubrella’s own data only. | chat, AI, copilot |