Skip to content

[Home Page] Add Getting started section on Home for invited employees - #106400

Open
adamgrzybowski wants to merge 4 commits into
Expensify:mainfrom
software-mansion-labs:@adamgrzybowski/employee-getting-started-home
Open

adamgrzybowski wants to merge 4 commits into
Expensify:mainfrom
software-mansion-labs:@adamgrzybowski/employee-getting-started-home

Conversation

@adamgrzybowski

@adamgrzybowski adamgrzybowski commented Nov 9, 2026 •

Copy link
Copy Markdown
Contributor

Explanation of Change

  • Depends on [Home Page] Rename the Getting started expense step to Add your first receipt #106471, which must merge first. That PR adds the "Add your first receipt" step and strings this PR reuses.
  • Employees who join Expensify through a workspace invite had no obvious next step on Home. They now get a Getting started section with three steps: Add your name, Add your first receipt and Download the app.
  • Each step opens the right screen (display name, the Scan tab of the create expense flow, the app download links) and checks itself off automatically. The section hides once all three are done, and it only shows during the first 60 days after signup.
  • It is tied to how the account was created, so users who signed up any other way and are later invited to a workspace don't see it. Admins and owners keep the existing admin list. The "Need help?" footer is hidden for this list because members cannot open the admins room.

Fixed Issues

$ #105972
PROPOSAL:

Tests

  • Verify that no errors appear in the JS console

Offline tests

QA Steps

  1. Sign up a new account from a workspace invite email and go to Home. Verify a Getting started section shows "Add your name", "Add your first receipt" and "Download the app", with no "Need help?" footer.
  2. Press "Add your name" and save a first name, then press "Add your first receipt", verify the create expense flow opens on the Scan tab, and create an expense. Verify both steps show as Done on Home.
  3. Press "Download the app" and verify the App download links panel opens.
  • Verify that no errors appear in the JS console

