Find your way around
The menu, the phone tab bar, search, notifications, Settings and Help, and where each one sits on a computer, a tablet and a phone.
On this pageOn a computer
ONYX1 shows each person only the menu items their role, plan and enabled modules allow, so two people can see different menus. A group with no visible items for you is hidden. Show or hide features explains the owner's module choices.
On a computer
The sidebar starts with Home, Approvals and Customers, with Portfolio below Customers when it is available. It then groups the rest of the work under Work, Sales, Team, Safety, Resources and Finances. Finances can open to Overview and Forecast when those pages are available to you. Price book is under Settings for the roles that can manage it. Select a group heading to open or close it. Only one group can be open at a time.
- The dock button at the top shrinks the sidebar to an icon rail and expands it again. ONYX1 remembers the choice for your user on that browser.
- Your name is at the bottom of the sidebar. Select it to open a menu with My account, Settings when your role can manage workspace settings or the price book, Help, Install app when your browser can install ONYX1, and Sign out. In the icon rail, select your picture to open the same menu. Dispatcher and office users see Settings there and go straight to Price book, without the Settings rail or any other workspace settings. Finances does not contain Price book.
- A dot on your picture shows whether your work has reached ONYX1. Green, with Synced next to your role under your name, means nothing is waiting. Amber means you are offline or changes such as photos, signatures or job status updates are waiting to send. In the expanded sidebar, a banner above your name then says Offline or Syncing, and adds how many are waiting to send when there are any. In the icon rail there is no banner: only the dot turns amber, and pointing at your picture shows the state in words.
- The top bar contains search and + New. The sidebar header contains notifications. Select + New to see only the records your role can create: Job, Draft job, Task, Lead, Quote, Invoice, Customer, Purchase request and Incident. Some entries are hidden when a module or permission is off.
- Owners and admins manage Form templates from Settings → Form templates. Checks is a separate destination for the roles that can use it.
- When business branding is available for your workspace, the expanded sidebar shows your logo with a small on ONYX1 mark; the collapsed rail shows the logo alone. Otherwise the expanded sidebar shows the ONYX1 wordmark and business name, while the collapsed rail shows a compact mark.
- If you are an owner, admin, dispatcher or office user with a current job assignment, a Business and Trade switch for Home sits above your account row in the expanded sidebar. The icon rail does not show it.
The sidebar is sized to fit the working area. Long groups scroll inside the sidebar, with a quiet scrollbar that does not create a page-wide horizontal scrollbar.
On a phone
Every phone screen keeps a small ONYX1 brand mark and your business name at the top. Select the + in the top corner to open the role-based creation menu as a bottom sheet.
- By default the business tab bar is Home, Jobs, Approvals, Customers and More.
- By default the crew tab bar is Home, Jobs, Timesheets and More.
- You can change the tabs between Home and More: see Edit your phone tabs.
- More opens a full-screen menu with search and the same groups as the desktop sidebar, except Home and Settings, each with its icon. Select a group to open or close it. Only one group can be open at a time. All groups start closed except the one that holds the page you are on. Appearance (System, Light or Dark), Notifications, Settings (when you can open it), Help, your account and Sign out follow at the end of the same scroll.
- The tab bar hides while you are inside a record, so the record has the full screen.
The same layout works in the iPhone app and the Android app on a phone. Phone scrolling uses the platform's own overlay indicator rather than adding a permanent scrollbar.
On a tablet
- iPad app. The tabs are the ones an iPhone shows, with the same counts on Approvals and More, but on an iPad running iPadOS 18 or later they sit in a sidebar or in a bar along the top of the screen instead of at the bottom. On iPadOS 17 the tab bar stays at the bottom.
- Lists and what you open from them. Jobs and Customers show their list on the left. The job or customer you select opens in the space beside the list, which reads Choose a job or Choose a customer until you pick one. More works the same way: its menu stays on the left and the screen you select opens beside it. In the next iPad build, Approvals works the same way too (it reads Choose an item, and an item no longer opens as a panel over the list), the row you opened stays highlighted in the list, and selecting another row replaces what is beside the list instead of adding a Back to it. When the iPad shows ONYX1 in a narrow window, such as Split View, the list and the page share one column and Back returns to the list, as on an iPhone. Home, Today and Timesheets do not split into a list and a page. They use the extra width instead: with the iPad held sideways, Today shows your clock beside your jobs. In the next iPad build, the rest of Today joins those two columns: Report an incident sits under your clock, and Coming up this week and Large buttons for gloves sit under your jobs.
- A job on an iPad. When there is room, the job's details, site, contacts and crew sit in a column beside the page, so they stay in view as you move between its tabs.
- Android tablet. The Android app shows the same layout as ONYX1 in a browser. On a tablet wide enough for the computer layout, in either orientation, you get the sidebar and top bar described above, not the phone tab bar. A small tablet held upright, and a phone turned sideways, keep the phone layout.
Home
Home is tailored to your view. Business users see the work that needs attention, today's people and jobs, current clock-ins, upcoming due work and the money loop. Crew users see their live clock, today's assigned jobs, filing tasks and certificates or gear due. Crew Home does not show company money or business totals. See How ONYX1 works for the Home cards and workflow.
Search
Select the search box, press / anywhere outside a text box, or press ⌘K on a Mac (Ctrl+K on Windows).
- Start typing to filter quick actions and every page you can open.
- After 2 characters, ONYX1 also searches the jobs, customers, quotes and invoices you are allowed to see, plus the help articles.
- Help centre is always in the list.
Notifications
The bell opens Notifications. Select a notification to open what it is about; that also marks it read. Mark all read clears the list, and Show read brings back the ones you have read.
Turn on the switch in the Push on this phone or Push on this computer line (it reads Off until it is on) for alerts on the device you are using. On an iPhone, use the ONYX1 app for push alerts. On an iPad, push alerts work after you add the browser version to your home screen. See Install ONYX1 on your phone.
When this device shows On, select Send a test notification to send a test push to every device registered to your account. Each result names the push service, not its endpoint, and shows accepted (HTTP status) when the service accepts the push; refused (HTTP status: reason) with a short reason when available, or refused (no HTTP status: reason) when the service gives no HTTP response; gone (HTTP status), subscription removed when the service no longer recognises that subscription; timed out when the request reaches its time limit; or Push sending is not configured on the server when ONYX1 has no push credentials. An accepted result does not confirm that your device displayed the notification.
Settings, your account and Help
- My account is in the menu that opens when you select your name at the bottom of the sidebar on a computer, and in your account row on a phone. Everyone can change their own password and set up two-factor authentication there.
- Settings is for workspace settings and the price book. It appears for owners and admins, and for dispatcher and office users who can manage the price book. On a phone or a narrow screen, owners and admins see a grouped list of categories. On a wide screen, owners and admins start in the first category with the categories in a left rail. Dispatcher and office users go straight to Price book without that rail.
- Open Help from the menu that opens when you select your name at the bottom of the sidebar, the More menu, Help centre in search or the ? beside a page title. In a browser, Help opens in a new tab so ONYX1 stays open behind it. In the app, it opens inside the app.
In the help centre, results appear as you type in the search box at the top. Use Show articles for to narrow the topics to owners, the office, crew or, when you are signed in, the ones for your role. On a phone, the More menu lists every topic. To send someone an article, select Share at the top right of the article. It copies the article's public link, and the button reads Copied for a moment. This works in the app too, where there is no address bar. If your device won't let ONYX1 copy, the link appears in a box, already selected, so you can copy it yourself.
