Take the first-run tour

Hilal Software ships with an interactive in-app tour, powered by driver.js, that walks you through every major section the first time you visit it. It’s the fastest way to get oriented after Amazon is connected and your team is in.

In this guide:

  • Trigger the tour
  • Move through the steps
  • Replay any tour later
  • Hide the global help icon while a tour runs

Prerequisites

  • You’ve completed steps 1–5 of the Getting started guide.
  • The first-run tour fires automatically the first time you open each section. If you’ve dismissed it, you can replay it manually.

Step 1: Trigger the tour

The tour fires automatically the first time you open a section that has one. To run it manually:

  1. Open the section (Dashboard, Inventory, Advertising, etc.).
  2. Click the ? help icon in the top-right of the page.
  3. Click Take the tour.

The tour takes over the page with a translucent overlay and a series of callouts pointing at the UI.

Step 2: Move through the steps

Each tour step has:

  • A callout pointing at the relevant UI element with a short explanation.
  • Next / Back buttons.
  • A progress dot row at the bottom showing where you are.
  • An optional embedded video for steps that benefit from a moving demo (signaled by a play icon in the callout).

Press Esc at any time to exit the tour. Hilal remembers you exited (in a cookie) so it won’t auto-fire that tour again — you can still replay manually from the help menu.

Step 3: Replay any tour later

Tours are stored per-section. To replay:

  1. Open the section.
  2. Click ?Take the tour.

The dismissal cookie is keyed per tour, so replaying one doesn’t reset the others.

Step 4: Hide the global help icon while a tour runs

If you’re recording your screen, presenting, or just want a clean view, the global help icon hides automatically while a tour is active. It reappears when you exit. There’s no setting to toggle this — it’s automatic.

Available tours

The first-run tour exists for the major sections. Quick guide to what each covers:

SectionWhat the tour covers
DashboardKPI tiles, the trend chart, the date filter, the quick-actions panel.
InventoryThe list view, filters, the per-SKU detail page, low-stock alerts.
AdvertisingThe campaign list, the region filter, performance columns, edit mode.
Customer HubEmail automations, review monitoring, AI customer assistant.
FinancesExpenses, P&L builder, the exporter.
AIAI Chat, NL2SQL, the prompt manager.
SettingsMembers, integrations, marketplaces, subscription.

Troubleshooting

  • The tour doesn’t start. Check that you’re on a section that has one. Some smaller pages (Settings → Profile, individual SKU pages) don’t have a tour.
  • The callout points at the wrong element. Layout shifted while the tour was loading. Refresh and try again.
  • The video in a tour step won’t play. YouTube embeds require third-party cookies — if your browser blocks them, the inline video won’t load. Click the YouTube link in the callout to open it in a new tab.

What’s next

You’re done with onboarding. Pick a section and explore — every Guide article is task-oriented, so jump to whichever job is in front of you.