Home, the shared inbox and onboarding
Use Home to pick up recent notes and issues, see what is assigned to you, open your apps, and get started; read the bell's shared inbox; and know what the welcome step, first-visit cards and tour do.
Venom is a workspace of apps: Home, Notes (Venom Notes), Tasks (Venom Tasks), Flags (Venom Flags), Experiments (Venom Experiments) and Admin (models, keys, usage and
members). Home at /home is where you land after signing in. It answers two questions: what was I doing, and what
needs me?
Where sign-in lands
Every sign-in (email, GitHub, single sign-on, the token login) lands on /home unless the link asked for another
page with ?next=/path. A next you were given is always kept.
Home belongs to members of an organisation. The operator without an org seat, and a legacy key group session, go on to
the Overview at /dashboard, as before. The Overview is still in the nav, and the Admin app opens on it.
What Home shows
Home is one page, loaded in one go. Each section loads on its own; one that fails is left out and the rest still show.
| Section | What is in it |
|---|---|
| Pick up where you left off | Notes you edited last (in your own notes or the team's), and issues you are on (assigned, created or subscribed), newest first across both apps |
| For you | Issues assigned to you that are still open, unread Tasks inbox items (mentions, comments, status changes), and a line when suggestions wait for you in the Notes inbox |
| Drafts to approve | How many messages Venom drafted for you are waiting, and when the soonest sends by itself. Hidden at zero. It opens Drafts |
| Getting started | A short checklist, until every step is done or you hide it |
| Bring your work in | Buttons to import issues into Tasks and notes into Notes, for the apps you can open |
| Your apps | A card per app: what it is for, a few things to try and an Open button |
A section only reads what its app lets you read. Notes and issues come through the same checks as the apps themselves, so you never see another member's personal notes or another organisation's issues.
Your apps
You see a card for each app your role may open. An app the organisation has not turned on shows Ask your admin
to turn this on, or, if you can manage billing, a link to add it to your plan in Settings → Billing. Admin needs
the routing:read permission, so the billing role does not see its card.
If you answered the welcome step, the apps you picked come first and the first one is marked Suggested for you.
Getting started
The steps are: tell us what you'll use Venom for, take the tour, open each app your organisation has, write your first note (when Notes is on) and create your first issue (when Tasks is on and your role can create issues). Each step is checked from what you actually did. Hide removes the list for good.
Who's on call
With Venom Incidents and at least one on-call schedule, Home shows a Who's on call card: each schedule, who holds it right now (with a "You" badge when it is you), and when their shift ends in the schedule's time zone. It opens the on-call page.
The bell: one inbox for every app
The bell in the top bar collects what is waiting for you from every app, each row tagged with its app's name:
| Source | Rows | Counts toward the badge |
|---|---|---|
| Admin | spend alerts, forecasts, spend anomalies and key rotation reminders (Budgets) | unread ones |
| Tasks | unread Tasks inbox items: assigned to you, mentions, comments, status and priority changes | unread ones |
| Tasks | your weekly Pulse digest of project and initiative updates, until you open it | unread ones |
| Notes | one row while suggestions wait in the Notes inbox, kept at the top | no |
| Home | one row, "N drafts to approve", while Drafts holds any | yes |
Notes suggestions are not "read": you apply or reject them in the Notes inbox, so their row stays until you do and
never holds the badge up. Mark all read marks spend alerts seen and reads every Tasks inbox item and Pulse digest.
"All notifications" opens /notifications, which lists the same Tasks and Notes items above the spend alerts.
A source shows only for the organisation in view and only when it applies to you: Tasks and Notes rows need the add-on and a seat in that organisation.
Onboarding
The welcome step
On your first visit, Home asks What will you use Venom for? Pick any of:
- Notes and docs
- Tracking work
- Setting up AI for my team
Your picks set the order of the app cards and which one is suggested. Skip is fine too; the step does not come back either way.
Start with an example adds one note, "Welcome to Notes", to your own notes, and one issue, assigned to you, in your organisation's first Tasks team. Each is added only when its app is on (the issue also needs a Tasks team and a role that can create issues). Nothing is added unless you tick the box.
First-visit cards
The first time you open an app, a small card says what the app is for and what to try. Got it (or the close button) dismisses it for good, on every device.
The tour
After the welcome step, a three-step tour points at the app rail, the ⌘K search and the bell. Skip tour (or Escape) ends it; finished or skipped, it never comes back. A step whose target is not on the page shows in the corner instead.
What is stored
Your answers and progress live in one row per person and organisation (workspace_prefs, migration 0130): the
apps you picked, when you answered the welcome step, which first-visit cards you dismissed, whether you finished or
skipped the tour, and whether you hid the checklist. Nothing else, and nothing leaves the cloud.