PR Author Checklist

  • I linked the correct issue in the ### Fixed Issues section above
  • I wrote clear testing steps that cover the changes made in this PR
    • I added steps for local testing in the Tests section
    • I added steps for the expected offline behavior in the Offline steps section
    • I added steps for Staging and/or Production testing in the QA steps section
    • I added steps to cover failure scenarios (i.e. verify an input displays the correct error message if the entered data is not correct)
    • I turned off my network connection and tested it while offline to ensure it matches the expected behavior (i.e. verify the default avatar icon is displayed if app is offline)
    • I tested this PR with a High Traffic account against the staging or production API to ensure there are no regressions (e.g. long loading states that impact usability).
  • I included screenshots or videos for tests on all platforms
  • I ran the tests on all platforms & verified they passed on:
    • Android: Native
    • Android: mWeb Chrome
    • iOS: Native
    • iOS: mWeb Safari
    • MacOS: Chrome / Safari
  • I verified there are no console errors (if there's a console error not related to the PR, report it or open an issue for it to be fixed)
  • I verified any copy / text that was added to the app is either coming verbatim from figma or has been approved by marketing (in order to get marketing approval, ask the Bug Zero team member to add the Waiting for copy label to the issue)
  • If a new code pattern is added I verified it was agreed to be used by multiple Expensify engineers
  • I tested other components that can be impacted by my changes (i.e. if the PR modifies a shared library or component like Avatar, I verified the components using Avatar are working as expected)
  • If new assets were added or existing ones were modified, I verified that:
    • The assets are optimized and compressed (for SVG files, run npm run compress-svg)
    • The assets load correctly across all supported platforms.
  • If the PR modifies code that runs when editing or sending messages, I tested and verified there is no unexpected behavior for all supported markdown - URLs, single line code, code blocks, quotes, headings, bold, strikethrough, and italic.
  • If the PR modifies a generic component, I tested and verified that those changes do not break usages of that component in the rest of the App (i.e. if a shared library or component like Avatar is modified, I verified that Avatar is working as expected in all cases)
  • If the PR modifies a component related to any of the existing Storybook stories, I tested and verified all stories for that component are still working as expected.
  • If the PR modifies a component or page that can be accessed by a direct deeplink, I verified that the code functions as expected when the deeplink is used - from a logged in and logged out account.
  • If the PR modifies the UI (e.g. new buttons, new UI components, changing the padding/spacing/sizing, moving components, etc) or modifies the form input styles:
    • I verified that all the inputs inside a form are aligned with each other.
    • I added Design label and/or tagged @Expensify/design so the design team can review the changes.
  • If the PR adds or modifies the UI:
    • I asked an AI agent to review the changes for accessibility issues and addressed its findings.
    • I tested with a screen reader (VoiceOver on macOS) and verified all new/changed elements are reachable with a logical focus order.
    • I verified all new/changed elements have meaningful accessible names and roles.
    • I verified state changes are announced (e.g. checked/unchecked, expanded/collapsed, selected).
  • I added unit tests for any new feature or bug fix in this PR to help automatically prevent regressions in this user flow.
  • If the main branch was merged into this PR after a review, I tested again and verified the outcome was still expected according to the Test steps.

Screenshots/Videos

Android: Native
Android: mWeb Chrome
iOS: Native
iOS: mWeb Safari
MacOS: Chrome / Safari
getting-started-employee-demo-v2.mp4

@melvin-bot

melvin-bot Bot commented Nov 9, 2026

Copy link
Copy Markdown

Hey, I noticed you changed src/languages/en.ts in a PR from a fork. For security reasons, translations are not generated automatically for PRs from forks.

If you want to automatically generate translations for other locales, an Expensify employee will have to:

  1. Look at the code and make sure there are no malicious changes.
  2. Run the Generate static translations GitHub workflow. If you have write access and the K2 extension, you can simply click: [this button]

Alternatively, if you are an external contributor, you can run the translation script locally with your own OpenAI API key. To learn more, try running:

npx bun ./scripts/generateTranslations.ts --help

Typically, you'd want to translate only what you changed by running npx bun ./scripts/generateTranslations.ts --compare-ref main

@codecov

codecov Bot commented Nov 9, 2026 •

Copy link
Copy Markdown

Codecov Report

❌ Looks like you've decreased code coverage for some files. Please write tests to increase, or at least maintain, the existing level of code coverage. See our documentation here for how to interpret this table.

Files with missing lines Coverage Δ
src/CONST/SENTRY_LABEL.ts 100.00% <ø> (ø)
...s/home/GettingStartedSection/GettingStartedRow.tsx 91.17% <ø> (ø)
...tingStartedSection/hooks/useAddFirstReceiptItem.ts 100.00% <100.00%> (ø)
...tingStartedSection/hooks/useGettingStartedItems.ts 98.00% <100.00%> (-0.28%) ⬇️
...rtedSection/hooks/useInviteeGettingStartedItems.ts 100.00% <100.00%> (ø)
src/pages/home/GettingStartedSection/index.tsx 100.00% <100.00%> (+8.10%) ⬆️
...ingStartedSection/InviteeGettingStartedSection.tsx 93.33% <93.33%> (ø)
...ingStartedSection/DefaultGettingStartedSection.tsx 91.89% <91.89%> (ø)
... and 12 files with indirect coverage changes

@adamgrzybowski adamgrzybowski changed the title Add Getting started section on Home for invited employees [Home Page] Add Getting started section on Home for invited employees Nov 10, 2026
@adamgrzybowski
adamgrzybowski force-pushed the @adamgrzybowski/employee-getting-started-home branch 2 times, most recently from f0df923 to 2908957 Compare November 10, 2026 11:59
@adamgrzybowski
adamgrzybowski force-pushed the @adamgrzybowski/employee-getting-started-home branch from 2908957 to 3ac79ed Compare November 10, 2026 12:32
@adamgrzybowski
adamgrzybowski marked this pull request as ready for review November 10, 2026 12:36
@adamgrzybowski
adamgrzybowski requested review from a team as code owners November 10, 2026 12:36
@melvin-bot
melvin-bot Bot requested a review from ZhenjaHorbach November 10, 2026 12:36
@adamgrzybowski
adamgrzybowski marked this pull request as draft November 10, 2026 12:36
@melvin-bot
melvin-bot Bot removed the request for review from a team November 10, 2026 12:36
@melvin-bot

melvin-bot Bot commented Nov 10, 2026

Copy link
Copy Markdown

@ZhenjaHorbach Please copy/paste the Reviewer Checklist from here into a new comment on this PR and complete it. If you have the K2 extension, you can simply click: [this button]

@melvin-bot
melvin-bot Bot requested review from flaviadefaria and removed request for a team November 10, 2026 12:36
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-10T13:25:15.007589Z 97c0dd1 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3ac79ed5f9

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@OSBotify

This comment has been minimized.

@adamgrzybowski
adamgrzybowski marked this pull request as ready for review November 10, 2026 13:09

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 97c0dd1c8e

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@OSBotify

Copy link
Copy Markdown
Contributor

🦜 Polyglot Parrot! 🦜

Squawk! Looks like you added some shiny new English strings. Allow me to parrot them back to you in other tongues:

View the translation diff
diff --git a/src/languages/de.ts b/src/languages/de.ts
index c99407d8..c9478a24 100644
--- a/src/languages/de.ts
+++ b/src/languages/de.ts
@@ -1179,9 +1179,9 @@ const translations: TranslationDeepObject<typeof en> = {
             addFirstReceipt: 'Fügen Sie Ihren ersten Beleg hinzu',
             addFirstReceiptSubText: 'Beleg scannen oder manuell eingeben',
             addName: 'Fügen Sie Ihren Namen hinzu',
-            addNameSubText: 'Helfen Sie Ihrem Team, Sie in Expensify zu erkennen.',
-            downloadApp: 'Laden Sie die App herunter',
-            downloadAppSubText: 'Belege scannen, Ausgaben einreichen und Berichte unterwegs genehmigen.',
+            addNameSubText: 'Helfen Sie Ihren Teammitgliedern, Sie in Expensify wiederzuerkennen.',
+            downloadApp: 'App herunterladen',
+            downloadAppSubText: 'Belege scannen, Ausgaben einreichen und Berichte unterwegs freigeben.',
         },
         freeTrialSection: {
             title: ({count}: {count: number}) => ({
diff --git a/src/languages/el.ts b/src/languages/el.ts
index 703cf967..a454c1f9 100644
--- a/src/languages/el.ts
+++ b/src/languages/el.ts
@@ -1235,10 +1235,10 @@ const translations: TranslationDeepObject<typeof en> = {
             setupTravel: 'Ρύθμιση ταξιδιού',
             setupTravelSubText: 'Ρύθμιση ειδικών κανόνων για ταξίδια',
             addFirstReceipt: 'Προσθέστε την πρώτη σας απόδειξη',
-            addFirstReceiptSubText: 'Σαρώστε ή καταχωρίστε χειροκίνητα μια απόδειξη',
+            addFirstReceiptSubText: 'Σαρώστε ή εισαγάγετε χειροκίνητα μια απόδειξη',
             addName: 'Προσθέστε το όνομά σας',
             addNameSubText: 'Βοηθήστε τους συναδέλφους σας να σας αναγνωρίζουν στο Expensify.',
-            downloadApp: 'Κατεβάστε την εφαρμογή',
+            downloadApp: 'Κάντε λήψη της εφαρμογής',
             downloadAppSubText: 'Σαρώστε αποδείξεις, υποβάλετε δαπάνες και εγκρίνετε αναφορές όπου κι αν βρίσκεστε.',
         },
         upcomingTravel: 'Επερχόμενα ταξίδια',
diff --git a/src/languages/es.ts b/src/languages/es.ts
index 8771b9b9..dcc11647 100644
--- a/src/languages/es.ts
+++ b/src/languages/es.ts
@@ -1179,11 +1179,11 @@ const translations: TranslationDeepObject<typeof en> = {
             setupTravel: 'Configurar viajes',
             setupTravelSubText: 'Configura reglas específicas de viaje',
             addFirstReceipt: 'Añade tu primer recibo',
-            addFirstReceiptSubText: 'Escanear o introducir manualmente un recibo',
+            addFirstReceiptSubText: 'Escanea o introduce manualmente un recibo',
             addName: 'Añade tu nombre',
             addNameSubText: 'Ayuda a tus compañeros de trabajo a reconocerte en Expensify.',
-            downloadApp: 'Descarga la app',
-            downloadAppSubText: 'Escanea recibos, envía gastos y aprueba informes donde estés.',
+            downloadApp: 'Descarga la aplicación',
+            downloadAppSubText: 'Escanea recibos, envía gastos y aprueba informes desde cualquier lugar.',
         },
         upcomingTravel: 'Próximos viajes',
         upcomingTravelSection: {
diff --git a/src/languages/fr.ts b/src/languages/fr.ts
index 044ed5cf..8ede10a9 100644
--- a/src/languages/fr.ts
+++ b/src/languages/fr.ts
@@ -1197,11 +1197,11 @@ const translations: TranslationDeepObject<typeof en> = {
             setupTravel: 'Configurer les déplacements',
             setupTravelSubText: 'Configurer des règles spécifiques aux déplacements',
             addFirstReceipt: 'Ajoutez votre premier reçu',
-            addFirstReceiptSubText: 'Scanner ou saisir manuellement un reçu',
+            addFirstReceiptSubText: 'Scanner ou saisir un reçu manuellement',
             addName: 'Ajoutez votre nom',
             addNameSubText: 'Aidez vos coéquipiers à vous reconnaître dans Expensify.',
             downloadApp: 'Télécharger l’application',
-            downloadAppSubText: 'Scannez des reçus, soumettez des dépenses et approuvez des notes de frais où que vous soyez.',
+            downloadAppSubText: 'Scannez les reçus, soumettez les dépenses et approuvez les notes de frais où que vous soyez.',
         },
         yourSpend: {
             title: 'Vos dépenses',
diff --git a/src/languages/it.ts b/src/languages/it.ts
index 3a30eca2..9f3cba19 100644
--- a/src/languages/it.ts
+++ b/src/languages/it.ts
@@ -1200,7 +1200,7 @@ const translations: TranslationDeepObject<typeof en> = {
             addName: 'Aggiungi il tuo nome',
             addNameSubText: 'Aiuta i tuoi colleghi a riconoscerti in Expensify.',
             downloadApp: 'Scarica l’app',
-            downloadAppSubText: 'Scansiona ricevute, invia note spese e approva report ovunque ti trovi.',
+            downloadAppSubText: 'Scannerizza ricevute, invia note spese e approva report ovunque ti trovi.',
         },
         yourSpend: {
             title: 'Le tue spese',
diff --git a/src/languages/ja.ts b/src/languages/ja.ts
index 331a8494..e3b8ef35 100644
--- a/src/languages/ja.ts
+++ b/src/languages/ja.ts
@@ -1181,11 +1181,11 @@ const translations: TranslationDeepObject<typeof en> = {
             setupTravel: '出張を設定',
             setupTravelSubText: '出張用のルールを設定する',
             addFirstReceipt: '最初のレシートを追加する',
-            addFirstReceiptSubText: 'レシートをスキャンするか手入力します',
-            addName: '氏名を追加してください',
+            addFirstReceiptSubText: 'レシートをスキャンまたは手動で入力する',
+            addName: '名前を追加してください',
             addNameSubText: 'Expensify でチームメイトにあなたを認識してもらいましょう。',
             downloadApp: 'アプリをダウンロード',
-            downloadAppSubText: '領収書をスキャンして経費を提出し、外出先でもレポートを承認できます。',
+            downloadAppSubText: 'レシートをスキャンして経費を提出し、どこからでもレポートを承認できます。',
         },
         yourSpend: {
             title: 'あなたの支出',
diff --git a/src/languages/nl.ts b/src/languages/nl.ts
index 76860c2f..77b4e249 100644
--- a/src/languages/nl.ts
+++ b/src/languages/nl.ts
@@ -1196,7 +1196,7 @@ const translations: TranslationDeepObject<typeof en> = {
             addName: 'Voeg je naam toe',
             addNameSubText: 'Help je teamgenoten je in Expensify te herkennen.',
             downloadApp: 'Download de app',
-            downloadAppSubText: 'Scan bonnetjes, dien uitgaven in en keur rapporten goed, waar je ook bent.',
+            downloadAppSubText: 'Scan bonnen, dien uitgaven in en keur rapporten goed, waar je ook bent.',
         },
         yourSpend: {
             title: 'Je uitgaven',
diff --git a/src/languages/pl.ts b/src/languages/pl.ts
index 87a7b24b..bcd07851 100644
--- a/src/languages/pl.ts
+++ b/src/languages/pl.ts
@@ -1219,11 +1219,11 @@ const translations: TranslationDeepObject<typeof en> = {
             setupTravel: 'Skonfiguruj podróże',
             setupTravelSubText: 'Skonfiguruj zasady dotyczące podróży',
             addFirstReceipt: 'Dodaj swój pierwszy paragon',
-            addFirstReceiptSubText: 'Zeskanuj lub wprowadź paragon ręcznie',
+            addFirstReceiptSubText: 'Zeskanuj lub wpisz paragon ręcznie',
             addName: 'Dodaj swoje imię',
-            addNameSubText: 'Pomóż współpracownikom rozpoznać cię w Expensify.',
+            addNameSubText: 'Pomóż swoim współpracownikom rozpoznać cię w Expensify.',
             downloadApp: 'Pobierz aplikację',
-            downloadAppSubText: 'Skanuj paragony, wysyłaj wydatki i zatwierdzaj raporty w dowolnym miejscu.',
+            downloadAppSubText: 'Skanuj paragony, przesyłaj wydatki i zatwierdzaj raporty w dowolnym miejscu.',
         },
         yourSpend: {
             title: 'Twoje wydatki',
diff --git a/src/languages/pt-BR.ts b/src/languages/pt-BR.ts
index d2191cd9..e66965a3 100644
--- a/src/languages/pt-BR.ts
+++ b/src/languages/pt-BR.ts
@@ -1195,11 +1195,11 @@ const translations: TranslationDeepObject<typeof en> = {
             setupTravel: 'Configurar viagem',
             setupTravelSubText: 'Configurar regras específicas de viagem',
             addFirstReceipt: 'Adicione seu primeiro recibo',
-            addFirstReceiptSubText: 'Escaneie ou insira manualmente um recibo',
+            addFirstReceiptSubText: 'Digitalize ou insira um recibo manualmente',
             addName: 'Adicione seu nome',
-            addNameSubText: 'Ajude seus colegas de equipe a reconhecer você no Expensify.',
+            addNameSubText: 'Ajude seus colegas a reconhecer você no Expensify.',
             downloadApp: 'Baixe o app',
-            downloadAppSubText: 'Digitalize recibos, envie despesas e aprove relatórios em qualquer lugar.',
+            downloadAppSubText: 'Escaneie recibos, envie despesas e aprove relatórios de onde estiver.',
         },
         yourSpend: {
             title: 'Seus gastos',
diff --git a/src/languages/zh-hans.ts b/src/languages/zh-hans.ts
index a06dcef5..4a2df97b 100644
--- a/src/languages/zh-hans.ts
+++ b/src/languages/zh-hans.ts
@@ -1154,12 +1154,12 @@ const translations: TranslationDeepObject<typeof en> = {
             configureApprovalsSubText: '定义报表审批',
             setupTravel: '设置差旅',
             setupTravelSubText: '配置差旅专用规则',
-            addFirstReceipt: '添加您的第一张票据',
+            addFirstReceipt: '添加第一张收据',
             addFirstReceiptSubText: '扫描或手动输入收据',
             addName: '添加你的姓名',
             addNameSubText: '帮助你的队友在 Expensify 中认出你。',
-            downloadApp: '下载应用程序',
-            downloadAppSubText: '随时随地扫描收据、提交报销并审批报表。',
+            downloadApp: '下载应用',
+            downloadAppSubText: '随时随地扫描票据、提交报销并审批报表。',
         },
         yourSpend: {title: '您的支出', awaitingApproval: '等待审批', repaidLast30Days: '过去30天已偿还'},
         seeMore: ({count}: {count: number}) => `再查看 ${count} 个`,

Note

You can apply these changes to your branch by copying the patch to your clipboard, then running pbpaste | git apply 😉

View workflow run

@adamgrzybowski

Copy link
Copy Markdown
Contributor Author

@ZhenjaHorbach friendly bump

@ZhenjaHorbach

Copy link
Copy Markdown
Contributor

Will check today!

@ZhenjaHorbach

Copy link
Copy Markdown
Contributor

@adamgrzybowski
Let's fix conflicts

…oyee-getting-started-home

# Conflicts:
#	src/pages/home/GettingStartedSection/hooks/useGettingStartedItems.ts
@adamgrzybowski

Copy link
Copy Markdown
Contributor Author

@ZhenjaHorbach done

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants