✨(frontend) add onboarding modal with help menu button by Ovgodd · Pull Request #1868 · suitenumerique/docs

Ovgodd · 2026-02-06T14:05:28Z

Purpose

Add a Docs onboarding in the help menu and introduce a guided onboarding flow to help users discover editing, formatting, sharing, and template features.

Proposal

Add the onboarding feature (features/on-boarding/) with steps, assets, and hooks.
Put onboarding into the left panel help menu.
Accessibility improvements need to be implemented in the UI Kit.
Open of first connection i not handle here yet

socket-security · 2026-02-06T14:06:07Z

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	@gouvfr-lasuite/ui-kit@0.18.7 ⏵ 0.19.5	⁺²		⁺²⁵	⁺¹

View full report

github-actions · 2026-02-06T14:13:29Z

Size Change: +11 kB (+0.26%)

Total Size: 4.21 MB

Filename	Size	Change
`apps/impress/out/_next/static/39d5a144/_buildManifest.js`	830 B	+830 B (new file)	🆕
`apps/impress/out/_next/static/chunks/8495.js`	68.9 kB	+3.95 kB (+6.08%)	🔍
`apps/impress/out/_next/static/chunks/pages/_app.js`	600 kB	+5.58 kB (+0.94%)
`apps/impress/out/_next/static/css/1b41e63cc2efc1f2.css`	47.6 kB	+47.6 kB (new file)	🆕
`apps/impress/out/_next/static/css/6a59910f4653194c.css`	0 B	-46.2 kB (removed)	🏆
`apps/impress/out/_next/static/d5272f34/_buildManifest.js`	0 B	-831 B (removed)	🏆

_{compressed-size-action}

socket-security · 2026-02-09T08:50:42Z

All alerts resolved. Learn more about Socket for GitHub.

This PR previously contained dependency changes with security issues that have been resolved, removed, or ignored.

View full report

src/frontend/apps/impress/src/features/left-panel/components/LeftPanel.tsx

src/frontend/apps/impress/src/features/on-boarding/components/OnBoarding.tsx

src/frontend/apps/impress/src/features/on-boarding/hooks/useOnboardingSteps.tsx

AntoLC · 2026-02-10T09:09:40Z

src/frontend/apps/impress/src/i18n/translations.json

translations.json is automatically edited, what you made in it will be overwritten when the translations are pulled from Crowdin.

src/frontend/apps/impress/src/features/on-boarding/components/OnBoarding.tsx

src/frontend/apps/impress/src/features/left-panel/hooks/useHelpMenuOptions.tsx

integrate onboarding feature accessible from left panel help menu ✨(frontend) add docs onboarding and help memu Introduce an onboarding to guide users through core features.

Ensure onboarding entrypoint and modal navigation work end-to-end.

AntoLC

Ah nice job, almost pixel perfect 😉

Some returns about the codes then we are good.

src/frontend/apps/e2e/__tests__/app-impress/onboarding.spec.ts

src/frontend/apps/impress/src/features/left-panel/components/LeftPanelHelpMenu.tsx

src/frontend/apps/impress/src/features/on-boarding/hooks/useOnboardingSteps.tsx

src/frontend/apps/impress/src/features/left-panel/components/LeftPanelHelpMenu.tsx

src/frontend/apps/impress/src/features/on-boarding/components/OnboardingStepImage.tsx

CHANGELOG.md

AntoLC · 2026-02-12T10:14:48Z

src/frontend/apps/impress/src/i18n/translations.json

This file should not be edited from dev PR as it will be overwrited.

AntoLC · 2026-02-12T10:19:37Z

src/frontend/apps/impress/src/features/left-panel/components/LeftPanelHelpMenu.tsx

+  const options = useHelpMenuOptions({ onOpenOnboarding: openModal });
+  const footerLink = {
+    label: t('Learn more docs features'),
+    href: '',


You should see either with Robin or Virgile about the link, we should leverage the Next Router as well, to have a shallow redirection. If we don't have a link to propose we should not display this part.

AntoLC

This PR is almost done, so not in this one, but when we will add another part in the help menu I think actually we should create a feature help, and inside this feature help we will have the onboarding codes (so no feature onboarding anymore), and all the others part as well:

AntoLC · 2026-02-13T09:07:09Z

src/frontend/apps/impress/src/features/left-panel/components/LeftPanelHelpMenu.tsx

        footerLink={{
          label: t('Learn more docs features'),
-          href: '',
+          href: 'https://docs.numerique.gouv.fr/docs/335e43b5-9e16-4798-a0b4-912e44c7135e/',


We have to add this url as a environment variables, others instances are not using https://docs.numerique.gouv.fr.
To do so, we will give the possibility the override it thanks to the theme configuration file:

docs/src/backend/impress/configuration/theme/default.json

Line 1 in 3378544

{

You should add:

{ "onboarding: { "learn_more_url": "" }, "footer": { ....

docs/src/frontend/apps/impress/src/core/config/api/useConfig.tsx

Lines 14 to 27 in 3378544

interface ThemeCustomization {

favicon?: {

light: LinkHTMLAttributes<HTMLLinkElement>;

dark: LinkHTMLAttributes<HTMLLinkElement>;

};

footer?: FooterType;

home: {

'with-proconnect'?: boolean;

'icon-banner'?: Imagetype;

};

translations?: Resource;

header?: HeaderType;

waffle?: WaffleType;

}

If the url is empty, do not display the footerLink.

Don't add this url, I will add it on our own instance directly.

AntoLC · 2026-02-13T09:08:06Z

src/frontend/apps/impress/src/features/on-boarding/components/OnboardingStepImage.tsx

This component seems overkill now, can we directly add Image where it is needed.

Ovgodd requested a review from AntoLC February 6, 2026 14:05

Ovgodd self-assigned this Feb 6, 2026

Ovgodd added the accessibility label Feb 6, 2026

Ovgodd changed the title ~~Feat/onboarding modal~~ ✨(frontend) add onboarding modal with help menu button Feb 6, 2026

Ovgodd force-pushed the feat/onboarding-modal branch 2 times, most recently from e37119e to 646716a Compare February 6, 2026 14:09

Ovgodd marked this pull request as ready for review February 9, 2026 07:55

Ovgodd removed the accessibility label Feb 9, 2026

Ovgodd force-pushed the feat/onboarding-modal branch 2 times, most recently from c568bd8 to 8895b75 Compare February 9, 2026 08:50

AntoLC reviewed Feb 10, 2026

View reviewed changes

Ovgodd requested a review from AntoLC February 11, 2026 11:26

Ovgodd force-pushed the feat/onboarding-modal branch from e320212 to 5d3a15e Compare February 11, 2026 11:26

This was linked to issues Feb 11, 2026

Open/Close left side panel #1873

Open

Add a contextual floating bar for documents and sub-documents #1874

Open

Ovgodd added the feature add a new feature label Feb 11, 2026

Ovgodd added 8 commits February 11, 2026 16:46

✨(frontend) add onboarding modal with help menu button

f98963d

integrate onboarding feature accessible from left panel help menu ✨(frontend) add docs onboarding and help memu Introduce an onboarding to guide users through core features.

✅(frontend) add e2e test for onboarding modal

70cd87e

Ensure onboarding entrypoint and modal navigation work end-to-end.

fixup! ✨(frontend) add onboarding modal with help menu button

0e05b47

fixup! ✨(frontend) add onboarding modal with help menu button

d8488d4

fixup! fixup! ✨(frontend) add onboarding modal with help menu button

318544b

fixup! fixup! ✨(frontend) add onboarding modal with help menu button

82488ba

fixup! fixup! ✨(frontend) add onboarding modal with help menu button

99bb5a5

fixup! ✨(frontend) add onboarding modal with help menu button

fc645eb

Ovgodd force-pushed the feat/onboarding-modal branch from 5d3a15e to fc645eb Compare February 11, 2026 15:46

AntoLC reviewed Feb 12, 2026

View reviewed changes

AntoLC removed a link to an issue Feb 12, 2026

Open/Close left side panel #1873

Open

AntoLC removed a link to an issue Feb 12, 2026

Add a contextual floating bar for documents and sub-documents #1874

Open

Ovgodd added 2 commits February 12, 2026 12:22

fixup! ✅(frontend) add e2e test for onboarding modal

00e6941

fixup! ✨(frontend) add onboarding modal with help menu button

31b4ef9

Ovgodd force-pushed the feat/onboarding-modal branch from 65337c7 to 31b4ef9 Compare February 12, 2026 11:32

Ovgodd added 5 commits February 12, 2026 12:40

fixup! ✨(frontend) add onboarding modal with help menu button

965adbc

fixup! ✨(frontend) add onboarding modal with help menu button

92d9961

fixup! ✨(frontend) add onboarding modal with help menu button

0a43a58

fixup! ✨(frontend) add onboarding modal with help menu button

5a97ca8

fixup! ✨(frontend) add onboarding modal with help menu button

0090b8d

Ovgodd force-pushed the feat/onboarding-modal branch 3 times, most recently from 99f234b to 5f29b6e Compare February 12, 2026 13:19

AntoLC linked an issue Feb 13, 2026 that may be closed by this pull request

Open/Close left side panel #1873

Open

AntoLC removed a link to an issue Feb 13, 2026

Open/Close left side panel #1873

Open

AntoLC reviewed Feb 13, 2026

View reviewed changes

:x

e042264

Ovgodd force-pushed the feat/onboarding-modal branch from 5f29b6e to e042264 Compare February 13, 2026 13:42

	interface ThemeCustomization {
	favicon?: {
	light: LinkHTMLAttributes<HTMLLinkElement>;
	dark: LinkHTMLAttributes<HTMLLinkElement>;
	};
	footer?: FooterType;
	home: {
	'with-proconnect'?: boolean;
	'icon-banner'?: Imagetype;
	};
	translations?: Resource;
	header?: HeaderType;
	waffle?: WaffleType;
	}

Conversation

Ovgodd commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Purpose

Proposal

Uh oh!

socket-security bot commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Feb 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

socket-security bot commented Feb 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

AntoLC Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

AntoLC left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

AntoLC Feb 12, 2026

Choose a reason for hiding this comment

Uh oh!

AntoLC Feb 12, 2026

Choose a reason for hiding this comment

Uh oh!

AntoLC left a comment

Choose a reason for hiding this comment

Uh oh!

AntoLC Feb 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

AntoLC Feb 13, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Ovgodd commented Feb 6, 2026 •

edited

Loading

socket-security bot commented Feb 6, 2026 •

edited

Loading

github-actions bot commented Feb 6, 2026 •

edited

Loading

socket-security bot commented Feb 9, 2026 •

edited

Loading

AntoLC Feb 13, 2026 •

edited

Loading