Core Concepts
PushGo is more than just a notification app. It’s a synchronization engine for your digital life. To use it effectively, you only need to understand two things: Channels and Data Models.
1. Channels: Your Communication Pipe
Section titled “1. Channels: Your Communication Pipe”A Channel is like a private radio frequency.
- Channel ID: The name of your pipe (e.g.,
my-home-server). - Password: To ensure only authorized senders can push to your devices.
When you subscribe to a channel on your phone, you are telling PushGo: “I want to hear everything that happens in this pipe.”
2. Data Models: What flows in the pipe?
Section titled “2. Data Models: What flows in the pipe?”Not every notification is the same. PushGo provides three models to handle different scenarios:
📢 Message (Ephemeral)
Section titled “📢 Message (Ephemeral)”Think: “A text message.”
- Best for: Alerts, news, chat, one-time notifications.
- Example: “Motion detected in the garage!”, “Server backup finished.”
- Behavior: You see it, you dismiss it. It doesn’t represent a persistent state.
🕒 Event (Stateful)
Section titled “🕒 Event (Stateful)”Think: “A timeline of changes.”
- Best for: Tracking transitions or occurrences with a duration.
- Example: “Door opened” (Event Start) -> “Door closed” (Event End).
- Behavior: PushGo merges these events to show you a timeline of what happened and when.
📦 Thing (Persistent)
Section titled “📦 Thing (Persistent)”Think: “A virtual representation of an object.”
- Best for: Representing a device, a room, or a long-running task.
- Example: “Living Room Thermostat”, “Home NAS”.
- Behavior: A Thing has attributes (temperature, online status). When these attributes change, you get notified, and the Thing’s “Card” in the app updates automatically.
Which one should I use?
Section titled “Which one should I use?”- Just want a ping? Use Message.
- Need to know when something happened? Use Event.
- Monitoring a device’s current state? Use Thing.