Platforms
One project can hold an app, its website and its backend, and the dashboard can show each on its own.
A project can hear from several parts of a product: a game's iOS app, its website and its API
can all send to one project. One person (by user_id) can then be followed across them, and the
dashboard can still show one part at a time.
There are two sides to this: the platform field on each event, and the list of platforms you
set up on the project.
The platform on each event
Every event carries a platform: which part of the product sent it. The SDKs send:
| SDK | Platform |
|---|---|
| Swift | The OS: ios, macos, tvos or visionos; apple on watchOS |
| Android | android |
| React Native, Flutter | The OS, from the native SDK underneath: ios or android |
| JavaScript | web in a browser, node on Node |
| Python | python |
| Go | go |
| JVM (Java and Kotlin) | jvm |
Override it in the configuration when a name says more, for example platform: "api" for your
backend and platform: "worker" for a queue consumer. The naming rule is the same as for
environments: lowercase letters, digits, - and _, up to 32.
When an event arrives without a platform, the server derives one from the SDK name and the OS
(lyrelog-swift on iOS is ios, lyrelog-js with os_name: "web" is web), else from the OS
name itself.
The project's platforms
In Settings, the Platforms section lists what sends events to the project, one card each with what it is:
| Platform | What you tell Lyrelog | What Lyrelog does with it |
|---|---|---|
| iOS app, Mac app | Its App Store listing: search by name or paste its link | Shows the app's name, developer, rating, version and bundle id |
| Android app | Its Google Play package (com.example.app) or Play link | Finds the app's name and icon on Google Play |
| Website | Its address (example.com) | Finds the site's icon |
| Server | Its language: Node, Python, Go, Java, Kotlin, Swift, Ruby, PHP, .NET, Rust, Elixir or Other | Shows the matching environment rules |
The icons found this way can become the project's icon (Icon in Settings). Removing a platform forgets what it was and its icon. The App Store listing goes when neither an iOS nor a Mac app is left.
When events from the last 30 days come from platforms the project doesn't list yet, Settings
says so and offers Add them. Event platforms map to project platforms like this: ios,
tvos and visionos are an iOS app, macos a Mac app, android an Android app, web a
website, and api, node, python, go and jvm a server (with its language when it's known). A
website or an Android app opens as a card to fill in, since it needs its address or package.
Only owners can change the platforms.
Filtering by platform
- Top bar: when a project hears from more than one platform, the environment picker adds a Platform section listing each event platform seen in the last 30 days, plus All platforms. The choice is remembered per project in your browser and applies to every page. See Environments and platforms.
- Explorer: the Platform filter takes one or several values, or excludes them ("Platform is not web").
Both filter by the platform on each event, not by the project's list.