Skip to content

armgit / macro

Public Imported from GitHub
0

Macro is a unified workspace for teams: email, chat, docs, tasks, agents, calls, and CRM — @-linked together with shared AI memory.

feat(website): add Block tutorial videos to product pages and docs (#9917)

Jacob Beckerman31d6da9980ca
diff --git a/apps/docs/AGENTS.md b/apps/docs/AGENTS.md
index adcd5f5597..19994a708c 100644
--- a/apps/docs/AGENTS.md
+++ b/apps/docs/AGENTS.md
@@ -37,6 +37,7 @@ expose.
- Bold for UI elements: Click **Settings**
- Code formatting for file names, commands, paths, and code references
- Keyboard shortcuts use `<kbd>` tags, e.g. press <kbd>g</kbd> + <kbd>h</kbd>
+- Block tutorial videos embed from `https://macro.com/video/tutorials/<id>.mp4` (with `<id>-poster.jpg`), the copy the website publishes from `apps/marketing/public/video/tutorials/`; don't commit them here
- Product UI in the guides uses the same light cards as Unified Tagging (`.search-preview` and `.tag-mock` in `style.css`). Diagrams and brand graphics stay in `images/` and need descriptive alt text — never the filename
## Content boundaries
diff --git a/apps/docs/integrations/github.mdx b/apps/docs/integrations/github.mdx
index 20557bb31c..673a31c695 100644
--- a/apps/docs/integrations/github.mdx
+++ b/apps/docs/integrations/github.mdx
@@ -6,6 +6,10 @@ description: "Link pull requests to tasks and let task statuses update themselve
Macro integrates with GitHub so your tasks stay in sync with the code that closes them. To connect, link your GitHub account in **Settings → Integrations**.
+Watch a 1:01 walkthrough of Macro with GitHub.
+
+<video src="https://macro.com/video/tutorials/github.mp4" poster="https://macro.com/video/tutorials/github-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
### Tasks that track your PRs
Create a branch for a task and Macro keeps the task's status up to date automatically: **In Progress** when you create the branch, **In Review** when you open the pull request, and **Completed** when it merges.
diff --git a/apps/docs/product/agents.mdx b/apps/docs/product/agents.mdx
index d8b50f01dd..1f53c2d4cf 100644
--- a/apps/docs/product/agents.mdx
+++ b/apps/docs/product/agents.mdx
@@ -49,6 +49,10 @@ description: "Agents that live inside your workspace — with full context on yo
Macro agents live and work inside your workspace, so one prompt can reach your email, tasks, docs, calls, channels, and connected tools. They can search and read anything you can see, draft emails and documents, create and update tasks, post in channels, and run on a schedule. Everything they do is attributed to you and bounded by your permissions.
+Watch a 1:05 walkthrough of Macro Agents.
+
+<video src="https://macro.com/video/tutorials/agents.mp4" poster="https://macro.com/video/tutorials/agents-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
### The Agents workspace
Agents lists every conversation you've had, named automatically from your first message, and you can pick any of them back up where you left off. Ask for summaries, clarifications, drafts, or a status check. Agents answer using everything in your workspace, not just the current thread.
diff --git a/apps/docs/product/booking-links.mdx b/apps/docs/product/booking-links.mdx
index 0515a07d0e..22f225d3f3 100644
--- a/apps/docs/product/booking-links.mdx
+++ b/apps/docs/product/booking-links.mdx
@@ -49,6 +49,10 @@ A booking link is a public page where guests book a meeting on your calendar. Gu
Booking links require a connected [calendar](/product/calendar).
+Watch a 0:44 walkthrough of booking links in Macro.
+
+<video src="https://macro.com/video/tutorials/scheduling.mp4" poster="https://macro.com/video/tutorials/scheduling-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
## Creating a booking link
1. Open **Settings → Booking links**, or click **Copy booking link** in the calendar topbar.
diff --git a/apps/docs/product/calendar.mdx b/apps/docs/product/calendar.mdx
index 584e63f271..cfcfae0f5f 100644
--- a/apps/docs/product/calendar.mdx
+++ b/apps/docs/product/calendar.mdx
@@ -52,6 +52,10 @@ Calendar is a Macro Block that syncs with Google Calendar and Outlook. Events ar
Open it from **Calendar** in the sidebar, or press <kbd>g</kbd> \+ <kbd>r</kbd>.
+Watch a 0:54 walkthrough of Macro Calendar.
+
+<video src="https://macro.com/video/tutorials/calendar.mp4" poster="https://macro.com/video/tutorials/calendar-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
### Connecting your calendar
Connect your calendar in **Settings → Calendar**. Click **Connect calendar** next to a Gmail or Outlook account you've already linked, or **Connect account** to add a new Google or Outlook account. You can also click **Enable calendar** next to an account in **Settings → Email**.
diff --git a/apps/docs/product/calls.mdx b/apps/docs/product/calls.mdx
index 9d320fba44..c5b3f4540a 100644
--- a/apps/docs/product/calls.mdx
+++ b/apps/docs/product/calls.mdx
@@ -9,6 +9,10 @@ Macro calls are Macro's own call system, inside your workspace.
To start a call, use the button at the top of the calls tab, or open the channel with the intended participants and press the call button. Participants hear a ring when a call starts.
+Watch a 1:10 walkthrough of Macro Calls.
+
+<video src="https://macro.com/video/tutorials/calls.mp4" poster="https://macro.com/video/tutorials/calls-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
> ### Important Call Sharing Information
>
> Calls started from a channel are shared with your team by default. After the call, team members can open the recording, transcript, and AI summary from **Calls** and search. Standalone calls started from a meeting link are not shared with the team. Only participants have access.
diff --git a/apps/docs/product/channels.mdx b/apps/docs/product/channels.mdx
index c479d850d0..534a1e5929 100644
--- a/apps/docs/product/channels.mdx
+++ b/apps/docs/product/channels.mdx
@@ -6,6 +6,10 @@ description: "Channels and direct messages are where you, your team, and your cu
Open **Chat** in the sidebar, or press <kbd>g</kbd> \+ <kbd>c</kbd>, to see your channels and direct messages.
+Watch a 1:30 walkthrough of Macro Chat.
+
+<video src="https://macro.com/video/tutorials/chat.mp4" poster="https://macro.com/video/tutorials/chat-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
<div className="chat-preview" role="img" aria-label="Messages in the design channel">
<div className="chat-preview-bar">
<svg width="16" height="16" viewBox="0 0 24 24" fill="none" aria-hidden="true">
diff --git a/apps/docs/product/crm.mdx b/apps/docs/product/crm.mdx
index 816f960a58..60cc027703 100644
--- a/apps/docs/product/crm.mdx
+++ b/apps/docs/product/crm.mdx
@@ -6,6 +6,10 @@ description: "Contact and company records built automatically from your team's e
Customers stays off until a team admin turns on **Team CRM** in **Settings → CRM**. **Backfill existing emails** builds records from mail the team already has. **Start from now** uses only mail that arrives after you turn it on. If you are not an admin, Customers says a team owner or admin has to enable it. Turning **Team CRM** off permanently deletes the team's companies, contacts, and their history.
+Watch a 1:26 walkthrough of Macro CRM.
+
+<video src="https://macro.com/video/tutorials/crm.mp4" poster="https://macro.com/video/tutorials/crm-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
## How email fills the CRM
CRM reads the account marked **Primary** in **Settings → Email**. A second account you connect does not. Mail you send from the primary account to someone outside that account's domain creates a contact, and everyone at that domain shares one company. Mail you only receive does not create a company. Once the company exists, later mail moves **Last Interaction**, including replies and other people at that domain. Generic tool and vendor domains are left out.
diff --git a/apps/docs/product/docs.mdx b/apps/docs/product/docs.mdx
index 0c12e0434a..e68cc2e51f 100644
--- a/apps/docs/product/docs.mdx
+++ b/apps/docs/product/docs.mdx
@@ -6,6 +6,10 @@ description: "Markdown-native, fast, collaborative, and @linked documents."
Documents are markdown-native text files that are tied to the rest of your workspace with @mentions. They can be organized in folders like a traditional file system (see [Folders](/product/drive)) and enriched with tags.
+Watch a 1:46 walkthrough of Macro Docs.
+
+<video src="https://macro.com/video/tutorials/docs.mp4" poster="https://macro.com/video/tutorials/docs-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
Macro does not permit nesting of documents-within-documents-within-documents; all documents are stored somewhere, whether that be at the root-level or in a folder. The primary way of sharing documents is by hitting `Share` or @linking them in a message. To see your documents and files shared with you, go to [Drive](/product/drive).
<video src="/videos/Macro-Markdown-Demo.mp4" controls />
diff --git a/apps/docs/product/drive.mdx b/apps/docs/product/drive.mdx
index 94c14592d9..4459c49c66 100644
--- a/apps/docs/product/drive.mdx
+++ b/apps/docs/product/drive.mdx
@@ -6,6 +6,10 @@ description: "Store, organize, and share documents and files."
Drive contains the documents and files in your workspace: docs, databases, spreadsheets, canvases, PDFs, images, videos, code files, and uploads.
+Watch a 1:29 walkthrough of Macro Drive.
+
+<video src="https://macro.com/video/tutorials/drive.mp4" poster="https://macro.com/video/tutorials/drive-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
Attachments shared in channels are imported to Drive. Email attachments are extracted to Drive, but they stay out of the list until you filter for them. Choose **Filter → Files → Email attachments**. **Default**, which Drive uses until you change it, hides them. Everything in Drive is searchable from [unified search](/product/search).
<CardGroup cols={2}>
diff --git a/apps/docs/product/email.mdx b/apps/docs/product/email.mdx
index 5aa1c212e1..5158d46ebc 100644
--- a/apps/docs/product/email.mdx
+++ b/apps/docs/product/email.mdx
@@ -8,6 +8,10 @@ description: "Keyboard-driven email with Gmail and Outlook sync."
Email is one of Macro's core Blocks, which is why we recommend linking your account at signup. Connect Gmail or Outlook / Microsoft 365. In Macro you can triage your email normally while also using our Signal/Noise filtering and an agent to draft and send emails.
+Watch a 1:42 walkthrough of Macro Mail.
+
+<video src="https://macro.com/video/tutorials/mail.mp4" poster="https://macro.com/video/tutorials/mail-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
<div className="signal-preview" role="img" aria-label="Signal, with Invoice question selected">
<div className="signal-preview-bar">
<span className="signal-preview-title">Inbox</span>
diff --git a/apps/docs/product/home.mdx b/apps/docs/product/home.mdx
index fbd82a2b5f..707fa2e753 100644
--- a/apps/docs/product/home.mdx
+++ b/apps/docs/product/home.mdx
@@ -8,6 +8,10 @@ Home is where you check everything in your workspace. It is not only notificatio
A document you recently edited shows up here, even when nobody mentioned you. Email you sent, tasks you updated, and agent chats you started show up the same way. Home also includes email, messages, @mentions, tasks, and agent activity that need a look.
+Watch a 1:00 walkthrough of Macro Home.
+
+<video src="https://macro.com/video/tutorials/home.mp4" poster="https://macro.com/video/tutorials/home-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
<div className="home-start" role="img" aria-label="What should we work on?">
<div className="home-start-greeting">
<svg width="36" height="36" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true">
diff --git a/apps/docs/product/tasks.mdx b/apps/docs/product/tasks.mdx
index e005c81ceb..a49886979f 100644
--- a/apps/docs/product/tasks.mdx
+++ b/apps/docs/product/tasks.mdx
@@ -8,6 +8,10 @@ description: "Track work with priorities, statuses, and linked context."
Macro Tasks start lightweight enough for a single user but scale easily onto a team, where tasks you create are auto-shared with members. They're @mentionable anywhere in Macro as live, up-to-date pills, sync bidirectionally with GitHub PRs to move status automatically, and are fully accessible to AI clients via Macro's MCP server.
+Watch a 1:57 walkthrough of Macro Tasks.
+
+<video src="https://macro.com/video/tutorials/tasks.mp4" poster="https://macro.com/video/tutorials/tasks-poster.jpg" controls playsInline preload="metadata" className="w-full aspect-video rounded-xl" />
+
<div className="task-list" role="img" aria-label="A task list. Fix the mobile signup button is in review and linked to pull request 184.">
<div className="task-list-head">
<span>Task</span>
diff --git a/apps/marketing/README.md b/apps/marketing/README.md
index 67bd6d4abb..e7f2783bc6 100644
--- a/apps/marketing/README.md
+++ b/apps/marketing/README.md
@@ -472,6 +472,22 @@ FAQ answers and the always-visible comparison are rendered in the initial HTML.
The CRM comparison appears above the FAQ, using the shared product table styling.
Retain FAQ class markers so prerendering emits matching FAQPage structured data.
+## Tutorial videos
+
+Product heroes put **Watch demo** beside Get started (`ProductHero`'s
+`tutorial`, and the Email hero). It opens `TutorialVideoDialog`: the app's
+Block tutorial, paused behind the app's play pill (play disc, presenter, "Watch
+demo · m:ss") until the visitor presses it. Escape and the backdrop close it,
+and focus returns to the button. Titles and lengths in
+`core/tutorial-videos.ts` copy the app's `tutorials` messages; change both
+together.
+
+The videos and posters live once, in `public/video/tutorials/` (mp4s through
+Git LFS), and deploy to `macro.com/video/tutorials/`. docs.macro.com embeds
+them from there, including Blocks without a page here (Home, Drive, Calendar,
+Scheduling). Replacing a video keeps its name; the deploy's `--size-only` sync
+skips a same-size file, and CloudFront caches videos for a day.
+
## Paid-social landing page
`/tour` (`features/marketing/views/SalesPage.tsx`) is the Instagram ad landing
diff --git a/apps/marketing/public/video/tutorials/agents-poster.jpg b/apps/marketing/public/video/tutorials/agents-poster.jpg
new file mode 100644
index 0000000000..1f06ecdca1
Binary files /dev/null and b/apps/marketing/public/video/tutorials/agents-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/agents.mp4 b/apps/marketing/public/video/tutorials/agents.mp4
new file mode 100644
index 0000000000..b26dcfd7b5
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/agents.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:21f98309d2dfcbbb22877cc3cca9433977c1088b5b0c71daed5563e9013e2c8d
+size 5989688
diff --git a/apps/marketing/public/video/tutorials/calendar-poster.jpg b/apps/marketing/public/video/tutorials/calendar-poster.jpg
new file mode 100644
index 0000000000..f44067beaf
Binary files /dev/null and b/apps/marketing/public/video/tutorials/calendar-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/calendar.mp4 b/apps/marketing/public/video/tutorials/calendar.mp4
new file mode 100644
index 0000000000..215a9c0abc
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/calendar.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e56790dabb37ce8a681c0b45906c85bb792515bd641e852262bb8bd8b559f688
+size 4448041
diff --git a/apps/marketing/public/video/tutorials/calls-poster.jpg b/apps/marketing/public/video/tutorials/calls-poster.jpg
new file mode 100644
index 0000000000..2502359f29
Binary files /dev/null and b/apps/marketing/public/video/tutorials/calls-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/calls.mp4 b/apps/marketing/public/video/tutorials/calls.mp4
new file mode 100644
index 0000000000..b99bc182a4
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/calls.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:90bb7166238f49621645969ad836ceefa1d03d7d2b94126b89e64c69b2cb99a8
+size 7303325
diff --git a/apps/marketing/public/video/tutorials/chat-poster.jpg b/apps/marketing/public/video/tutorials/chat-poster.jpg
new file mode 100644
index 0000000000..0a26ccff4a
Binary files /dev/null and b/apps/marketing/public/video/tutorials/chat-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/chat.mp4 b/apps/marketing/public/video/tutorials/chat.mp4
new file mode 100644
index 0000000000..28883a17a2
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/chat.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ba4794cae2f3ce0af3870edb0e389a8110df13e2efe2f3df2c4d1a51157d4562
+size 6818262
diff --git a/apps/marketing/public/video/tutorials/crm-poster.jpg b/apps/marketing/public/video/tutorials/crm-poster.jpg
new file mode 100644
index 0000000000..3f2e9852c7
Binary files /dev/null and b/apps/marketing/public/video/tutorials/crm-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/crm.mp4 b/apps/marketing/public/video/tutorials/crm.mp4
new file mode 100644
index 0000000000..1fc20db65b
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/crm.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:d8309d073df59c8f04dd75571072c57b76aeba711b822fbb8ae753e8d33531f0
+size 6894716
diff --git a/apps/marketing/public/video/tutorials/docs-poster.jpg b/apps/marketing/public/video/tutorials/docs-poster.jpg
new file mode 100644
index 0000000000..0504c46e5b
Binary files /dev/null and b/apps/marketing/public/video/tutorials/docs-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/docs.mp4 b/apps/marketing/public/video/tutorials/docs.mp4
new file mode 100644
index 0000000000..729d8ba886
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/docs.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:c335172fc6883309510cb4b9c2a231b8cd4a5e83723fcb7f68055b5765732ce0
+size 5564020
diff --git a/apps/marketing/public/video/tutorials/drive-poster.jpg b/apps/marketing/public/video/tutorials/drive-poster.jpg
new file mode 100644
index 0000000000..24c6790b7f
Binary files /dev/null and b/apps/marketing/public/video/tutorials/drive-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/drive.mp4 b/apps/marketing/public/video/tutorials/drive.mp4
new file mode 100644
index 0000000000..332d87abb5
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/drive.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6d6857f166b6cd2419d5ea695f754076bec79d82d9c5a74106b3c4e35eb993de
+size 7185446
diff --git a/apps/marketing/public/video/tutorials/github-poster.jpg b/apps/marketing/public/video/tutorials/github-poster.jpg
new file mode 100644
index 0000000000..1a76022504
Binary files /dev/null and b/apps/marketing/public/video/tutorials/github-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/github.mp4 b/apps/marketing/public/video/tutorials/github.mp4
new file mode 100644
index 0000000000..2d4fd7309e
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/github.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5b5e6971d71d7cca93de8500b99a97220bab2ab4a87b7b0dc888bb58bfb7949b
+size 4900331
diff --git a/apps/marketing/public/video/tutorials/home-poster.jpg b/apps/marketing/public/video/tutorials/home-poster.jpg
new file mode 100644
index 0000000000..d97d1354cf
Binary files /dev/null and b/apps/marketing/public/video/tutorials/home-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/home.mp4 b/apps/marketing/public/video/tutorials/home.mp4
new file mode 100644
index 0000000000..4478af665f
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/home.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:ac6c293657e3069c2a1556d08df66cd254beec482d93e9592cf0853f4d052d3c
+size 4610889
diff --git a/apps/marketing/public/video/tutorials/mail-poster.jpg b/apps/marketing/public/video/tutorials/mail-poster.jpg
new file mode 100644
index 0000000000..473b857a10
Binary files /dev/null and b/apps/marketing/public/video/tutorials/mail-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/mail.mp4 b/apps/marketing/public/video/tutorials/mail.mp4
new file mode 100644
index 0000000000..398cefbd7b
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/mail.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:50d74540f6aa4b299ca83004b4baf10ed99469623197186d2f0d29a56e7051e5
+size 9518280
diff --git a/apps/marketing/public/video/tutorials/scheduling-poster.jpg b/apps/marketing/public/video/tutorials/scheduling-poster.jpg
new file mode 100644
index 0000000000..29baba0baa
Binary files /dev/null and b/apps/marketing/public/video/tutorials/scheduling-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/scheduling.mp4 b/apps/marketing/public/video/tutorials/scheduling.mp4
new file mode 100644
index 0000000000..44d1f481ac
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/scheduling.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:85d7f1247d4ebd2c0284f2a91089f20ca178a2865a8094a6abe606be8dd8a948
+size 4911947
diff --git a/apps/marketing/public/video/tutorials/tasks-poster.jpg b/apps/marketing/public/video/tutorials/tasks-poster.jpg
new file mode 100644
index 0000000000..38b35ec5cb
Binary files /dev/null and b/apps/marketing/public/video/tutorials/tasks-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/tasks.mp4 b/apps/marketing/public/video/tutorials/tasks.mp4
new file mode 100644
index 0000000000..084f483527
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/tasks.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3d7d6fd1fcbeead58ff08b361f6b1b57b9dcf077b185de23eea9e4898d87b19c
+size 9432873
diff --git a/apps/marketing/public/video/tutorials/whatsapp-poster.jpg b/apps/marketing/public/video/tutorials/whatsapp-poster.jpg
new file mode 100644
index 0000000000..61e9a4389a
Binary files /dev/null and b/apps/marketing/public/video/tutorials/whatsapp-poster.jpg differ
diff --git a/apps/marketing/public/video/tutorials/whatsapp.mp4 b/apps/marketing/public/video/tutorials/whatsapp.mp4
new file mode 100644
index 0000000000..2595730e93
--- /dev/null
+++ b/apps/marketing/public/video/tutorials/whatsapp.mp4
@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:16ce5760f52ec9c80496cb271c6713b6806d4eefab1991bf73ce89829e62a0b4
+size 4677975
diff --git a/apps/marketing/src/app/routes/RouteCrm.tsx b/apps/marketing/src/app/routes/RouteCrm.tsx
index d4ba0c9015..ebf4f326b5 100644
--- a/apps/marketing/src/app/routes/RouteCrm.tsx
+++ b/apps/marketing/src/app/routes/RouteCrm.tsx
@@ -113,6 +113,7 @@ export function RouteCrm() {
'from emails, calls, chats, and tasks.',
]}
cta="crm_hero_get_started"
+ tutorial="crm"
/>
<WorkspaceDesktopDemo
heroFrame
diff --git a/apps/marketing/src/app/routes/RouteEmail.tsx b/apps/marketing/src/app/routes/RouteEmail.tsx
index 1f4e0ba595..3ed8d9808f 100644
--- a/apps/marketing/src/app/routes/RouteEmail.tsx
+++ b/apps/marketing/src/app/routes/RouteEmail.tsx
@@ -19,6 +19,7 @@ import {
} from '../../features/marketing/components/FeaturePage';
import { HomepageClosing } from '../../features/marketing/components/HomepageClosing';
import { ProductBrand } from '../../features/marketing/components/product/ProductPage';
+import { TutorialVideoDialog } from '../../features/marketing/components/TutorialVideoDialog';
import { setPageSeo } from '../utils/utilSeo';
import '../../features/marketing/components/email/email-hero.css';
@@ -123,7 +124,10 @@ export function RouteEmail() {
Keep your inbox clean, move through emails quickly, and have agents
draft good replies.
</p>
- <FeaturePageCta name="email_hero_get_started" />
+ <div class="feature-page-hero-actions">
+ <FeaturePageCta name="email_hero_get_started" />
+ <TutorialVideoDialog tutorial="mail" />
+ </div>
</header>
<EmailDesktopDemo />
<nav
diff --git a/apps/marketing/src/app/routes/RouteTasks.tsx b/apps/marketing/src/app/routes/RouteTasks.tsx
index 0e9d2f46da..c53605793f 100644
--- a/apps/marketing/src/app/routes/RouteTasks.tsx
+++ b/apps/marketing/src/app/routes/RouteTasks.tsx
@@ -90,6 +90,7 @@ export function RouteTasks() {
<div class="tasks-page">
<ProductHero
cta="tasks_hero_get_started"
+ tutorial="tasks"
product="Tasks"
title={['Task tracking without', 'the busywork.']}
description={[
diff --git a/apps/marketing/src/assets/people/tutorial-presenter.jpg b/apps/marketing/src/assets/people/tutorial-presenter.jpg
new file mode 100644
index 0000000000..189c66fbdf
Binary files /dev/null and b/apps/marketing/src/assets/people/tutorial-presenter.jpg differ
diff --git a/apps/marketing/src/features/marketing/components/TutorialVideoDialog.test.tsx b/apps/marketing/src/features/marketing/components/TutorialVideoDialog.test.tsx
new file mode 100644
index 0000000000..f1ef9f53a9
--- /dev/null
+++ b/apps/marketing/src/features/marketing/components/TutorialVideoDialog.test.tsx
@@ -0,0 +1,81 @@
+import {
+ cleanup,
+ fireEvent,
+ render,
+ screen,
+ waitFor,
+} from '@solidjs/testing-library';
+import { afterEach, beforeEach, expect, it, vi } from 'vitest';
+import { TutorialVideoDialog } from './TutorialVideoDialog';
+
+const analytics = vi.hoisted(() => ({ track: vi.fn() }));
+vi.mock('../../../app/utils/utilAnalytic', () => ({ analytics }));
+
+const play = vi.fn();
+
+beforeEach(() => {
+ // JSDOM has no media playback; stand in for the browser starting the video.
+ play.mockImplementation(function (this: HTMLVideoElement) {
+ this.dispatchEvent(new Event('play'));
+ return Promise.resolve();
+ });
+ HTMLMediaElement.prototype.play = play;
+ vi.spyOn(window, 'scrollTo').mockImplementation(() => {});
+ // JSDOM has no default animation-name; presence detection expects `none`.
+ const styles = document.createElement('style');
+ styles.textContent = '* { animation-name: none; }';
+ styles.id = 'test-animation-default';
+ document.head.append(styles);
+});
+
+afterEach(() => {
+ cleanup();
+ document.getElementById('test-animation-default')?.remove();
+ vi.restoreAllMocks();
+ vi.clearAllMocks();
+});
+
+const openDialog = async () => {
+ const trigger = screen.getByRole('button', { name: /Watch demo/ });
+ fireEvent.click(trigger);
+ await screen.findByRole('dialog');
+ return trigger;
+};
+
+it('opens the video paused and plays only from the play pill', async () => {
+ render(() => <TutorialVideoDialog tutorial="mail" />);
+ await openDialog();
+
+ const dialog = screen.getByRole('dialog', {
+ name: 'Learn how to use Macro Mail',
+ });
+ const video = dialog.querySelector('video');
+ expect(video?.getAttribute('src')).toBe('/video/tutorials/mail.mp4');
+ expect(video?.autoplay).toBe(false);
+ expect(play).not.toHaveBeenCalled();
+
+ fireEvent.click(
+ screen.getByRole('button', {
+ name: 'Play Learn how to use Macro Mail, 1:42',
+ })
+ );
+
+ expect(play).toHaveBeenCalledOnce();
+ expect(screen.queryByRole('button', { name: /^Play Learn how/ })).toBeNull();
+ expect(analytics.track).toHaveBeenCalledWith(
+ 'tutorial_video',
+ expect.objectContaining({ tutorial: 'macro-mail', action: 'played' })
+ );
+});
+
+it('closes on Escape and returns focus to Watch demo', async () => {
+ render(() => <TutorialVideoDialog tutorial="tasks" />);
+ const trigger = await openDialog();
+ const close = screen.getByRole('button', { name: 'Close video' });
+ await waitFor(() => expect(document.activeElement).toBe(close));
+
+ fireEvent.keyDown(close, { key: 'Escape' });
+
+ await waitFor(() => expect(screen.queryByRole('dialog')).toBeNull());
+ await waitFor(() => expect(document.activeElement).toBe(trigger));
+});
diff --git a/apps/marketing/src/features/marketing/components/TutorialVideoDialog.tsx b/apps/marketing/src/features/marketing/components/TutorialVideoDialog.tsx
new file mode 100644
index 0000000000..01e48ef8a2
--- /dev/null
+++ b/apps/marketing/src/features/marketing/components/TutorialVideoDialog.tsx
@@ -0,0 +1,139 @@
+import { Dialog } from '@kobalte/core/dialog';
+import X from '@phosphor/x.svg';
+import Play from '@phosphor-fill/play-fill.svg';
+import { createSignal, Show } from 'solid-js';
+import { analytics } from '../../../app/utils/utilAnalytic';
+import presenterPhoto from '../../../assets/people/tutorial-presenter.jpg';
+import {
+ TUTORIAL_PRESENTER,
+ TUTORIAL_VIDEOS,
+ type TutorialVideoId,
+ tutorialPosterUrl,
+ tutorialVideoUrl,
+} from '../core/tutorial-videos';
+import './tutorial-video-dialog.css';
+
+/** The app's play disc: a translucent circle with a rounded white triangle. */
+function PlayDisc() {
+ return (
+ <svg viewBox="0 0 96 96" aria-hidden="true" class="tutorial-video-disc">
+ <circle cx="48" cy="48" r="48" fill="white" fill-opacity="0.16" />
+ <path
+ d="M39 32 L67 48 L39 64 Z"
+ fill="white"
+ stroke="white"
+ stroke-width="6"
+ stroke-linejoin="round"
+ />
+ </svg>
+ );
+}
+
+/**
+ * A "Watch demo" button that opens the Block's tutorial video in a dialog,
+ * paused behind the app's play pill until the visitor presses it.
+ */
+export function TutorialVideoDialog(props: { tutorial: TutorialVideoId }) {
+ const [open, setOpen] = createSignal(false);
+ const [started, setStarted] = createSignal(false);
+ let video: HTMLVideoElement | undefined;
+ let playRecorded = false;
+
+ const tutorial = () => TUTORIAL_VIDEOS[props.tutorial];
+
+ const track = (action: 'opened' | 'played') => {
+ analytics.track('tutorial_video', {
+ tutorial: `macro-${props.tutorial}`,
+ action,
+ page_location: window.location.href,
+ });
+ };
+
+ const changeOpen = (value: boolean) => {
+ setStarted(false);
+ playRecorded = false;
+ setOpen(value);
+ if (value) track('opened');
+ };
+
+ const play = async () => {
+ if (!video) return;
+ setStarted(true);
+ // The pill unmounts, so the video takes focus and keeps Space working.
+ video.focus();
+ try {
+ await video.play();
+ } catch {
+ // Playback was refused; bring the play pill back.
+ setStarted(false);
+ }
+ };
+
+ const recordPlay = () => {
+ setStarted(true);
+ if (playRecorded) return;
+ playRecorded = true;
+ track('played');
+ };
+
+ return (
+ <Dialog open={open()} onOpenChange={changeOpen} modal>
+ <Dialog.Trigger class="site-nav-demo tutorial-video-trigger">
+ <Play aria-hidden="true" />
+ <span>Watch demo</span>
+ <span class="tutorial-video-trigger-length">{tutorial().length}</span>
+ </Dialog.Trigger>
+ <Dialog.Portal>
+ <Dialog.Overlay class="tutorial-video-overlay" />
+ <Dialog.Content class="tutorial-video-dialog">
+ <header class="tutorial-video-titlebar">
+ <Dialog.Title>{tutorial().title}</Dialog.Title>
+ <Dialog.CloseButton
+ class="tutorial-video-close"
+ aria-label="Close video"
+ >
+ <X />
+ </Dialog.CloseButton>
+ </header>
+ <div class="tutorial-video-stage">
+ <video
+ ref={video}
+ src={tutorialVideoUrl(props.tutorial)}
+ poster={tutorialPosterUrl(props.tutorial)}
+ preload="metadata"
+ playsinline
+ tabIndex={-1}
+ controls={started()}
+ onPlay={recordPlay}
+ />
+ <Show when={!started()}>
+ {/* The dimmed poster also plays on a click; the pill is the
+ button keyboards and screen readers use. */}
+ <button
+ type="button"
+ tabIndex={-1}
+ aria-hidden="true"
+ class="tutorial-video-scrim"
+ onClick={play}
+ />
+ <button
+ type="button"
+ class="tutorial-video-play"
+ aria-label={`Play ${tutorial().title}, ${tutorial().length}`}
+ onClick={play}
+ >
+ <PlayDisc />
+ <span class="tutorial-video-divider" aria-hidden="true" />
+ <img src={presenterPhoto} alt="" />
+ <span class="tutorial-video-byline">
+ <span>{TUTORIAL_PRESENTER}</span>
+ <span>Watch demo · {tutorial().length}</span>
+ </span>
+ </button>
+ </Show>
+ </div>
+ </Dialog.Content>
+ </Dialog.Portal>
+ </Dialog>
+ );
+}
diff --git a/apps/marketing/src/features/marketing/components/email/email-hero.css b/apps/marketing/src/features/marketing/components/email/email-hero.css
index aaf8d373ad..791c4e474c 100644
--- a/apps/marketing/src/features/marketing/components/email/email-hero.css
+++ b/apps/marketing/src/features/marketing/components/email/email-hero.css
@@ -53,10 +53,19 @@
}
.email-page-hero .feature-page-cta {
- margin-top: 28px;
padding-inline: 26px;
}
+/* Get started, then the Block's "Watch demo" tutorial. */
+.feature-page-hero-actions {
+ display: flex;
+ flex-wrap: wrap;
+ align-items: center;
+ justify-content: center;
+ gap: 12px;
+ margin-top: 28px;
+}
+
@media (max-width: 699px) {
.feature-page .email-page-hero {
padding: 114px 18px 44px;
diff --git a/apps/marketing/src/features/marketing/components/feature-page.css b/apps/marketing/src/features/marketing/components/feature-page.css
index 3121a2959f..3fc2d4fb62 100644
--- a/apps/marketing/src/features/marketing/components/feature-page.css
+++ b/apps/marketing/src/features/marketing/components/feature-page.css
@@ -13,7 +13,6 @@
.feature-page-hero h1 { margin: 18px 0 24px; font: calc(315 + var(--cream-slab-weight-increase, 0)) clamp(40px, 5.4vw, 68px)/1.12 'Roboto Slab Variable', display, serif; letter-spacing: -.035em; text-wrap: balance; }
.feature-page-hero > p:not(.feature-page-eyebrow) { max-width: 460px; color: var(--color-ink-muted); font-size: 16px; line-height: 1.8; text-wrap: balance; }
.feature-page .feature-page-cta { color: #1d1c1a; }
-.feature-page-hero .feature-page-cta { margin-top: 32px; }
.feature-page-hero > small { display: block; margin-top: 18px; color: var(--color-ink-subtle); font-size: 11px; }
.feature-page-jump-links { display: grid; grid-template-columns: repeat(4, minmax(0, 1fr)); gap: 0; padding: 28px 0 32px; border-block: 1px solid color-mix(in srgb, var(--color-ink) 10%, transparent); }
.feature-page-jump-links a { display: flex; flex-direction: column; align-items: center; gap: 16px; text-align: center; color: var(--color-ink-muted); font-size: 12px; text-decoration: none; }
diff --git a/apps/marketing/src/features/marketing/components/product-page-preview.css b/apps/marketing/src/features/marketing/components/product-page-preview.css
index f1d1c8ca7b..2119223f33 100644
--- a/apps/marketing/src/features/marketing/components/product-page-preview.css
+++ b/apps/marketing/src/features/marketing/components/product-page-preview.css
@@ -2,6 +2,6 @@
body:has(.feature-page[data-product-preview='true']) .site-header,
body:has(.feature-page[data-product-preview='true']) .site-page-vignette,
.feature-page[data-product-preview='true'] .homepage-feature-end,
-.feature-page[data-product-preview='true'] .feature-page-cta { display: none; }
+.feature-page[data-product-preview='true'] .feature-page-hero-actions { display: none; }
.feature-page[data-product-preview='true'] .feature-page-hero { padding-top: 64px; padding-bottom: 32px; }
.feature-page[data-product-preview='true'] .feature-page-section { scroll-margin-top: 16px; }
diff --git a/apps/marketing/src/features/marketing/components/product/ProductPage.tsx b/apps/marketing/src/features/marketing/components/product/ProductPage.tsx
index 94c7524d03..090d017435 100644
--- a/apps/marketing/src/features/marketing/components/product/ProductPage.tsx
+++ b/apps/marketing/src/features/marketing/components/product/ProductPage.tsx
@@ -1,7 +1,9 @@
import MacroLogo from '@icon/macro-logo.svg';
import { type JSX, type ParentProps, Show } from 'solid-js';
+import type { TutorialVideoId } from '../../core/tutorial-videos';
import { DemoInteractionBoundary } from '../DemoInteractionBoundary';
import { FeaturePage, FeaturePageCta } from '../FeaturePage';
+import { TutorialVideoDialog } from '../TutorialVideoDialog';
import '../email/email-hero.css';
import './product-page.css';
import './product-demo-stage.css';
@@ -39,6 +41,8 @@ export function ProductHero(props: {
title: readonly [string, string];
description: string | readonly [string, string];
cta?: string;
+ /** The Block tutorial that "Watch demo" opens beside the CTA. */
+ tutorial?: TutorialVideoId;
}) {
return (
<header class="feature-page-hero email-page-hero">
@@ -57,7 +61,12 @@ export function ProductHero(props: {
</>
)}
</p>
- <Show when={props.cta}>{(cta) => <FeaturePageCta name={cta()} />}</Show>
+ <div class="feature-page-hero-actions">
+ <Show when={props.cta}>{(cta) => <FeaturePageCta name={cta()} />}</Show>
+ <Show when={props.tutorial}>
+ {(tutorial) => <TutorialVideoDialog tutorial={tutorial()} />}
+ </Show>
+ </div>
</header>
);
}
diff --git a/apps/marketing/src/features/marketing/components/tutorial-video-dialog.css b/apps/marketing/src/features/marketing/components/tutorial-video-dialog.css
new file mode 100644
index 0000000000..4c3ed6c531
--- /dev/null
+++ b/apps/marketing/src/features/marketing/components/tutorial-video-dialog.css
@@ -0,0 +1,55 @@
+/* Outranks the site-wide button color and size in app/main/index.css. */
+.feature-page .tutorial-video-trigger { --nav-ink: var(--color-ink); --nav-edge: color-mix(in srgb, var(--color-ink) 13%, transparent); gap: 10px; color: var(--nav-ink); }
+.tutorial-video-trigger svg { flex-shrink: 0; width: 16px; height: 16px; }
+.tutorial-video-trigger-length { color: var(--color-ink-subtle); font-variant-numeric: tabular-nums; }
+.tutorial-video-trigger-length::before { content: '·'; margin-right: 10px; }
+
+/* The video at 80% of the window, as in the app. Follows the site palette. */
+.tutorial-video-overlay { position: fixed; inset: 0; z-index: 10000; background: #000b; backdrop-filter: blur(12px); animation: tutorial-video-fade 180ms ease-out; }
+/* The html zoom scales viewport units, so undo it to fit the real viewport. */
+.tutorial-video-dialog { position: fixed; z-index: 10001; inset: 0; margin: auto; zoom: calc(1 / var(--site-scale, 1)); width: 80vw; height: 80dvh; display: flex; flex-direction: column; overflow: hidden; isolation: isolate; border: 1px solid var(--color-edge-muted); border-radius: 16px; background: var(--color-dialog); color: var(--color-ink); box-shadow: 0 32px 120px #0008; outline: none; font-family: 'Inter Variable', Inter, sans-serif; animation: tutorial-video-open 280ms cubic-bezier(.2,.8,.2,1); }
+.tutorial-video-titlebar { display: flex; align-items: center; gap: 8px; flex-shrink: 0; height: 48px; padding: 0 8px 0 16px; }
+.tutorial-video-titlebar h2 { flex: 1; min-width: 0; margin: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font: 500 14px/1.4 'Inter Variable', Inter, sans-serif; color: var(--color-ink); }
+.tutorial-video-dialog .tutorial-video-close { display: grid; place-items: center; width: 32px; height: 32px; padding: 8px; border: 0; border-radius: 8px; background: transparent; color: var(--color-ink-muted); }
+.tutorial-video-close:hover { background: color-mix(in srgb, var(--color-ink) 8%, transparent); color: var(--color-ink); }
+.tutorial-video-close:focus-visible { outline: 2px solid var(--color-ink); outline-offset: 2px; }
+.tutorial-video-close svg { width: 16px; height: 16px; }
+.tutorial-video-stage { position: relative; display: flex; flex: 1; min-height: 0; align-items: center; justify-content: center; margin: 0 8px 8px; overflow: hidden; border-radius: 12px; background: #000; }
+.tutorial-video-stage video { display: block; width: 100%; max-height: 100%; object-fit: contain; outline: none; }
+/* Play hands focus to the video; show it for keyboards, inside the stage's rounded clip. */
+.tutorial-video-stage video:focus-visible { outline: 2px solid #fff; outline-offset: -4px; }
+.tutorial-video-scrim { position: absolute; inset: 0; border: 0; padding: 0; background: #00000073; }
+
+/* The app's play pill: play disc, divider, presenter, and the video's length. */
+.tutorial-video-dialog .tutorial-video-play { position: absolute; top: 50%; left: 50%; transform: translate(-50%, -50%); display: flex; align-items: center; gap: 12px; height: 64px; padding: 8px 24px 8px 8px; border: 1px solid #ffffff1f; border-radius: 999px; background: rgb(20 20 20 / .85); color: #fff; white-space: nowrap; box-shadow: 0 25px 50px -12px #00000040; outline: none; transition: background-color 140ms ease; }
+.tutorial-video-play:focus-visible { outline: 2px solid #fff; outline-offset: 2px; }
+.tutorial-video-disc { flex-shrink: 0; width: 48px; height: 48px; transition: transform 140ms ease; }
+.tutorial-video-divider { flex-shrink: 0; width: 1px; height: 60%; background: #ffffff26; }
+.tutorial-video-play img { flex-shrink: 0; width: 44px; height: 44px; border-radius: 50%; object-fit: cover; }
+.tutorial-video-byline { display: flex; flex-direction: column; align-items: flex-start; text-align: left; line-height: 1.25; }
+.tutorial-video-byline > :first-child { font-size: 16px; font-weight: 500; }
+.tutorial-video-byline > :last-child { color: #fff9; font-size: 14px; font-variant-numeric: tabular-nums; }
+@media (hover: hover) and (pointer: fine) {
+ .tutorial-video-play:hover { background: rgb(38 38 38 / .9); }
+ .tutorial-video-play:hover .tutorial-video-disc { transform: scale(1.05); }
+}
+
+@keyframes tutorial-video-fade { from { opacity: 0; } }
+@keyframes tutorial-video-open { from { opacity: 0; transform: translateY(18px) scale(.97); } }
+
+/* Phones: the full width, sized to the 16:9 video. */
+@media (max-width: 599px) {
+ .tutorial-video-dialog { width: calc(100vw - 16px); height: fit-content; border-radius: 14px; }
+ .tutorial-video-titlebar { height: 44px; padding-left: 12px; }
+ .tutorial-video-titlebar h2 { font-size: 13px; }
+ .tutorial-video-stage { aspect-ratio: 16 / 9; flex: none; margin: 0 4px 4px; border-radius: 10px; }
+ .tutorial-video-dialog .tutorial-video-play { height: 48px; gap: 8px; padding: 4px 16px 4px 4px; }
+ .tutorial-video-disc { width: 40px; height: 40px; }
+ .tutorial-video-play img { width: 36px; height: 36px; }
+ .tutorial-video-byline > :first-child { font-size: 14px; }
+ .tutorial-video-byline > :last-child { font-size: 12px; }
+}
+@media (prefers-reduced-motion: reduce) {
+ .tutorial-video-overlay, .tutorial-video-dialog { animation: none; }
+}
+.tutorial-video-overlay[data-closed], .tutorial-video-dialog[data-closed] { animation: none; }
diff --git a/apps/marketing/src/features/marketing/core/tutorial-videos.ts b/apps/marketing/src/features/marketing/core/tutorial-videos.ts
new file mode 100644
index 0000000000..36c6fc947b
--- /dev/null
+++ b/apps/marketing/src/features/marketing/core/tutorial-videos.ts
@@ -0,0 +1,26 @@
+/**
+ * The app's Block tutorial videos that have a product page here. Titles and
+ * lengths match the app's `tutorials` messages. The files are served from
+ * `public/video/tutorials/`, which docs.macro.com also embeds from macro.com.
+ */
+export const TUTORIAL_VIDEOS = {
+ mail: { title: 'Learn how to use Macro Mail', length: '1:42' },
+ tasks: { title: 'Learn how to use Macro Tasks', length: '1:57' },
+ chat: { title: 'Learn how to use Macro Chat', length: '1:30' },
+ docs: { title: 'Learn how to use Macro Docs', length: '1:46' },
+ calls: { title: 'Learn how to use Macro Calls', length: '1:10' },
+ crm: { title: 'Learn how to use Macro CRM', length: '1:26' },
+ agents: { title: 'Learn how to use Macro Agents', length: '1:05' },
+ github: { title: 'Learn how to use Macro with GitHub', length: '1:01' },
+} as const;
+
+export type TutorialVideoId = keyof typeof TUTORIAL_VIDEOS;
+
+/** Who presents the videos, shown on the play button. */
+export const TUTORIAL_PRESENTER = 'Jacob Beckerman';
+
+export const tutorialVideoUrl = (id: TutorialVideoId) =>
+ `/video/tutorials/${id}.mp4`;
+
+export const tutorialPosterUrl = (id: TutorialVideoId) =>
+ `/video/tutorials/${id}-poster.jpg`;
diff --git a/apps/marketing/src/features/marketing/views/ProductAgentsPage.tsx b/apps/marketing/src/features/marketing/views/ProductAgentsPage.tsx
index 178cd5c764..40590d46de 100644
--- a/apps/marketing/src/features/marketing/views/ProductAgentsPage.tsx
+++ b/apps/marketing/src/features/marketing/views/ProductAgentsPage.tsx
@@ -113,6 +113,7 @@ export function RouteAgents() {
'to get things done alongside your team.',
]}
cta="agents_hero_get_started"
+ tutorial="agents"
/>
</div>
<WorkspaceDesktopDemo
diff --git a/apps/marketing/src/features/marketing/views/ProductCallsPage.tsx b/apps/marketing/src/features/marketing/views/ProductCallsPage.tsx
index 966b646559..4b3a144a96 100644
--- a/apps/marketing/src/features/marketing/views/ProductCallsPage.tsx
+++ b/apps/marketing/src/features/marketing/views/ProductCallsPage.tsx
@@ -99,6 +99,7 @@ export function RouteCalls() {
<div class="calls-page">
<ProductHero
cta="calls_hero_get_started"
+ tutorial="calls"
product="Calls"
title={['Call from anywhere in Macro', 'with every call recorded.']}
description={[
diff --git a/apps/marketing/src/features/marketing/views/ProductChannelsPage.tsx b/apps/marketing/src/features/marketing/views/ProductChannelsPage.tsx
index ff9ffe1878..a6735a337f 100644
--- a/apps/marketing/src/features/marketing/views/ProductChannelsPage.tsx
+++ b/apps/marketing/src/features/marketing/views/ProductChannelsPage.tsx
@@ -36,6 +36,7 @@ export function RouteChannels() {
'and the whole channel can open it natively.',
]}
cta="channels_hero_get_started"
+ tutorial="chat"
/>
<ChannelHero />
<nav class="feature-page-jump-links" aria-label="On this page">
diff --git a/apps/marketing/src/features/marketing/views/ProductDocumentsPage.tsx b/apps/marketing/src/features/marketing/views/ProductDocumentsPage.tsx
index 3f9d3c7623..6c01ae2532 100644
--- a/apps/marketing/src/features/marketing/views/ProductDocumentsPage.tsx
+++ b/apps/marketing/src/features/marketing/views/ProductDocumentsPage.tsx
@@ -82,6 +82,7 @@ export function RouteDocuments() {
title={['Fast collaborative docs', 'for your team and agents.']}
description="Link emails, chats, tasks, and files to your documents."
cta="documents_hero_get_started"
+ tutorial="docs"
/>
<WorkspaceDesktopDemo
heroFrame
diff --git a/apps/marketing/src/features/marketing/views/ProductReviewsPage.tsx b/apps/marketing/src/features/marketing/views/ProductReviewsPage.tsx
index 1806a70e18..293ed193a9 100644
--- a/apps/marketing/src/features/marketing/views/ProductReviewsPage.tsx
+++ b/apps/marketing/src/features/marketing/views/ProductReviewsPage.tsx
@@ -85,6 +85,7 @@ export function RouteGithub() {
'and keep linked tasks up to date.',
]}
cta="github_hero_get_started"
+ tutorial="github"
/>
<WorkspaceDesktopDemo
heroFrame