Skip to content

The open alternative to Salesforce, designed for AI.

feat(getting-started): add the Getting Started page and sidebar card (#29291)

Etienne257d3de9c475
diff --git a/packages/twenty-client-sdk/src/metadata/generated/types.ts b/packages/twenty-client-sdk/src/metadata/generated/types.ts
index 9544e442504..6006eca6ee8 100644
--- a/packages/twenty-client-sdk/src/metadata/generated/types.ts
+++ b/packages/twenty-client-sdk/src/metadata/generated/types.ts
@@ -8469,7 +8469,7 @@ export default {
62,
{
"applicationId": [
- 525,
+ 533,
"UUID!"
]
}
diff --git a/packages/twenty-front/codegen-metadata.cjs b/packages/twenty-front/codegen-metadata.cjs
index 5843bb7bfc6..725fb6cea36 100644
--- a/packages/twenty-front/codegen-metadata.cjs
+++ b/packages/twenty-front/codegen-metadata.cjs
@@ -33,6 +33,7 @@ module.exports = {
'./src/modules/command-menu-item/graphql/**/*.{ts,tsx}',
'./src/modules/file/graphql/**/*.{ts,tsx}',
'./src/modules/onboarding/graphql/**/*.{ts,tsx}',
+ './src/modules/getting-started/graphql/**/*.{ts,tsx}',
'./src/modules/front-components/graphql/**/*.{ts,tsx}',
'./src/modules/page-layout/widgets/**/graphql/**/*.{ts,tsx}',
diff --git a/packages/twenty-front/src/generated-metadata/graphql.ts b/packages/twenty-front/src/generated-metadata/graphql.ts
index f19d0c69a50..43de0e44c11 100644
--- a/packages/twenty-front/src/generated-metadata/graphql.ts
+++ b/packages/twenty-front/src/generated-metadata/graphql.ts
@@ -960,6 +960,32 @@ export type GetAddressDetailsQueryVariables = Exact<{
export type GetAddressDetailsQuery = { getAddressDetails: { __typename: 'PlaceDetailsResult', street: string | null, state: string | null, postcode: string | null, city: string | null, country: string | null, location: { __typename: 'Location', lat: number | null, lng: number | null } | null } };
+export type GettingStartedProgressFieldsFragment = { __typename: 'GettingStartedProgress', completedStepActionKeys: Array<Types.GettingStartedStepActionKey>, selectedStepActionKey: Types.GettingStartedStepActionKey | null, snoozedUntil: string | null, isHidden: boolean, steps: Array<{ __typename: 'GettingStartedStepDefinition', actionKey: Types.GettingStartedStepActionKey, kind: Types.GettingStartedStepKind, title: string, doneTitle: string, description: string, icon: string, iconColor: string, promptLabel: string | null, prompt: string | null }> };
+
+export type PrepareGettingStartedWorkflowMutationVariables = Exact<{
+ stepActionKey: Types.GettingStartedStepActionKey;
+}>;
+
+
+export type PrepareGettingStartedWorkflowMutation = { prepareGettingStartedWorkflow: { __typename: 'GettingStartedWorkflow', workflowId: string, versionId: string } };
+
+export type UpdateGettingStartedMutationVariables = Exact<{
+ input: Types.UpdateGettingStartedInput;
+}>;
+
+
+export type UpdateGettingStartedMutation = { updateGettingStarted: { __typename: 'GettingStartedProgress', completedStepActionKeys: Array<Types.GettingStartedStepActionKey>, selectedStepActionKey: Types.GettingStartedStepActionKey | null, snoozedUntil: string | null, isHidden: boolean, steps: Array<{ __typename: 'GettingStartedStepDefinition', actionKey: Types.GettingStartedStepActionKey, kind: Types.GettingStartedStepKind, title: string, doneTitle: string, description: string, icon: string, iconColor: string, promptLabel: string | null, prompt: string | null }> } };
+
+export type GettingStartedProgressQueryVariables = Exact<{ [key: string]: never; }>;
+
+
+export type GettingStartedProgressQuery = { gettingStartedProgress: { __typename: 'GettingStartedProgress', completedStepActionKeys: Array<Types.GettingStartedStepActionKey>, selectedStepActionKey: Types.GettingStartedStepActionKey | null, snoozedUntil: string | null, isHidden: boolean, steps: Array<{ __typename: 'GettingStartedStepDefinition', actionKey: Types.GettingStartedStepActionKey, kind: Types.GettingStartedStepKind, title: string, doneTitle: string, description: string, icon: string, iconColor: string, promptLabel: string | null, prompt: string | null }> } };
+
+export type GettingStartedWorkflowPreviewsQueryVariables = Exact<{ [key: string]: never; }>;
+
+
+export type GettingStartedWorkflowPreviewsQuery = { gettingStartedWorkflowPreviews: Array<{ __typename: 'GettingStartedWorkflowPreview', stepActionKey: Types.GettingStartedStepActionKey, trigger: { __typename: 'GettingStartedWorkflowPreviewTrigger', type: string, databaseEventAction: string | null, title: string }, actions: Array<{ __typename: 'GettingStartedWorkflowPreviewAction', type: Types.WorkflowActionType, title: string }> }> };
+
export type LogicFunctionFieldsFragment = { __typename: 'LogicFunction', id: string, name: string, description: string | null, runtime: string, timeoutSeconds: number, executionMode: Types.LogicFunctionExecutionMode, sourceHandlerPath: string, handlerName: string, cronTriggerSettings: any, databaseEventTriggerSettings: any, httpRouteTriggerSettings: any, toolTriggerSettings: any, workflowActionTriggerSettings: any, applicationId: string | null, universalIdentifier: string | null, createdAt: string, updatedAt: string };
export type CreateOneLogicFunctionMutationVariables = Exact<{
@@ -2891,6 +2917,7 @@ export const CommandMenuItemFieldsFragmentDoc = {"kind":"Document","definitions"
export const PageLayoutWidgetFragmentFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"PageLayoutWidgetFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidget"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"isSystemSideEffect"}},{"kind":"Field","name":{"kind":"Name","value":"title"}},{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"objectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}},{"kind":"Field","name":{"kind":"Name","value":"isActive"}},{"kind":"Field","name":{"kind":"Name","value":"deletedAt"}},{"kind":"Field","name":{"kind":"Name","value":"conditionalDisplay"}},{"kind":"Field","name":{"kind":"Name","value":"conditionalAvailabilityExpression"}},{"kind":"Field","name":{"kind":"Name","value":"gridPosition"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"column"}},{"kind":"Field","name":{"kind":"Name","value":"columnSpan"}},{"kind":"Field","name":{"kind":"Name","value":"row"}},{"kind":"Field","name":{"kind":"Name","value":"rowSpan"}}]}},{"kind":"Field","name":{"kind":"Name","value":"position"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidgetGridPosition"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}},{"kind":"Field","name":{"kind":"Name","value":"row"}},{"kind":"Field","name":{"kind":"Name","value":"column"}},{"kind":"Field","name":{"kind":"Name","value":"rowSpan"}},{"kind":"Field","name":{"kind":"Name","value":"columnSpan"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidgetVerticalListPosition"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}},{"kind":"Field","name":{"kind":"Name","value":"index"}},{"kind":"Field","name":{"kind":"Name","value":"heightBehavior"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidgetCanvasPosition"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}}]}}]}},{"kind":"Field","name":{"kind":"Name","value":"configuration"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"BarChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"omitNullValues"}},{"kind":"Field","name":{"kind":"Name","value":"axisNameDisplay"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"displayLegend"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMin"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMax"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"groupMode"}},{"kind":"Field","name":{"kind":"Name","value":"layout"}},{"kind":"Field","name":{"kind":"Name","value":"isCumulative"}},{"kind":"Field","name":{"kind":"Name","value":"splitMultiValueFields"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"LineChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"omitNullValues"}},{"kind":"Field","name":{"kind":"Name","value":"axisNameDisplay"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"displayLegend"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMin"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMax"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"isStacked"}},{"kind":"Field","name":{"kind":"Name","value":"isCumulative"}},{"kind":"Field","name":{"kind":"Name","value":"splitMultiValueFields"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PieChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"groupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"groupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"dateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"orderBy"}},{"kind":"Field","name":{"kind":"Name","value":"manualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"showCenterMetric"}},{"kind":"Field","name":{"kind":"Name","value":"displayLegend"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"hideEmptyCategory"}},{"kind":"Field","name":{"kind":"Name","value":"splitMultiValueFields"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"AggregateChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"label"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"prefix"}},{"kind":"Field","name":{"kind":"Name","value":"suffix"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}},{"kind":"Field","name":{"kind":"Name","value":"ratioAggregateConfig"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"fieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"optionValue"}}]}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"IframeConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"url"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"StandaloneRichTextConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"body"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"blocknote"}},{"kind":"Field","name":{"kind":"Name","value":"markdown"}},{"kind":"Field","name":{"kind":"Name","value":"tiptap"}}]}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"CalendarConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"EmailsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"EmailThreadConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"CallRecordingSummaryConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"CallRecordingTranscriptConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ChatThreadsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ChatConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"MessageCampaignBodyConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"MessageCampaignDetailsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FieldConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"fieldDisplayMode"}},{"kind":"Field","name":{"kind":"Name","value":"fieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"nestedRelationFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"isUIEditable"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FieldRichTextConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FieldsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"newFieldDefaultVisibility"}},{"kind":"Field","name":{"kind":"Name","value":"shouldAllowUserToSeeHiddenFields"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FormFieldConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"fieldMetadataId"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FilesConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"NotesConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"TasksConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"TimelineConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ViewConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"RecordTableConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"recordLimit"}},{"kind":"Field","name":{"kind":"Name","value":"isUIEditable"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"WorkflowConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"WorkflowRunConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"WorkflowVersionConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FrontComponentConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"frontComponentId"}},{"kind":"Field","name":{"kind":"Name","value":"headerCommandMenuItemUniversalIdentifiers"}}]}}]}},{"kind":"Field","name":{"kind":"Name","value":"pageLayoutTabId"}}]}}]} as unknown as DocumentNode<PageLayoutWidgetFragmentFragment, unknown>;
export const PageLayoutTabFragmentFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"PageLayoutTabFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutTab"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"isSystemSideEffect"}},{"kind":"Field","name":{"kind":"Name","value":"title"}},{"kind":"Field","name":{"kind":"Name","value":"icon"}},{"kind":"Field","name":{"kind":"Name","value":"position"}},{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}},{"kind":"Field","name":{"kind":"Name","value":"widgets"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"PageLayoutWidgetFragment"}}]}},{"kind":"Field","name":{"kind":"Name","value":"pageLayoutId"}},{"kind":"Field","name":{"kind":"Name","value":"isActive"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"PageLayoutWidgetFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidget"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"isSystemSideEffect"}},{"kind":"Field","name":{"kind":"Name","value":"title"}},{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"objectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}},{"kind":"Field","name":{"kind":"Name","value":"isActive"}},{"kind":"Field","name":{"kind":"Name","value":"deletedAt"}},{"kind":"Field","name":{"kind":"Name","value":"conditionalDisplay"}},{"kind":"Field","name":{"kind":"Name","value":"conditionalAvailabilityExpression"}},{"kind":"Field","name":{"kind":"Name","value":"gridPosition"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"column"}},{"kind":"Field","name":{"kind":"Name","value":"columnSpan"}},{"kind":"Field","name":{"kind":"Name","value":"row"}},{"kind":"Field","name":{"kind":"Name","value":"rowSpan"}}]}},{"kind":"Field","name":{"kind":"Name","value":"position"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidgetGridPosition"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}},{"kind":"Field","name":{"kind":"Name","value":"row"}},{"kind":"Field","name":{"kind":"Name","value":"column"}},{"kind":"Field","name":{"kind":"Name","value":"rowSpan"}},{"kind":"Field","name":{"kind":"Name","value":"columnSpan"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidgetVerticalListPosition"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}},{"kind":"Field","name":{"kind":"Name","value":"index"}},{"kind":"Field","name":{"kind":"Name","value":"heightBehavior"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidgetCanvasPosition"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}}]}}]}},{"kind":"Field","name":{"kind":"Name","value":"configuration"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"BarChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"omitNullValues"}},{"kind":"Field","name":{"kind":"Name","value":"axisNameDisplay"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"displayLegend"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMin"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMax"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"groupMode"}},{"kind":"Field","name":{"kind":"Name","value":"layout"}},{"kind":"Field","name":{"kind":"Name","value":"isCumulative"}},{"kind":"Field","name":{"kind":"Name","value":"splitMultiValueFields"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"LineChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"omitNullValues"}},{"kind":"Field","name":{"kind":"Name","value":"axisNameDisplay"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"displayLegend"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMin"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMax"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"isStacked"}},{"kind":"Field","name":{"kind":"Name","value":"isCumulative"}},{"kind":"Field","name":{"kind":"Name","value":"splitMultiValueFields"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PieChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"groupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"groupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"dateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"orderBy"}},{"kind":"Field","name":{"kind":"Name","value":"manualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"showCenterMetric"}},{"kind":"Field","name":{"kind":"Name","value":"displayLegend"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"hideEmptyCategory"}},{"kind":"Field","name":{"kind":"Name","value":"splitMultiValueFields"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"AggregateChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"label"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"prefix"}},{"kind":"Field","name":{"kind":"Name","value":"suffix"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}},{"kind":"Field","name":{"kind":"Name","value":"ratioAggregateConfig"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"fieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"optionValue"}}]}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"IframeConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"url"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"StandaloneRichTextConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"body"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"blocknote"}},{"kind":"Field","name":{"kind":"Name","value":"markdown"}},{"kind":"Field","name":{"kind":"Name","value":"tiptap"}}]}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"CalendarConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"EmailsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"EmailThreadConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"CallRecordingSummaryConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"CallRecordingTranscriptConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ChatThreadsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ChatConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"MessageCampaignBodyConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"MessageCampaignDetailsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FieldConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"fieldDisplayMode"}},{"kind":"Field","name":{"kind":"Name","value":"fieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"nestedRelationFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"isUIEditable"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FieldRichTextConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FieldsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"newFieldDefaultVisibility"}},{"kind":"Field","name":{"kind":"Name","value":"shouldAllowUserToSeeHiddenFields"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FormFieldConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"fieldMetadataId"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FilesConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"NotesConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"TasksConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"TimelineConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ViewConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"RecordTableConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"recordLimit"}},{"kind":"Field","name":{"kind":"Name","value":"isUIEditable"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"WorkflowConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"WorkflowRunConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"WorkflowVersionConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FrontComponentConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"frontComponentId"}},{"kind":"Field","name":{"kind":"Name","value":"headerCommandMenuItemUniversalIdentifiers"}}]}}]}},{"kind":"Field","name":{"kind":"Name","value":"pageLayoutTabId"}}]}}]} as unknown as DocumentNode<PageLayoutTabFragmentFragment, unknown>;
export const PageLayoutFragmentFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"PageLayoutFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayout"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"objectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"isSystemSideEffect"}},{"kind":"Field","name":{"kind":"Name","value":"isFirstTabPinned"}},{"kind":"Field","name":{"kind":"Name","value":"defaultTabToFocusOnMobileAndSidePanelId"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}},{"kind":"Field","name":{"kind":"Name","value":"tabs"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"PageLayoutTabFragment"}}]}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"PageLayoutWidgetFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidget"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"isSystemSideEffect"}},{"kind":"Field","name":{"kind":"Name","value":"title"}},{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"objectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}},{"kind":"Field","name":{"kind":"Name","value":"isActive"}},{"kind":"Field","name":{"kind":"Name","value":"deletedAt"}},{"kind":"Field","name":{"kind":"Name","value":"conditionalDisplay"}},{"kind":"Field","name":{"kind":"Name","value":"conditionalAvailabilityExpression"}},{"kind":"Field","name":{"kind":"Name","value":"gridPosition"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"column"}},{"kind":"Field","name":{"kind":"Name","value":"columnSpan"}},{"kind":"Field","name":{"kind":"Name","value":"row"}},{"kind":"Field","name":{"kind":"Name","value":"rowSpan"}}]}},{"kind":"Field","name":{"kind":"Name","value":"position"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidgetGridPosition"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}},{"kind":"Field","name":{"kind":"Name","value":"row"}},{"kind":"Field","name":{"kind":"Name","value":"column"}},{"kind":"Field","name":{"kind":"Name","value":"rowSpan"}},{"kind":"Field","name":{"kind":"Name","value":"columnSpan"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidgetVerticalListPosition"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}},{"kind":"Field","name":{"kind":"Name","value":"index"}},{"kind":"Field","name":{"kind":"Name","value":"heightBehavior"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutWidgetCanvasPosition"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}}]}}]}},{"kind":"Field","name":{"kind":"Name","value":"configuration"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"BarChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"omitNullValues"}},{"kind":"Field","name":{"kind":"Name","value":"axisNameDisplay"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"displayLegend"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMin"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMax"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"groupMode"}},{"kind":"Field","name":{"kind":"Name","value":"layout"}},{"kind":"Field","name":{"kind":"Name","value":"isCumulative"}},{"kind":"Field","name":{"kind":"Name","value":"splitMultiValueFields"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"LineChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"primaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisGroupByDateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisOrderBy"}},{"kind":"Field","name":{"kind":"Name","value":"secondaryAxisManualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"omitNullValues"}},{"kind":"Field","name":{"kind":"Name","value":"axisNameDisplay"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"displayLegend"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMin"}},{"kind":"Field","name":{"kind":"Name","value":"rangeMax"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"isStacked"}},{"kind":"Field","name":{"kind":"Name","value":"isCumulative"}},{"kind":"Field","name":{"kind":"Name","value":"splitMultiValueFields"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PieChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"groupByFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"groupBySubFieldName"}},{"kind":"Field","name":{"kind":"Name","value":"dateGranularity"}},{"kind":"Field","name":{"kind":"Name","value":"orderBy"}},{"kind":"Field","name":{"kind":"Name","value":"manualSortOrder"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"showCenterMetric"}},{"kind":"Field","name":{"kind":"Name","value":"displayLegend"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"hideEmptyCategory"}},{"kind":"Field","name":{"kind":"Name","value":"splitMultiValueFields"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"AggregateChartConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"aggregateOperation"}},{"kind":"Field","name":{"kind":"Name","value":"label"}},{"kind":"Field","name":{"kind":"Name","value":"displayDataLabel"}},{"kind":"Field","name":{"kind":"Name","value":"numberFormat"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"filter"}},{"kind":"Field","name":{"kind":"Name","value":"prefix"}},{"kind":"Field","name":{"kind":"Name","value":"suffix"}},{"kind":"Field","name":{"kind":"Name","value":"timezone"}},{"kind":"Field","name":{"kind":"Name","value":"firstDayOfTheWeek"}},{"kind":"Field","name":{"kind":"Name","value":"ratioAggregateConfig"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"fieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"optionValue"}}]}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"IframeConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"url"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"StandaloneRichTextConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"body"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"blocknote"}},{"kind":"Field","name":{"kind":"Name","value":"markdown"}},{"kind":"Field","name":{"kind":"Name","value":"tiptap"}}]}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"CalendarConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"EmailsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"EmailThreadConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"CallRecordingSummaryConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"CallRecordingTranscriptConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ChatThreadsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ChatConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"MessageCampaignBodyConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"MessageCampaignDetailsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FieldConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"fieldDisplayMode"}},{"kind":"Field","name":{"kind":"Name","value":"fieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"nestedRelationFieldMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"isUIEditable"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FieldRichTextConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FieldsConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"newFieldDefaultVisibility"}},{"kind":"Field","name":{"kind":"Name","value":"shouldAllowUserToSeeHiddenFields"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FormFieldConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"fieldMetadataId"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FilesConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"NotesConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"TasksConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"TimelineConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"ViewConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"RecordTableConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"recordLimit"}},{"kind":"Field","name":{"kind":"Name","value":"isUIEditable"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"WorkflowConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"WorkflowRunConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"WorkflowVersionConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}}]}},{"kind":"InlineFragment","typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"FrontComponentConfiguration"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"configurationType"}},{"kind":"Field","name":{"kind":"Name","value":"frontComponentId"}},{"kind":"Field","name":{"kind":"Name","value":"headerCommandMenuItemUniversalIdentifiers"}}]}}]}},{"kind":"Field","name":{"kind":"Name","value":"pageLayoutTabId"}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"PageLayoutTabFragment"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"PageLayoutTab"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"isSystemSideEffect"}},{"kind":"Field","name":{"kind":"Name","value":"title"}},{"kind":"Field","name":{"kind":"Name","value":"icon"}},{"kind":"Field","name":{"kind":"Name","value":"position"}},{"kind":"Field","name":{"kind":"Name","value":"layoutMode"}},{"kind":"Field","name":{"kind":"Name","value":"widgets"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"PageLayoutWidgetFragment"}}]}},{"kind":"Field","name":{"kind":"Name","value":"pageLayoutId"}},{"kind":"Field","name":{"kind":"Name","value":"isActive"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}}]}}]} as unknown as DocumentNode<PageLayoutFragmentFragment, unknown>;
+export const GettingStartedProgressFieldsFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"GettingStartedProgressFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"GettingStartedProgress"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"steps"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"actionKey"}},{"kind":"Field","name":{"kind":"Name","value":"kind"}},{"kind":"Field","name":{"kind":"Name","value":"title"}},{"kind":"Field","name":{"kind":"Name","value":"doneTitle"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"icon"}},{"kind":"Field","name":{"kind":"Name","value":"iconColor"}},{"kind":"Field","name":{"kind":"Name","value":"promptLabel"}},{"kind":"Field","name":{"kind":"Name","value":"prompt"}}]}},{"kind":"Field","name":{"kind":"Name","value":"completedStepActionKeys"}},{"kind":"Field","name":{"kind":"Name","value":"selectedStepActionKey"}},{"kind":"Field","name":{"kind":"Name","value":"snoozedUntil"}},{"kind":"Field","name":{"kind":"Name","value":"isHidden"}}]}}]} as unknown as DocumentNode<GettingStartedProgressFieldsFragment, unknown>;
export const MarketplaceAppDetailFieldsFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"MarketplaceAppDetailFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"MarketplaceAppDetail"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"sourceType"}},{"kind":"Field","name":{"kind":"Name","value":"sourcePackage"}},{"kind":"Field","name":{"kind":"Name","value":"latestAvailableVersion"}},{"kind":"Field","name":{"kind":"Name","value":"isListed"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"author"}},{"kind":"Field","name":{"kind":"Name","value":"category"}},{"kind":"Field","name":{"kind":"Name","value":"logoUrl"}},{"kind":"Field","name":{"kind":"Name","value":"websiteUrl"}},{"kind":"Field","name":{"kind":"Name","value":"aboutDescription"}},{"kind":"Field","name":{"kind":"Name","value":"pricingDescription"}},{"kind":"Field","name":{"kind":"Name","value":"termsUrl"}},{"kind":"Field","name":{"kind":"Name","value":"emailSupport"}},{"kind":"Field","name":{"kind":"Name","value":"issueReportUrl"}},{"kind":"Field","name":{"kind":"Name","value":"galleryImages"}},{"kind":"Field","name":{"kind":"Name","value":"installCount"}},{"kind":"Field","name":{"kind":"Name","value":"defaultRoleUniversalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"requestedCapabilities"}},{"kind":"Field","name":{"kind":"Name","value":"billsCredits"}},{"kind":"Field","name":{"kind":"Name","value":"objects"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}}]}},{"kind":"Field","name":{"kind":"Name","value":"roles"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"label"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"icon"}},{"kind":"Field","name":{"kind":"Name","value":"canUpdateAllSettings"}},{"kind":"Field","name":{"kind":"Name","value":"canAccessAllTools"}},{"kind":"Field","name":{"kind":"Name","value":"canReadAllObjectRecords"}},{"kind":"Field","name":{"kind":"Name","value":"canUpdateAllObjectRecords"}},{"kind":"Field","name":{"kind":"Name","value":"canSoftDeleteAllObjectRecords"}},{"kind":"Field","name":{"kind":"Name","value":"canDestroyAllObjectRecords"}},{"kind":"Field","name":{"kind":"Name","value":"permissionFlagUniversalIdentifiers"}},{"kind":"Field","name":{"kind":"Name","value":"objectPermissions"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"objectUniversalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"canReadObjectRecords"}},{"kind":"Field","name":{"kind":"Name","value":"canUpdateObjectRecords"}},{"kind":"Field","name":{"kind":"Name","value":"canSoftDeleteObjectRecords"}},{"kind":"Field","name":{"kind":"Name","value":"canDestroyObjectRecords"}}]}},{"kind":"Field","name":{"kind":"Name","value":"fieldPermissions"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"objectUniversalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"fieldUniversalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"canReadFieldValue"}},{"kind":"Field","name":{"kind":"Name","value":"canUpdateFieldValue"}}]}}]}}]}}]} as unknown as DocumentNode<MarketplaceAppDetailFieldsFragment, unknown>;
export const MarketplaceAppFieldsFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"MarketplaceAppFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"MarketplaceApp"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"author"}},{"kind":"Field","name":{"kind":"Name","value":"category"}},{"kind":"Field","name":{"kind":"Name","value":"logoUrl"}},{"kind":"Field","name":{"kind":"Name","value":"sourcePackage"}},{"kind":"Field","name":{"kind":"Name","value":"isListed"}}]}}]} as unknown as DocumentNode<MarketplaceAppFieldsFragment, unknown>;
export const NavigationMenuItemFieldsFragmentDoc = {"kind":"Document","definitions":[{"kind":"FragmentDefinition","name":{"kind":"Name","value":"NavigationMenuItemFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"NavigationMenuItem"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"userWorkspaceId"}},{"kind":"Field","name":{"kind":"Name","value":"targetRecordId"}},{"kind":"Field","name":{"kind":"Name","value":"targetObjectMetadataId"}},{"kind":"Field","name":{"kind":"Name","value":"viewId"}},{"kind":"Field","name":{"kind":"Name","value":"folderId"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"link"}},{"kind":"Field","name":{"kind":"Name","value":"icon"}},{"kind":"Field","name":{"kind":"Name","value":"color"}},{"kind":"Field","name":{"kind":"Name","value":"pageLayoutId"}},{"kind":"Field","name":{"kind":"Name","value":"agentChatChannelId"}},{"kind":"Field","name":{"kind":"Name","value":"position"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}}]}}]} as unknown as DocumentNode<NavigationMenuItemFieldsFragment, unknown>;
@@ -3041,6 +3068,10 @@ export const FindOneFrontComponentDocument = {"kind":"Document","definitions":[{
export const GetApplicationSdkClientChecksumsDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"query","name":{"kind":"Name","value":"GetApplicationSdkClientChecksums"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"applicationId"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"UUID"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"applicationSdkClientChecksums"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"applicationId"},"value":{"kind":"Variable","name":{"kind":"Name","value":"applicationId"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"core"}},{"kind":"Field","name":{"kind":"Name","value":"metadata"}}]}}]}}]} as unknown as DocumentNode<GetApplicationSdkClientChecksumsQuery, GetApplicationSdkClientChecksumsQueryVariables>;
export const GetAutoCompleteAddressDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"query","name":{"kind":"Name","value":"GetAutoCompleteAddress"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"address"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"String"}}}},{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"token"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"String"}}}},{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"country"}},"type":{"kind":"NamedType","name":{"kind":"Name","value":"String"}}},{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"isFieldCity"}},"type":{"kind":"NamedType","name":{"kind":"Name","value":"Boolean"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"getAutoCompleteAddress"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"address"},"value":{"kind":"Variable","name":{"kind":"Name","value":"address"}}},{"kind":"Argument","name":{"kind":"Name","value":"token"},"value":{"kind":"Variable","name":{"kind":"Name","value":"token"}}},{"kind":"Argument","name":{"kind":"Name","value":"country"},"value":{"kind":"Variable","name":{"kind":"Name","value":"country"}}},{"kind":"Argument","name":{"kind":"Name","value":"isFieldCity"},"value":{"kind":"Variable","name":{"kind":"Name","value":"isFieldCity"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"text"}},{"kind":"Field","name":{"kind":"Name","value":"placeId"}}]}}]}}]} as unknown as DocumentNode<GetAutoCompleteAddressQuery, GetAutoCompleteAddressQueryVariables>;
export const GetAddressDetailsDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"query","name":{"kind":"Name","value":"GetAddressDetails"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"placeId"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"String"}}}},{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"token"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"String"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"getAddressDetails"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"placeId"},"value":{"kind":"Variable","name":{"kind":"Name","value":"placeId"}}},{"kind":"Argument","name":{"kind":"Name","value":"token"},"value":{"kind":"Variable","name":{"kind":"Name","value":"token"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"street"}},{"kind":"Field","name":{"kind":"Name","value":"state"}},{"kind":"Field","name":{"kind":"Name","value":"postcode"}},{"kind":"Field","name":{"kind":"Name","value":"city"}},{"kind":"Field","name":{"kind":"Name","value":"country"}},{"kind":"Field","name":{"kind":"Name","value":"location"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"lat"}},{"kind":"Field","name":{"kind":"Name","value":"lng"}}]}}]}}]}}]} as unknown as DocumentNode<GetAddressDetailsQuery, GetAddressDetailsQueryVariables>;
+export const PrepareGettingStartedWorkflowDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"mutation","name":{"kind":"Name","value":"PrepareGettingStartedWorkflow"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"stepActionKey"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"GettingStartedStepActionKey"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"prepareGettingStartedWorkflow"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"stepActionKey"},"value":{"kind":"Variable","name":{"kind":"Name","value":"stepActionKey"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"workflowId"}},{"kind":"Field","name":{"kind":"Name","value":"versionId"}}]}}]}}]} as unknown as DocumentNode<PrepareGettingStartedWorkflowMutation, PrepareGettingStartedWorkflowMutationVariables>;
+export const UpdateGettingStartedDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"mutation","name":{"kind":"Name","value":"UpdateGettingStarted"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"input"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"UpdateGettingStartedInput"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"updateGettingStarted"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"input"},"value":{"kind":"Variable","name":{"kind":"Name","value":"input"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"GettingStartedProgressFields"}}]}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"GettingStartedProgressFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"GettingStartedProgress"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"steps"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"actionKey"}},{"kind":"Field","name":{"kind":"Name","value":"kind"}},{"kind":"Field","name":{"kind":"Name","value":"title"}},{"kind":"Field","name":{"kind":"Name","value":"doneTitle"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"icon"}},{"kind":"Field","name":{"kind":"Name","value":"iconColor"}},{"kind":"Field","name":{"kind":"Name","value":"promptLabel"}},{"kind":"Field","name":{"kind":"Name","value":"prompt"}}]}},{"kind":"Field","name":{"kind":"Name","value":"completedStepActionKeys"}},{"kind":"Field","name":{"kind":"Name","value":"selectedStepActionKey"}},{"kind":"Field","name":{"kind":"Name","value":"snoozedUntil"}},{"kind":"Field","name":{"kind":"Name","value":"isHidden"}}]}}]} as unknown as DocumentNode<UpdateGettingStartedMutation, UpdateGettingStartedMutationVariables>;
+export const GettingStartedProgressDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"query","name":{"kind":"Name","value":"GettingStartedProgress"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"gettingStartedProgress"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"GettingStartedProgressFields"}}]}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"GettingStartedProgressFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"GettingStartedProgress"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"steps"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"actionKey"}},{"kind":"Field","name":{"kind":"Name","value":"kind"}},{"kind":"Field","name":{"kind":"Name","value":"title"}},{"kind":"Field","name":{"kind":"Name","value":"doneTitle"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"icon"}},{"kind":"Field","name":{"kind":"Name","value":"iconColor"}},{"kind":"Field","name":{"kind":"Name","value":"promptLabel"}},{"kind":"Field","name":{"kind":"Name","value":"prompt"}}]}},{"kind":"Field","name":{"kind":"Name","value":"completedStepActionKeys"}},{"kind":"Field","name":{"kind":"Name","value":"selectedStepActionKey"}},{"kind":"Field","name":{"kind":"Name","value":"snoozedUntil"}},{"kind":"Field","name":{"kind":"Name","value":"isHidden"}}]}}]} as unknown as DocumentNode<GettingStartedProgressQuery, GettingStartedProgressQueryVariables>;
+export const GettingStartedWorkflowPreviewsDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"query","name":{"kind":"Name","value":"GettingStartedWorkflowPreviews"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"gettingStartedWorkflowPreviews"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"stepActionKey"}},{"kind":"Field","name":{"kind":"Name","value":"trigger"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"databaseEventAction"}},{"kind":"Field","name":{"kind":"Name","value":"title"}}]}},{"kind":"Field","name":{"kind":"Name","value":"actions"},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"type"}},{"kind":"Field","name":{"kind":"Name","value":"title"}}]}}]}}]}}]} as unknown as DocumentNode<GettingStartedWorkflowPreviewsQuery, GettingStartedWorkflowPreviewsQueryVariables>;
export const CreateOneLogicFunctionDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"mutation","name":{"kind":"Name","value":"CreateOneLogicFunction"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"input"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"CreateLogicFunctionFromSourceInput"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"createOneLogicFunction"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"input"},"value":{"kind":"Variable","name":{"kind":"Name","value":"input"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"LogicFunctionFields"}}]}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"LogicFunctionFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"LogicFunction"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"runtime"}},{"kind":"Field","name":{"kind":"Name","value":"timeoutSeconds"}},{"kind":"Field","name":{"kind":"Name","value":"executionMode"}},{"kind":"Field","name":{"kind":"Name","value":"sourceHandlerPath"}},{"kind":"Field","name":{"kind":"Name","value":"handlerName"}},{"kind":"Field","name":{"kind":"Name","value":"cronTriggerSettings"}},{"kind":"Field","name":{"kind":"Name","value":"databaseEventTriggerSettings"}},{"kind":"Field","name":{"kind":"Name","value":"httpRouteTriggerSettings"}},{"kind":"Field","name":{"kind":"Name","value":"toolTriggerSettings"}},{"kind":"Field","name":{"kind":"Name","value":"workflowActionTriggerSettings"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}}]}}]} as unknown as DocumentNode<CreateOneLogicFunctionMutation, CreateOneLogicFunctionMutationVariables>;
export const DeleteOneLogicFunctionDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"mutation","name":{"kind":"Name","value":"DeleteOneLogicFunction"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"input"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"LogicFunctionIdInput"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"deleteOneLogicFunction"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"input"},"value":{"kind":"Variable","name":{"kind":"Name","value":"input"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"FragmentSpread","name":{"kind":"Name","value":"LogicFunctionFields"}}]}}]}},{"kind":"FragmentDefinition","name":{"kind":"Name","value":"LogicFunctionFields"},"typeCondition":{"kind":"NamedType","name":{"kind":"Name","value":"LogicFunction"}},"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"id"}},{"kind":"Field","name":{"kind":"Name","value":"name"}},{"kind":"Field","name":{"kind":"Name","value":"description"}},{"kind":"Field","name":{"kind":"Name","value":"runtime"}},{"kind":"Field","name":{"kind":"Name","value":"timeoutSeconds"}},{"kind":"Field","name":{"kind":"Name","value":"executionMode"}},{"kind":"Field","name":{"kind":"Name","value":"sourceHandlerPath"}},{"kind":"Field","name":{"kind":"Name","value":"handlerName"}},{"kind":"Field","name":{"kind":"Name","value":"cronTriggerSettings"}},{"kind":"Field","name":{"kind":"Name","value":"databaseEventTriggerSettings"}},{"kind":"Field","name":{"kind":"Name","value":"httpRouteTriggerSettings"}},{"kind":"Field","name":{"kind":"Name","value":"toolTriggerSettings"}},{"kind":"Field","name":{"kind":"Name","value":"workflowActionTriggerSettings"}},{"kind":"Field","name":{"kind":"Name","value":"applicationId"}},{"kind":"Field","name":{"kind":"Name","value":"universalIdentifier"}},{"kind":"Field","name":{"kind":"Name","value":"createdAt"}},{"kind":"Field","name":{"kind":"Name","value":"updatedAt"}}]}}]} as unknown as DocumentNode<DeleteOneLogicFunctionMutation, DeleteOneLogicFunctionMutationVariables>;
export const ExecuteOneLogicFunctionDocument = {"kind":"Document","definitions":[{"kind":"OperationDefinition","operation":"mutation","name":{"kind":"Name","value":"ExecuteOneLogicFunction"},"variableDefinitions":[{"kind":"VariableDefinition","variable":{"kind":"Variable","name":{"kind":"Name","value":"input"}},"type":{"kind":"NonNullType","type":{"kind":"NamedType","name":{"kind":"Name","value":"ExecuteOneLogicFunctionInput"}}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"executeOneLogicFunction"},"arguments":[{"kind":"Argument","name":{"kind":"Name","value":"input"},"value":{"kind":"Variable","name":{"kind":"Name","value":"input"}}}],"selectionSet":{"kind":"SelectionSet","selections":[{"kind":"Field","name":{"kind":"Name","value":"data"}},{"kind":"Field","name":{"kind":"Name","value":"logs"}},{"kind":"Field","name":{"kind":"Name","value":"duration"}},{"kind":"Field","name":{"kind":"Name","value":"status"}},{"kind":"Field","name":{"kind":"Name","value":"error"}}]}}]}}]} as unknown as DocumentNode<ExecuteOneLogicFunctionMutation, ExecuteOneLogicFunctionMutationVariables>;
diff --git a/packages/twenty-front/src/modules/app/hooks/__tests__/usePageChangeEffectNavigateLocation.test.ts b/packages/twenty-front/src/modules/app/hooks/__tests__/usePageChangeEffectNavigateLocation.test.ts
index 4c930cd1908..4b5224f7c9f 100644
--- a/packages/twenty-front/src/modules/app/hooks/__tests__/usePageChangeEffectNavigateLocation.test.ts
+++ b/packages/twenty-front/src/modules/app/hooks/__tests__/usePageChangeEffectNavigateLocation.test.ts
@@ -1,4 +1,5 @@
import { useIsLogged } from '@/auth/hooks/useIsLogged';
+import { useShouldOpenGettingStarted } from '@/getting-started/hooks/useShouldOpenGettingStarted';
import { useDefaultHomePagePath } from '@/navigation/hooks/useDefaultHomePagePath';
import { useOnboardingStatus } from '@/onboarding/hooks/useOnboardingStatus';
import { useIsWorkspaceActivationStatusEqualsTo } from '@/workspace/hooks/useIsWorkspaceActivationStatusEqualsTo';
@@ -51,6 +52,24 @@ jest.mocked(useDefaultHomePagePath).mockReturnValue({
defaultHomePagePath,
});
+jest.mock('@/getting-started/hooks/useShouldOpenGettingStarted');
+jest.mocked(useShouldOpenGettingStarted).mockReturnValue({
+ shouldOpenGettingStarted: false,
+ isLoading: false,
+});
+const setupMockShouldOpenGettingStarted = (
+ shouldOpenGettingStartedResult?: ReturnType<
+ typeof useShouldOpenGettingStarted
+ >,
+) => {
+ jest.mocked(useShouldOpenGettingStarted).mockReturnValueOnce(
+ shouldOpenGettingStartedResult ?? {
+ shouldOpenGettingStarted: false,
+ isLoading: false,
+ },
+ );
+};
+
jest.mock('@/domain-manager/hooks/useIsCurrentLocationOnAWorkspace');
const setupMockIsOnAWorkspace = (isOnAWorkspace: boolean) => {
jest.mocked(useIsCurrentLocationOnAWorkspace).mockReturnValue({
@@ -134,6 +153,7 @@ const testCases: {
isBillingEnabled?: boolean;
isMinimalMetadataReady?: boolean;
isOnboardingCheckoutPending?: boolean;
+ shouldOpenGettingStartedResult?: { shouldOpenGettingStarted: boolean; isLoading: boolean };
}[] = [
{ loc: AppPath.Verify, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.PLAN_REQUIRED, res: AppPath.PlanRequired },
{ loc: AppPath.Verify, isLogged: true, isWorkspaceSuspended: true, onboardingStatus: OnboardingStatus.COMPLETED, res: getSettingsPath(SettingsPath.Billing) },
@@ -314,6 +334,16 @@ const testCases: {
{ loc: AppPath.Home, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.BOOK_CALL, res: AppPath.BookCall },
{ loc: AppPath.Home, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, res: undefined },
+ { loc: AppPath.GettingStarted, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.PLAN_REQUIRED, res: AppPath.PlanRequired },
+ { loc: AppPath.GettingStarted, isLogged: true, isWorkspaceSuspended: true, onboardingStatus: OnboardingStatus.COMPLETED, res: getSettingsPath(SettingsPath.Billing) },
+ { loc: AppPath.GettingStarted, isLogged: false, isWorkspaceSuspended: false, onboardingStatus: undefined, res: AppPath.SignInUp },
+ { loc: AppPath.GettingStarted, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.WORKSPACE_ACTIVATION, res: AppPath.WorkspaceActivation },
+ { loc: AppPath.GettingStarted, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.PROFILE_CREATION, res: AppPath.CreateProfile },
+ { loc: AppPath.GettingStarted, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.SYNC_EMAIL, res: AppPath.SyncEmails },
+ { loc: AppPath.GettingStarted, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.INVITE_TEAM, res: AppPath.InviteTeam },
+ { loc: AppPath.GettingStarted, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.BOOK_CALL, res: AppPath.BookCall },
+ { loc: AppPath.GettingStarted, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, res: undefined },
+
{ loc: AppPath.OpportunitiesPage, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.PLAN_REQUIRED, res: AppPath.PlanRequired },
{ loc: AppPath.OpportunitiesPage, isLogged: true, isWorkspaceSuspended: true, onboardingStatus: OnboardingStatus.COMPLETED, res: getSettingsPath(SettingsPath.Billing) },
{ loc: AppPath.OpportunitiesPage, isLogged: false, isWorkspaceSuspended: false, onboardingStatus: undefined, res: AppPath.SignInUp },
@@ -445,7 +475,7 @@ const testCases: {
// returnToPath: should redirect to saved path instead of defaultHomePagePath
{ loc: AppPath.Verify, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, returnToPath: '/authorize?clientId=abc', res: '/authorize?clientId=abc' },
{ loc: AppPath.SignInUp, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, returnToPath: '/objects/tasks', res: '/objects/tasks' },
- { loc: AppPath.Index, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, returnToPath: '/settings/api-keys', res: '/settings/api-keys' },
+ { loc: AppPath.Index, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, returnToPath: '/settings/api-keys', shouldOpenGettingStartedResult: { shouldOpenGettingStarted: true, isLoading: false }, res: '/settings/api-keys' },
{ loc: AppPath.PlanRequiredSuccess, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, isOnboardingCheckoutPending: true, res: undefined },
@@ -454,6 +484,9 @@ const testCases: {
// isOnAWorkspace:false — on default domain, don't redirect to returnToPath or defaultHomePagePath from auth pages
{ loc: AppPath.Verify, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, isOnAWorkspace: false, res: undefined },
{ loc: AppPath.SignInUp, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, isOnAWorkspace: false, res: undefined },
+
+ { loc: AppPath.Index, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, shouldOpenGettingStartedResult: { shouldOpenGettingStarted: true, isLoading: false }, res: AppPath.GettingStarted },
+ { loc: AppPath.Verify, isLogged: true, isWorkspaceSuspended: false, onboardingStatus: OnboardingStatus.COMPLETED, shouldOpenGettingStartedResult: { shouldOpenGettingStarted: false, isLoading: true }, res: undefined },
];
describe('usePageChangeEffectNavigateLocation', () => {
@@ -474,9 +507,11 @@ describe('usePageChangeEffectNavigateLocation', () => {
isBillingEnabled,
isMinimalMetadataReady,
isOnboardingCheckoutPending,
+ shouldOpenGettingStartedResult,
res,
}) => {
setupMockIsMatchingLocation(loc);
+ setupMockShouldOpenGettingStarted(shouldOpenGettingStartedResult);
setupMockOnboardingStatus(onboardingStatus);
setupMockIsWorkspaceActivationStatusEqualsTo(isWorkspaceSuspended);
setupMockIsLogged(isLogged);
@@ -525,7 +560,8 @@ describe('usePageChangeEffectNavigateLocation', () => {
[
'checkoutPending:paymentSuccessDefersRedirect',
'checkoutPending:verifyStillRedirects',
- ].length,
+ ].length +
+ ['gettingStarted:open', 'gettingStarted:loading'].length,
);
});
});
diff --git a/packages/twenty-front/src/modules/app/hooks/usePageChangeEffectNavigateLocation.ts b/packages/twenty-front/src/modules/app/hooks/usePageChangeEffectNavigateLocation.ts
index 25c37d0af55..091ed122c74 100644
--- a/packages/twenty-front/src/modules/app/hooks/usePageChangeEffectNavigateLocation.ts
+++ b/packages/twenty-front/src/modules/app/hooks/usePageChangeEffectNavigateLocation.ts
@@ -6,6 +6,7 @@ import { currentWorkspaceState } from '@/auth/states/currentWorkspaceState';
import { returnToPathState } from '@/auth/states/returnToPathState';
import { billingState } from '@/client-config/states/billingState';
import { useIsCurrentLocationOnAWorkspace } from '@/domain-manager/hooks/useIsCurrentLocationOnAWorkspace';
+import { useShouldOpenGettingStarted } from '@/getting-started/hooks/useShouldOpenGettingStarted';
import { isMinimalMetadataReadyState } from '@/metadata-store/states/isMinimalMetadataReadyState';
import { useDefaultHomePagePath } from '@/navigation/hooks/useDefaultHomePagePath';
import { objectMetadataItemsSelector } from '@/object-metadata/states/objectMetadataItemsSelector';
@@ -43,6 +44,14 @@ export const usePageChangeEffectNavigateLocation = () => {
);
const { defaultHomePagePath } = useDefaultHomePagePath();
const location = useLocation();
+ const { shouldOpenGettingStarted, isLoading: isGettingStartedLoading } =
+ useShouldOpenGettingStarted({
+ isEnabled:
+ isLogged &&
+ isOnAWorkspace &&
+ onboardingStatus === OnboardingStatus.COMPLETED &&
+ !isWorkspaceSuspended,
+ });
const billing = useAtomStateValue(billingState);
const isBillingEnabled = billing?.isBillingEnabled ?? false;
@@ -80,6 +89,11 @@ export const usePageChangeEffectNavigateLocation = () => {
const resolvedReturnToPath = isNonEmptyString(returnToPath)
? returnToPath
: readReturnToPathFromUrlSearchParams();
+ const homePath = shouldOpenGettingStarted
+ ? AppPath.GettingStarted
+ : defaultHomePagePath;
+ const landingPath =
+ resolvedReturnToPath ?? (isGettingStartedLoading ? undefined : homePath);
const isOnboardingCheckoutPending = useAtomStateValue(
isOnboardingCheckoutPendingState,
@@ -189,11 +203,11 @@ export const usePageChangeEffectNavigateLocation = () => {
return;
}
- return resolvedReturnToPath ?? defaultHomePagePath;
+ return landingPath;
}
if (isMatchingLocation(location, AppPath.Index) && isLogged) {
- return resolvedReturnToPath ?? defaultHomePagePath;
+ return landingPath;
}
if (isMatchingLocation(location, AppPath.Dpa)) {
diff --git a/packages/twenty-front/src/modules/app/routing/utils/createWorkspaceRouteObjects.tsx b/packages/twenty-front/src/modules/app/routing/utils/createWorkspaceRouteObjects.tsx
index 41cdb8859e0..7875739020a 100644
--- a/packages/twenty-front/src/modules/app/routing/utils/createWorkspaceRouteObjects.tsx
+++ b/packages/twenty-front/src/modules/app/routing/utils/createWorkspaceRouteObjects.tsx
@@ -9,6 +9,12 @@ import {
import { type WorkspaceRouteObject } from '@/app/routing/types/WorkspaceRouteObject';
import { RecordIndexSkeletonLoader } from '@/object-record/record-index/components/RecordIndexSkeletonLoader';
+const GettingStartedPage = lazy(() =>
+ import('~/pages/getting-started/GettingStartedPage').then((module) => ({
+ default: module.GettingStartedPage,
+ })),
+);
+
const AgentCoreIndexPage = lazy(() =>
import('~/pages/object-core/AgentCoreIndexPage').then((module) => ({
default: module.AgentCoreIndexPage,
@@ -84,6 +90,14 @@ export const createWorkspaceRouteObjects = ({
});
return [
+ {
+ path: AppPath.GettingStarted,
+ element: (
+ <LazyRoute>
+ <GettingStartedPage />
+ </LazyRoute>
+ ),
+ },
{
path: AppPath.WorkflowCoreShowPage,
element: (
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedAppInstallButton.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedAppInstallButton.tsx
new file mode 100644
index 00000000000..9a6df579ae5
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedAppInstallButton.tsx
@@ -0,0 +1,77 @@
+import { currentWorkspaceState } from '@/auth/states/currentWorkspaceState';
+import { useUpdateGettingStarted } from '@/getting-started/hooks/useUpdateGettingStarted';
+import { SettingsApplicationInstallPermissionValidationModal } from '@/marketplace/components/SettingsApplicationInstallPermissionValidationModal';
+import { useInstallMarketplaceApp } from '@/marketplace/hooks/useInstallMarketplaceApp';
+import { getMarketplaceAppDefaultRoleManifest } from '@/marketplace/utils/getMarketplaceAppDefaultRoleManifest';
+import { useDialog } from '@/ui/layout/dialog/hooks/useDialog';
+import { useAtomStateValue } from '@/ui/utilities/state/jotai/hooks/useAtomStateValue';
+import { useQuery } from '@apollo/client/react';
+import { useLingui } from '@lingui/react/macro';
+import { isDefined } from 'twenty-shared/utils';
+import { IconButton } from 'twenty-ui/components/input';
+import { IconCheck, IconPlus } from 'twenty-ui/icon';
+import {
+ FindMarketplaceAppDetailDocument,
+ GettingStartedStepActionKey,
+ type MarketplaceApp,
+} from '~/generated-metadata/graphql';
+
+type GettingStartedAppInstallButtonProps = {
+ item: Pick<MarketplaceApp, 'id' | 'name'>;
+};
+
+export const GettingStartedAppInstallButton = ({
+ item: { id: universalIdentifier, name: appLabel },
+}: GettingStartedAppInstallButtonProps) => {
+ const { t } = useLingui();
+ const { openDialog } = useDialog();
+ const { updateGettingStarted } = useUpdateGettingStarted();
+ const currentWorkspace = useAtomStateValue(currentWorkspaceState);
+ const isInstalled =
+ currentWorkspace?.installedApplications.some(
+ (application) => application.universalIdentifier === universalIdentifier,
+ ) ?? false;
+ const { data } = useQuery(FindMarketplaceAppDetailDocument, {
+ variables: { universalIdentifier },
+ skip: isInstalled,
+ });
+ const marketplaceAppDetail = data?.findMarketplaceAppDetail;
+ const { install, isInstalling } = useInstallMarketplaceApp({
+ universalIdentifier,
+ onCompleted: () =>
+ void updateGettingStarted({
+ completedStepActionKey: GettingStartedStepActionKey.INSTALL_APP,
+ }),
+ });
+ const modalInstanceId = `getting-started-install-${universalIdentifier}`;
+
+ return (
+ <>
+ <IconButton
+ size="sm"
+ aria-label={t`Install ${appLabel}`}
+ loading={isInstalling}
+ disabled={isInstalled || !isDefined(marketplaceAppDetail)}
+ onClick={() => openDialog(modalInstanceId)}
+ >
+ {isInstalled ? <IconCheck /> : <IconPlus />}
+ </IconButton>
+ {isDefined(marketplaceAppDetail) && (
+ <SettingsApplicationInstallPermissionValidationModal
+ modalInstanceId={modalInstanceId}
+ appDisplayName={marketplaceAppDetail.name}
+ appLogoUrl={marketplaceAppDetail.logoUrl ?? undefined}
+ defaultRole={getMarketplaceAppDefaultRoleManifest(
+ marketplaceAppDetail,
+ )}
+ appObjects={marketplaceAppDetail.objects ?? undefined}
+ requestedCapabilities={marketplaceAppDetail.requestedCapabilities}
+ billsCredits={marketplaceAppDetail.billsCredits}
+ isListed={marketplaceAppDetail.isListed}
+ onAuthorize={install}
+ isInstalling={isInstalling}
+ />
+ )}
+ </>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedAppsAction.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedAppsAction.tsx
new file mode 100644
index 00000000000..108982d1272
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedAppsAction.tsx
@@ -0,0 +1,93 @@
+import { GettingStartedAppInstallButton } from '@/getting-started/components/GettingStartedAppInstallButton';
+import { useMarketplaceApps } from '@/marketplace/hooks/useMarketplaceApps';
+import { getApplicationDescriptionSummary } from '@/settings/applications/utils/getApplicationDescriptionSummary';
+import { SettingsListSkeletonCard } from '@/settings/components/SettingsListSkeletonCard';
+import { styled } from '@linaria/react';
+import { GETTING_STARTED_APP_UNIVERSAL_IDENTIFIERS } from 'twenty-shared/application';
+import { isDefined } from 'twenty-shared/utils';
+import { Avatar } from 'twenty-ui/primitives/data-display';
+import { themeCssVariables } from 'twenty-ui/theme';
+import { getAbsoluteImageUrl } from '~/utils/image/getAbsoluteImageUrl';
+
+const StyledList = styled.ul`
+ border: 1px solid ${themeCssVariables.border.color.medium};
+ border-radius: ${themeCssVariables.border.radius.md};
+ list-style: none;
+ margin: 0;
+ overflow: hidden;
+ padding: 0;
+`;
+
+const StyledRow = styled.li`
+ align-items: center;
+ display: flex;
+ gap: ${themeCssVariables.spacing[3]};
+ padding: ${themeCssVariables.spacing[5]} ${themeCssVariables.spacing[4]};
+
+ & + & {
+ border-top: 1px solid ${themeCssVariables.border.color.medium};
+ }
+`;
+
+const StyledText = styled.div`
+ display: flex;
+ flex: 1;
+ flex-direction: column;
+ line-height: ${themeCssVariables.text.lineHeight.lg};
+ min-width: 0;
+`;
+
+const StyledName = styled.span`
+ color: ${themeCssVariables.font.color.primary};
+ font-weight: ${themeCssVariables.font.weight.medium};
+`;
+
+const StyledDescription = styled.span`
+ color: ${themeCssVariables.font.color.tertiary};
+ overflow: hidden;
+ text-overflow: ellipsis;
+ white-space: nowrap;
+`;
+
+export const GettingStartedAppsAction = () => {
+ const { data: marketplaceApps, isLoading } = useMarketplaceApps();
+
+ const featuredApps = GETTING_STARTED_APP_UNIVERSAL_IDENTIFIERS.map(
+ (universalIdentifier) =>
+ marketplaceApps.find(
+ (marketplaceApp) =>
+ marketplaceApp.id === universalIdentifier && marketplaceApp.isListed,
+ ),
+ ).filter(isDefined);
+
+ if (isLoading) {
+ return <SettingsListSkeletonCard />;
+ }
+
+ if (featuredApps.length === 0) {
+ return null;
+ }
+
+ return (
+ <StyledList>
+ {featuredApps.map((featuredApp) => (
+ <StyledRow key={featuredApp.id}>
+ <Avatar
+ src={getAbsoluteImageUrl(featuredApp.logoUrl) ?? null}
+ name={featuredApp.name}
+ colorSeed={featuredApp.name}
+ size="lg"
+ shape="square"
+ />
+ <StyledText>
+ <StyledName>{featuredApp.name}</StyledName>
+ <StyledDescription>
+ {getApplicationDescriptionSummary(featuredApp.description)}
+ </StyledDescription>
+ </StyledText>
+ <GettingStartedAppInstallButton item={featuredApp} />
+ </StyledRow>
+ ))}
+ </StyledList>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedAutoAdvanceEffect.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedAutoAdvanceEffect.tsx
new file mode 100644
index 00000000000..f13359e59f4
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedAutoAdvanceEffect.tsx
@@ -0,0 +1,41 @@
+import { GETTING_STARTED_AUTO_ADVANCE_DELAY_MS } from '@/getting-started/constants/GettingStartedAutoAdvanceDelayMs';
+import { useSelectGettingStartedStep } from '@/getting-started/hooks/useSelectGettingStartedStep';
+import { gettingStartedJustCompletedStepState } from '@/getting-started/states/gettingStartedJustCompletedStepState';
+import { useSetAtomState } from '@/ui/utilities/state/jotai/hooks/useSetAtomState';
+import { useEffect, useEffectEvent } from 'react';
+
+import { type GettingStartedStepActionKey } from '~/generated-metadata/graphql';
+
+type GettingStartedAutoAdvanceEffectProps = {
+ completedStepActionKey: GettingStartedStepActionKey;
+ nextStepActionKey: GettingStartedStepActionKey;
+};
+
+export const GettingStartedAutoAdvanceEffect = ({
+ completedStepActionKey,
+ nextStepActionKey,
+}: GettingStartedAutoAdvanceEffectProps) => {
+ const { selectGettingStartedStep } = useSelectGettingStartedStep();
+ const setGettingStartedJustCompletedStep = useSetAtomState(
+ gettingStartedJustCompletedStepState,
+ );
+ const advance = useEffectEvent(() =>
+ selectGettingStartedStep(nextStepActionKey),
+ );
+
+ useEffect(() => {
+ const timeoutId = setTimeout(
+ () => advance(),
+ GETTING_STARTED_AUTO_ADVANCE_DELAY_MS,
+ );
+
+ return () => clearTimeout(timeoutId);
+ }, [completedStepActionKey]);
+
+ useEffect(
+ () => () => setGettingStartedJustCompletedStep(null),
+ [setGettingStartedJustCompletedStep],
+ );
+
+ return null;
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedImportAction.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedImportAction.tsx
new file mode 100644
index 00000000000..5d53abec7ad
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedImportAction.tsx
@@ -0,0 +1,161 @@
+import { serializePlainTextAsAdvancedTextEditorDocument } from '@/advanced-text-editor/utils/serializePlainTextAsAdvancedTextEditorDocument';
+import { useCanSendAgentChatMessage } from '@/ai/hooks/useCanSendAgentChatMessage';
+import { useOpenAskAiPageWithPreprompt } from '@/ai/hooks/useOpenAskAiPageWithPreprompt';
+import { contextStoreCurrentObjectMetadataItemIdComponentState } from '@/context-store/states/contextStoreCurrentObjectMetadataItemIdComponentState';
+import { GETTING_STARTED_IMPORT_CONTEXT_STORE_INSTANCE_ID } from '@/getting-started/constants/GettingStartedImportContextStoreInstanceId';
+import { GETTING_STARTED_IMPORT_PROMPT } from '@/getting-started/constants/GettingStartedImportPrompt';
+import { SPREADSHEET_EXPORT_GUIDES } from '@/getting-started/constants/SpreadsheetExportGuides';
+import { useUpdateGettingStarted } from '@/getting-started/hooks/useUpdateGettingStarted';
+import { useObjectMetadataItem } from '@/object-metadata/hooks/useObjectMetadataItem';
+import { useOpenObjectRecordsSpreadsheetImportDialog } from '@/object-record/spreadsheet-import/hooks/useOpenObjectRecordsSpreadsheetImportDialog';
+import { useHasPermissionFlag } from '@/settings/roles/hooks/useHasPermissionFlag';
+import { useSetAtomComponentState } from '@/ui/utilities/state/jotai/hooks/useSetAtomComponentState';
+import { styled } from '@linaria/react';
+import { useLingui } from '@lingui/react/macro';
+import { useDropzone } from 'react-dropzone';
+import { CoreObjectNameSingular } from 'twenty-shared/types';
+import { useToast } from 'twenty-ui/components/feedback';
+import { IconExternalLink, IconUpload } from 'twenty-ui/icon';
+import { Button } from 'twenty-ui/primitives/input';
+import { Text } from 'twenty-ui/primitives/typography';
+import { themeCssVariables } from 'twenty-ui/theme';
+import {
+ GettingStartedStepActionKey,
+ PermissionFlagType,
+} from '~/generated-metadata/graphql';
+
+const StyledColumn = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[2]};
+ outline: none;
+`;
+
+const StyledUploadField = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing['0.5']};
+`;
+
+const StyledHelperRow = styled.div`
+ align-items: baseline;
+ display: flex;
+ justify-content: space-between;
+`;
+
+const StyledExportRow = styled.div`
+ align-items: center;
+ display: flex;
+ flex-wrap: wrap;
+ gap: ${themeCssVariables.spacing[2]};
+`;
+
+export const GettingStartedImportAction = () => {
+ const { t } = useLingui();
+ const { enqueueToast } = useToast();
+ const { updateGettingStarted } = useUpdateGettingStarted();
+ const { objectMetadataItem } = useObjectMetadataItem({
+ objectNameSingular: CoreObjectNameSingular.Person,
+ });
+ const setContextStoreCurrentObjectMetadataItemId = useSetAtomComponentState(
+ contextStoreCurrentObjectMetadataItemIdComponentState,
+ GETTING_STARTED_IMPORT_CONTEXT_STORE_INSTANCE_ID,
+ );
+ const { openObjectRecordsSpreadsheetImportDialog } =
+ useOpenObjectRecordsSpreadsheetImportDialog(CoreObjectNameSingular.Person);
+ const { openAskAiPageWithPreprompt } = useOpenAskAiPageWithPreprompt();
+ const hasAiPermission = useHasPermissionFlag(PermissionFlagType.AI);
+ const canSendAgentChatMessage = useCanSendAgentChatMessage();
+ const canImportWithAi = hasAiPermission && canSendAgentChatMessage;
+
+ const importFilesWithAi = (files: File[]) => {
+ void openAskAiPageWithPreprompt({
+ serializedDocument: serializePlainTextAsAdvancedTextEditorDocument(
+ t(GETTING_STARTED_IMPORT_PROMPT),
+ ),
+ mode: 'SEND',
+ files,
+ });
+ void updateGettingStarted({
+ completedStepActionKey: GettingStartedStepActionKey.IMPORT_DATA,
+ });
+ };
+
+ const { getRootProps, getInputProps, open } = useDropzone({
+ multiple: true,
+ noClick: true,
+ noKeyboard: true,
+ disabled: !canImportWithAi,
+ accept: {
+ 'application/vnd.ms-excel': ['.xls'],
+ 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': [
+ '.xlsx',
+ ],
+ 'text/csv': ['.csv'],
+ },
+ onDropAccepted: importFilesWithAi,
+ onDropRejected: () =>
+ enqueueToast({
+ status: 'error',
+ children: t`Only CSV and Excel files are supported`,
+ }),
+ });
+
+ const openImportDialog = () => {
+ setContextStoreCurrentObjectMetadataItemId(objectMetadataItem.id);
+ openObjectRecordsSpreadsheetImportDialog({
+ uploadStepHook: async (importedRows) => {
+ void updateGettingStarted({
+ completedStepActionKey: GettingStartedStepActionKey.IMPORT_DATA,
+ });
+
+ return importedRows;
+ },
+ });
+ };
+
+ return (
+ <StyledColumn
+ // oxlint-disable-next-line react/jsx-props-no-spreading
+ {...getRootProps()}
+ >
+ <input
+ // oxlint-disable-next-line react/jsx-props-no-spreading
+ {...getInputProps()}
+ />
+ <StyledUploadField>
+ <Text size="xs" color="light">{t`Spreadsheet`}</Text>
+ <Button
+ fullWidth
+ startIcon={<IconUpload />}
+ onClick={canImportWithAi ? open : openImportDialog}
+ >{t`Upload file`}</Button>
+ <StyledHelperRow>
+ <Text
+ size="sm"
+ color="light"
+ >{t`A CSV or Excel export from any tool`}</Text>
+ {canImportWithAi && (
+ <Button
+ variant="link"
+ onClick={openImportDialog}
+ >{t`Use the import wizard instead`}</Button>
+ )}
+ </StyledHelperRow>
+ </StyledUploadField>
+ <StyledExportRow>
+ <Text size="sm" color="tertiary">{t`Export a CSV from`}</Text>
+ {SPREADSHEET_EXPORT_GUIDES.map((guide) => (
+ <Button
+ key={guide.name}
+ render={<a href={guide.url} target="_blank" rel="noreferrer" />}
+ nativeButton={false}
+ endIcon={<IconExternalLink />}
+ >
+ {guide.name}
+ </Button>
+ ))}
+ </StyledExportRow>
+ </StyledColumn>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedInviteAction.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedInviteAction.tsx
new file mode 100644
index 00000000000..b1154a23bf3
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedInviteAction.tsx
@@ -0,0 +1,178 @@
+import { currentUserState } from '@/auth/states/currentUserState';
+import { useUpdateGettingStarted } from '@/getting-started/hooks/useUpdateGettingStarted';
+import { getValidInviteEmails } from '@/onboarding/utils/getValidInviteEmails';
+import { TextInput } from '@/ui/input/components/TextInput';
+import { useAtomStateValue } from '@/ui/utilities/state/jotai/hooks/useAtomStateValue';
+import { useCreateWorkspaceInvitation } from '@/workspace-invitation/hooks/useCreateWorkspaceInvitation';
+import { useQuery } from '@apollo/client/react';
+import { styled } from '@linaria/react';
+import { useLingui } from '@lingui/react/macro';
+import { isNonEmptyString } from '@sniptt/guards';
+import { type FormEvent, useState } from 'react';
+import { isDefined, isNonEmptyArray } from 'twenty-shared/utils';
+import { useToast } from 'twenty-ui/components/feedback';
+import { IconX } from 'twenty-ui/icon';
+import { Button } from 'twenty-ui/primitives/input';
+import { Text } from 'twenty-ui/primitives/typography';
+import { themeCssVariables } from 'twenty-ui/theme';
+import {
+ GetInviteSuggestionsDocument,
+ GettingStartedStepActionKey,
+} from '~/generated-metadata/graphql';
+
+const StyledForm = styled.form`
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[4]};
+`;
+
+const StyledEmailField = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[1]};
+`;
+
+const StyledEmailInputs = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[4]};
+`;
+
+const StyledFooter = styled.div`
+ display: flex;
+`;
+
+export const GettingStartedInviteAction = () => {
+ const { t } = useLingui();
+ const { enqueueToast } = useToast();
+ const { updateGettingStarted } = useUpdateGettingStarted();
+ const { sendInvitation } = useCreateWorkspaceInvitation();
+ const currentUser = useAtomStateValue(currentUserState);
+ const emailDomain = currentUser?.email.split('@').at(1);
+ const emailPlaceholder = isNonEmptyString(emailDomain)
+ ? t`name@${emailDomain}`
+ : t`Email address`;
+ const { data } = useQuery(GetInviteSuggestionsDocument, {
+ fetchPolicy: 'cache-first',
+ });
+ const [draftEmails, setDraftEmails] = useState<string[] | null>(null);
+ const [isSending, setIsSending] = useState(false);
+
+ const suggestedEmails = (data?.getInviteSuggestions ?? []).map(
+ (suggestion) => suggestion.email,
+ );
+ const emails = draftEmails ?? [...suggestedEmails, ''];
+ const validEmails = getValidInviteEmails(emails);
+ const hasSuggestedEmail = emails.some((email) =>
+ suggestedEmails.includes(email),
+ );
+
+ const isInvalidEmail = (email: string) =>
+ isNonEmptyString(email) && !isNonEmptyArray(getValidInviteEmails([email]));
+
+ const hasInvalidEmail = emails.some(isInvalidEmail);
+
+ const saveDraftEmails = (nextEmails: string[]) => {
+ const lastFilledEmailIndex = nextEmails.findLastIndex(isNonEmptyString);
+
+ setDraftEmails([...nextEmails.slice(0, lastFilledEmailIndex + 1), '']);
+ };
+
+ const updateEmail = ({ index, email }: { index: number; email: string }) =>
+ saveDraftEmails(
+ emails.map((currentEmail, emailIndex) =>
+ emailIndex === index ? email : currentEmail,
+ ),
+ );
+
+ const removeEmail = (index: number) =>
+ saveDraftEmails(emails.filter((_, emailIndex) => emailIndex !== index));
+
+ const sendInvitations = async (event: FormEvent<HTMLFormElement>) => {
+ event.preventDefault();
+ setIsSending(true);
+
+ try {
+ const { data: sendInvitationsData } = await sendInvitation({
+ emails: validEmails,
+ });
+
+ if (!isDefined(sendInvitationsData)) {
+ return;
+ }
+
+ const { result: invitations, errors } =
+ sendInvitationsData.sendInvitations;
+
+ if (isNonEmptyArray(errors)) {
+ enqueueToast({ status: 'error', children: errors.join(', ') });
+ }
+
+ if (invitations.length === 0) {
+ return;
+ }
+
+ const invitedEmails = invitations.map((invitation) =>
+ invitation.email.toLowerCase(),
+ );
+
+ setDraftEmails([
+ ...validEmails.filter((email) => !invitedEmails.includes(email)),
+ '',
+ ]);
+ enqueueToast({
+ status: 'success',
+ children: t`Invite link sent to email addresses`,
+ });
+ void updateGettingStarted({
+ completedStepActionKey: GettingStartedStepActionKey.INVITE_TEAM,
+ });
+ } finally {
+ setIsSending(false);
+ }
+ };
+
+ return (
+ <StyledForm onSubmit={(event) => void sendInvitations(event)}>
+ <StyledEmailField>
+ {hasSuggestedEmail && (
+ <Text size="xs" color="light">{t`Found in your emails`}</Text>
+ )}
+ <StyledEmailInputs>
+ {emails.map((email, index) => {
+ const emailNumber = index + 1;
+ const isLastInput = index === emails.length - 1;
+
+ return (
+ <TextInput
+ key={index}
+ type="email"
+ value={email}
+ error={isInvalidEmail(email) ? t`Invalid email` : undefined}
+ noErrorHelper
+ aria-label={t`Teammate email ${emailNumber}`}
+ placeholder={emailPlaceholder}
+ disabled={isSending}
+ onChange={(text) => updateEmail({ index, email: text })}
+ RightIcon={isLastInput ? undefined : IconX}
+ onRightIconClick={
+ isLastInput ? undefined : () => removeEmail(index)
+ }
+ fullWidth
+ />
+ );
+ })}
+ </StyledEmailInputs>
+ </StyledEmailField>
+ <StyledFooter>
+ <Button
+ type="submit"
+ variant="solid"
+ color="accent"
+ loading={isSending}
+ disabled={validEmails.length === 0 || hasInvalidEmail}
+ >{t`Invite`}</Button>
+ </StyledFooter>
+ </StyledForm>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedKeepPlanButton.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedKeepPlanButton.tsx
new file mode 100644
index 00000000000..12816deb795
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedKeepPlanButton.tsx
@@ -0,0 +1,50 @@
+import { useGettingStartedTrial } from '@/getting-started/hooks/useGettingStartedTrial';
+import { getGettingStartedKeepPlanDescription } from '@/getting-started/utils/getGettingStartedKeepPlanDescription';
+import { UpdatePaymentMethodModal } from '@/settings/billing/components/UpdatePaymentMethodModal';
+import { useDialog } from '@/ui/layout/dialog/hooks/useDialog';
+import { useId } from 'react';
+import { isDefined } from 'twenty-shared/utils';
+import { IconCreditCard } from 'twenty-ui/icon';
+import { Button, type ButtonProps } from 'twenty-ui/primitives/input';
+
+type GettingStartedKeepPlanButtonProps = Pick<
+ ButtonProps,
+ 'size' | 'color' | 'fullWidth'
+>;
+
+export const GettingStartedKeepPlanButton = ({
+ size,
+ color,
+ fullWidth,
+}: GettingStartedKeepPlanButtonProps) => {
+ const modalInstanceId = `getting-started-keep-plan-${useId()}`;
+ const { openDialog } = useDialog();
+ const { keepPlanLabel, planLabel, formattedTrialEnd } =
+ useGettingStartedTrial();
+
+ if (!isDefined(formattedTrialEnd)) {
+ return null;
+ }
+
+ return (
+ <>
+ <Button
+ size={size}
+ color={color}
+ fullWidth={fullWidth}
+ startIcon={<IconCreditCard />}
+ onClick={() => openDialog(modalInstanceId)}
+ >
+ {keepPlanLabel}
+ </Button>
+ <UpdatePaymentMethodModal
+ modalInstanceId={modalInstanceId}
+ title={keepPlanLabel}
+ description={getGettingStartedKeepPlanDescription({
+ planLabel,
+ formattedTrialEnd,
+ })}
+ />
+ </>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedMailboxAction.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedMailboxAction.tsx
new file mode 100644
index 00000000000..247e384e4a7
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedMailboxAction.tsx
@@ -0,0 +1,109 @@
+import { isGoogleMessagingEnabledState } from '@/client-config/states/isGoogleMessagingEnabledState';
+import { isMicrosoftMessagingEnabledState } from '@/client-config/states/isMicrosoftMessagingEnabledState';
+import { SettingsConnectedAccountsTableHeader } from '@/settings/accounts/components/SettingsConnectedAccountsTableHeader';
+import { useMyConnectedAccounts } from '@/settings/accounts/hooks/useMyConnectedAccounts';
+import { useTriggerApisOAuth } from '@/settings/accounts/hooks/useTriggerApiOAuth';
+import { SettingsConnectedAccountsTableRow } from '@/settings/components/SettingsConnectedAccountsTableRow';
+import { Table } from '@/ui/layout/table/components/Table';
+import { useAtomStateValue } from '@/ui/utilities/state/jotai/hooks/useAtomStateValue';
+import { styled } from '@linaria/react';
+import { useLingui } from '@lingui/react/macro';
+import { AppPath, ConnectedAccountProvider } from 'twenty-shared/types';
+import { isDefined } from 'twenty-shared/utils';
+import { IconGoogle, IconLock, IconMicrosoft } from 'twenty-ui/icon';
+import { Button } from 'twenty-ui/primitives/input';
+import { themeCssVariables, useTheme } from 'twenty-ui/theme';
+import {
+ CalendarChannelVisibility,
+ MessageChannelVisibility,
+} from '~/generated-metadata/graphql';
+
+const StyledColumn = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[3]};
+`;
+
+const StyledPrivacyNote = styled.div`
+ align-items: center;
+ background: ${themeCssVariables.background.transparent.light};
+ border-radius: ${themeCssVariables.border.radius.md};
+ color: ${themeCssVariables.font.color.secondary};
+ display: flex;
+ gap: ${themeCssVariables.spacing[2]};
+ height: ${themeCssVariables.spacing[10]};
+ padding: 0 ${themeCssVariables.spacing[2]};
+`;
+
+const StyledProviderButtons = styled.div`
+ display: grid;
+ gap: ${themeCssVariables.spacing[2]};
+ grid-template-columns: 1fr 1fr;
+`;
+
+export const GettingStartedMailboxAction = () => {
+ const { t } = useLingui();
+ const theme = useTheme();
+ const { triggerApisOAuth } = useTriggerApisOAuth();
+ const { accounts, loading } = useMyConnectedAccounts();
+ const activeAccounts = accounts.filter(
+ (account) => !isDefined(account.archivedAt),
+ );
+ const isGoogleMessagingEnabled = useAtomStateValue(
+ isGoogleMessagingEnabledState,
+ );
+ const isMicrosoftMessagingEnabled = useAtomStateValue(
+ isMicrosoftMessagingEnabledState,
+ );
+
+ const connectMailbox = (provider: ConnectedAccountProvider) =>
+ triggerApisOAuth(provider, {
+ redirectLocation: AppPath.GettingStarted,
+ messageVisibility: MessageChannelVisibility.METADATA,
+ calendarVisibility: CalendarChannelVisibility.METADATA,
+ skipMessageChannelConfiguration: true,
+ });
+
+ if (loading) {
+ return null;
+ }
+
+ if (activeAccounts.length > 0) {
+ return (
+ <Table>
+ <SettingsConnectedAccountsTableHeader />
+ {activeAccounts.map((account) => (
+ <SettingsConnectedAccountsTableRow
+ key={account.id}
+ account={account}
+ />
+ ))}
+ </Table>
+ );
+ }
+
+ return (
+ <StyledColumn>
+ <StyledPrivacyNote>
+ <IconLock size={theme.icon.size.md} />
+ {t`Teammates see who you talk to, not what you write.`}
+ </StyledPrivacyNote>
+ <StyledProviderButtons>
+ <Button
+ fullWidth
+ disabled={!isGoogleMessagingEnabled}
+ startIcon={<IconGoogle />}
+ onClick={() => void connectMailbox(ConnectedAccountProvider.GOOGLE)}
+ >{t`Continue with Google`}</Button>
+ <Button
+ fullWidth
+ disabled={!isMicrosoftMessagingEnabled}
+ startIcon={<IconMicrosoft />}
+ onClick={() =>
+ void connectMailbox(ConnectedAccountProvider.MICROSOFT)
+ }
+ >{t`Continue with Microsoft`}</Button>
+ </StyledProviderButtons>
+ </StyledColumn>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedMailboxDoneDescription.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedMailboxDoneDescription.tsx
new file mode 100644
index 00000000000..17f1c94cd36
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedMailboxDoneDescription.tsx
@@ -0,0 +1,35 @@
+import { type GettingStartedStepDoneDescriptionProps } from '@/getting-started/types/GettingStartedStepDoneDescriptionProps';
+import { formatNumber } from '@/localization/utils/formatNumber';
+import { useFindManyRecords } from '@/object-record/hooks/useFindManyRecords';
+import { plural } from '@lingui/core/macro';
+import { useLingui } from '@lingui/react/macro';
+import { CoreObjectNameSingular } from 'twenty-shared/types';
+import { isDefined } from 'twenty-shared/utils';
+
+type GettingStartedMailboxDoneDescriptionProps =
+ GettingStartedStepDoneDescriptionProps;
+
+export const GettingStartedMailboxDoneDescription = ({
+ description,
+}: GettingStartedMailboxDoneDescriptionProps) => {
+ const { t } = useLingui();
+ const { totalCount: peopleCount } = useFindManyRecords({
+ objectNameSingular: CoreObjectNameSingular.Person,
+ limit: 1,
+ recordGqlFields: { id: true },
+ });
+ const { totalCount: companyCount } = useFindManyRecords({
+ objectNameSingular: CoreObjectNameSingular.Company,
+ limit: 1,
+ recordGqlFields: { id: true },
+ });
+
+ if (!isDefined(peopleCount) || !isDefined(companyCount)) {
+ return description;
+ }
+
+ const formattedPeopleCount = formatNumber(peopleCount);
+ const formattedCompanyCount = formatNumber(companyCount);
+
+ return t`${plural(peopleCount, { one: `${formattedPeopleCount} person`, other: `${formattedPeopleCount} people` })} and ${plural(companyCount, { one: `${formattedCompanyCount} company`, other: `${formattedCompanyCount} companies` })} in your workspace`;
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedOpenedSection.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedOpenedSection.tsx
new file mode 100644
index 00000000000..259452849cc
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedOpenedSection.tsx
@@ -0,0 +1,40 @@
+import { NavigationDrawerAnimatedCollapseWrapper } from '@/ui/navigation/navigation-drawer/components/NavigationDrawerAnimatedCollapseWrapper';
+import { NavigationDrawerItem } from '@/ui/navigation/navigation-drawer/components/NavigationDrawerItem';
+import { NavigationDrawerSection } from '@/ui/navigation/navigation-drawer/components/NavigationDrawerSection';
+import { NavigationDrawerSectionTitle } from '@/ui/navigation/navigation-drawer/components/NavigationDrawerSectionTitle';
+import { useLingui } from '@lingui/react/macro';
+import { useMatch } from 'react-router-dom';
+import { AppPath } from 'twenty-shared/types';
+import { isDefined } from 'twenty-shared/utils';
+import { IconRocket, type TablerIconsProps } from 'twenty-ui/icon';
+import { useTheme } from 'twenty-ui/theme';
+
+export const GettingStartedOpenedSection = () => {
+ const { t } = useLingui();
+ const theme = useTheme();
+ const isGettingStartedPageOpen = isDefined(useMatch(AppPath.GettingStarted));
+
+ if (!isGettingStartedPageOpen) {
+ return null;
+ }
+
+ return (
+ <NavigationDrawerSection>
+ <NavigationDrawerAnimatedCollapseWrapper>
+ <NavigationDrawerSectionTitle label={t`Opened`} />
+ </NavigationDrawerAnimatedCollapseWrapper>
+ <NavigationDrawerItem
+ label={t`Getting started`}
+ to={AppPath.GettingStarted}
+ Icon={({ size, stroke }: TablerIconsProps) => (
+ <IconRocket
+ size={size}
+ stroke={stroke}
+ color={theme.tag.text.purple}
+ />
+ )}
+ active
+ />
+ </NavigationDrawerSection>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedPageContent.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedPageContent.tsx
new file mode 100644
index 00000000000..6e4c11ddd93
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedPageContent.tsx
@@ -0,0 +1,261 @@
+import { ContextStoreComponentInstanceContext } from '@/context-store/states/contexts/ContextStoreComponentInstanceContext';
+import { GettingStartedAutoAdvanceEffect } from '@/getting-started/components/GettingStartedAutoAdvanceEffect';
+import { GettingStartedKeepPlanButton } from '@/getting-started/components/GettingStartedKeepPlanButton';
+import { GettingStartedRollingText } from '@/getting-started/components/GettingStartedRollingText';
+import { GettingStartedStepStack } from '@/getting-started/components/GettingStartedStepStack';
+import { GETTING_STARTED_CONTENT_MAX_WIDTH } from '@/getting-started/constants/GettingStartedContentMaxWidth';
+import { GETTING_STARTED_IMPORT_CONTEXT_STORE_INSTANCE_ID } from '@/getting-started/constants/GettingStartedImportContextStoreInstanceId';
+import { useGettingStartedProgress } from '@/getting-started/hooks/useGettingStartedProgress';
+import { useGettingStartedTrial } from '@/getting-started/hooks/useGettingStartedTrial';
+import { useSelectGettingStartedStep } from '@/getting-started/hooks/useSelectGettingStartedStep';
+import { gettingStartedJustCompletedStepState } from '@/getting-started/states/gettingStartedJustCompletedStepState';
+import { getGettingStartedStepSelection } from '@/getting-started/utils/getGettingStartedStepSelection';
+import { StyledOnboardingStepTitle } from '@/onboarding/components/StyledOnboardingStepTitle';
+import { useHasPermissionFlag } from '@/settings/roles/hooks/useHasPermissionFlag';
+import { SpreadsheetImportProvider } from '@/spreadsheet-import/provider/components/SpreadsheetImportProvider';
+import { useAtomStateValue } from '@/ui/utilities/state/jotai/hooks/useAtomStateValue';
+import { useQuery } from '@apollo/client/react';
+import { styled } from '@linaria/react';
+import { plural } from '@lingui/core/macro';
+import { Plural, useLingui } from '@lingui/react/macro';
+import { isDefined, isNonEmptyArray } from 'twenty-shared/utils';
+import { Callout } from 'twenty-ui/components/feedback';
+import { IconCheck, IconListCheck } from 'twenty-ui/icon';
+import { Loader } from 'twenty-ui/primitives/feedback';
+import { Button } from 'twenty-ui/primitives/input';
+import { themeCssVariables, useTheme } from 'twenty-ui/theme';
+
+import {
+ GettingStartedWorkflowPreviewsDocument,
+ PermissionFlagType,
+} from '~/generated-metadata/graphql';
+
+const StyledScroll = styled.div`
+ container-name: getting-started-scroll;
+ container-type: inline-size;
+ flex: 1;
+ overflow: auto;
+ padding: ${themeCssVariables.spacing[10]} ${themeCssVariables.spacing[6]};
+`;
+
+const StyledContent = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[8]};
+ margin: 0 auto;
+ max-width: ${GETTING_STARTED_CONTENT_MAX_WIDTH}px;
+`;
+
+const StyledHeading = styled.div`
+ align-items: center;
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[5]};
+ text-align: center;
+`;
+
+const StyledCountdown = styled.div`
+ align-items: center;
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[3]};
+`;
+
+const StyledDigits = styled.div`
+ display: flex;
+ gap: ${themeCssVariables.spacing[1]};
+`;
+
+const StyledDigit = styled.span`
+ align-items: center;
+ background: ${themeCssVariables.color.orange3};
+ border: 1px solid ${themeCssVariables.color.amber6};
+ border-radius: ${themeCssVariables.border.radius.md};
+ box-sizing: border-box;
+ color: ${themeCssVariables.color.amber11};
+ display: flex;
+ font-size: ${themeCssVariables.font.size.xxl};
+ font-weight: ${themeCssVariables.font.weight.semiBold};
+ height: ${themeCssVariables.spacing[11]};
+ isolation: isolate;
+ justify-content: center;
+ position: relative;
+ width: calc(
+ ${themeCssVariables.spacing[8]} + ${themeCssVariables.spacing['0.5']}
+ );
+
+ &::after {
+ background: ${themeCssVariables.color.amber11};
+ content: '';
+ height: 1px;
+ left: 0;
+ opacity: 0.2;
+ position: absolute;
+ right: 0;
+ top: 50%;
+ z-index: -1;
+ }
+`;
+
+const StyledGoal = styled.div`
+ align-items: center;
+ align-self: center;
+ border: 1px dashed ${themeCssVariables.border.color.strong};
+ border-radius: ${themeCssVariables.border.radius.md};
+ color: ${themeCssVariables.font.color.secondary};
+ display: flex;
+ gap: ${themeCssVariables.spacing[2]};
+ height: calc(
+ ${themeCssVariables.spacing[7]} + ${themeCssVariables.spacing['0.5']}
+ );
+ padding: 0 ${themeCssVariables.spacing[1]} 0 ${themeCssVariables.spacing[2]};
+`;
+
+const StyledFooter = styled.div`
+ display: flex;
+ justify-content: center;
+`;
+
+export const GettingStartedPageContent = () => {
+ const { t } = useLingui();
+ const theme = useTheme();
+ const { progress, loading, error, refetch } = useGettingStartedProgress();
+ const { selectGettingStartedStep, isSaving } = useSelectGettingStartedStep();
+ const { formattedTrialEnd, daysLeft, isCountdownVisible, canKeepPlan } =
+ useGettingStartedTrial();
+ const gettingStartedJustCompletedStep = useAtomStateValue(
+ gettingStartedJustCompletedStepState,
+ );
+ const hasWorkflowsPermission = useHasPermissionFlag(
+ PermissionFlagType.WORKFLOWS,
+ );
+
+ useQuery(GettingStartedWorkflowPreviewsDocument, {
+ skip: !hasWorkflowsPermission,
+ });
+
+ const stepDefinitions = progress?.steps ?? [];
+ const stepActionKeys = stepDefinitions.map(({ actionKey }) => actionKey);
+ const completedStepActionKeys = progress?.completedStepActionKeys ?? [];
+ const remainingSteps = stepActionKeys.filter(
+ (stepActionKey) => !completedStepActionKeys.includes(stepActionKey),
+ );
+ const isComplete = remainingSteps.length === 0;
+ const { selectedStepActionKey, nextStep, stepAfterSkip } =
+ getGettingStartedStepSelection({
+ stepActionKeys,
+ completedStepActionKeys,
+ selectedStepActionKey:
+ gettingStartedJustCompletedStep ?? progress?.selectedStepActionKey,
+ });
+ const isSelectedStepCompleted = completedStepActionKeys.includes(
+ selectedStepActionKey,
+ );
+
+ const remainingStepCount = remainingSteps.length;
+ const remainingStepsLabel = isDefined(formattedTrialEnd)
+ ? plural(remainingStepCount, {
+ one: `Finish # step by ${formattedTrialEnd}`,
+ other: `Finish # steps by ${formattedTrialEnd}`,
+ })
+ : plural(remainingStepCount, {
+ one: 'Finish # step',
+ other: 'Finish # steps',
+ });
+ const goalLabel = isComplete ? t`All steps done` : remainingStepsLabel;
+
+ return (
+ <StyledScroll>
+ {isDefined(gettingStartedJustCompletedStep) && (
+ <GettingStartedAutoAdvanceEffect
+ completedStepActionKey={gettingStartedJustCompletedStep}
+ nextStepActionKey={nextStep}
+ />
+ )}
+ <ContextStoreComponentInstanceContext.Provider
+ value={{ instanceId: GETTING_STARTED_IMPORT_CONTEXT_STORE_INSTANCE_ID }}
+ >
+ <SpreadsheetImportProvider />
+ </ContextStoreComponentInstanceContext.Provider>
+ <StyledContent>
+ <StyledHeading>
+ <StyledCountdown>
+ {isCountdownVisible && (
+ <StyledDigits role="img" aria-label={String(daysLeft)}>
+ {String(daysLeft)
+ .padStart(2, '0')
+ .split('')
+ .map((digit, index) => (
+ <StyledDigit key={index}>{digit}</StyledDigit>
+ ))}
+ </StyledDigits>
+ )}
+ <StyledOnboardingStepTitle>
+ {isCountdownVisible ? (
+ <Plural
+ value={daysLeft}
+ one="day left in your trial"
+ other="days left in your trial"
+ />
+ ) : (
+ t`Finish your setup`
+ )}
+ </StyledOnboardingStepTitle>
+ </StyledCountdown>
+ {canKeepPlan && <GettingStartedKeepPlanButton color="accent" />}
+ </StyledHeading>
+ {loading && !isDefined(progress) && (
+ <Loader role="status" aria-label={t`Loading your progress`} />
+ )}
+ {isDefined(error) && !isDefined(progress) && (
+ <Callout
+ status="error"
+ role="alert"
+ title={t`Could not load Getting started.`}
+ action={
+ <Callout.Action onClick={() => void refetch()}>
+ {t`Try again`}
+ </Callout.Action>
+ }
+ />
+ )}
+ {isDefined(progress) && (
+ <>
+ <StyledGoal>
+ {isComplete ? (
+ <IconCheck
+ size={theme.icon.size.md}
+ color={theme.font.color.tertiary}
+ />
+ ) : (
+ <IconListCheck
+ size={theme.icon.size.md}
+ color={theme.font.color.tertiary}
+ />
+ )}
+ <GettingStartedRollingText text={goalLabel} />
+ </StyledGoal>
+ {isNonEmptyArray(stepActionKeys) && (
+ <GettingStartedStepStack
+ steps={stepDefinitions}
+ selectedStepActionKey={selectedStepActionKey}
+ completedStepActionKeys={completedStepActionKeys}
+ />
+ )}
+ {!isComplete && stepAfterSkip !== selectedStepActionKey && (
+ <StyledFooter>
+ <Button
+ variant="ghost"
+ disabled={isSaving}
+ onClick={() => selectGettingStartedStep(stepAfterSkip)}
+ >
+ {isSelectedStepCompleted ? t`Back to current step` : t`Skip`}
+ </Button>
+ </StyledFooter>
+ )}
+ </>
+ )}
+ </StyledContent>
+ </StyledScroll>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedPromptAction.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedPromptAction.tsx
new file mode 100644
index 00000000000..d1db8c45d8c
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedPromptAction.tsx
@@ -0,0 +1,86 @@
+import { serializePlainTextAsAdvancedTextEditorDocument } from '@/advanced-text-editor/utils/serializePlainTextAsAdvancedTextEditorDocument';
+import { AiChatComposerActionsRow } from '@/ai/components/internal/AiChatComposerActionsRow';
+import { useCanSendAgentChatMessage } from '@/ai/hooks/useCanSendAgentChatMessage';
+import { useOpenAskAiPageWithPreprompt } from '@/ai/hooks/useOpenAskAiPageWithPreprompt';
+import { useUpdateGettingStarted } from '@/getting-started/hooks/useUpdateGettingStarted';
+import { TextArea } from '@/ui/input/components/TextArea';
+import { styled } from '@linaria/react';
+import { useLingui } from '@lingui/react/macro';
+import { isNonEmptyString } from '@sniptt/guards';
+import { useState } from 'react';
+import { IconButton } from 'twenty-ui/components/input';
+import { IconArrowUp } from 'twenty-ui/icon';
+import { themeCssVariables } from 'twenty-ui/theme';
+import { type GettingStartedStepDefinition } from '~/generated-metadata/graphql';
+
+const StyledComposer = styled.div`
+ background: ${themeCssVariables.background.transparent.lighter};
+ border: 1px solid ${themeCssVariables.border.color.medium};
+ border-radius: ${themeCssVariables.border.radius.md};
+ box-sizing: border-box;
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[2]};
+ justify-content: space-between;
+ min-height: ${themeCssVariables.spacing[20]};
+ padding: calc(
+ ${themeCssVariables.spacing[2]} + ${themeCssVariables.spacing['1.5']}
+ )
+ ${themeCssVariables.spacing[2]} ${themeCssVariables.spacing[2]};
+`;
+
+type GettingStartedPromptActionProps = {
+ stepDefinition: Pick<
+ GettingStartedStepDefinition,
+ 'actionKey' | 'prompt' | 'promptLabel'
+ >;
+};
+
+export const GettingStartedPromptAction = ({
+ stepDefinition: { actionKey, prompt: defaultPrompt, promptLabel },
+}: GettingStartedPromptActionProps) => {
+ const { t } = useLingui();
+ const [prompt, setPrompt] = useState(defaultPrompt ?? '');
+ const { openAskAiPageWithPreprompt } = useOpenAskAiPageWithPreprompt();
+ const { updateGettingStarted } = useUpdateGettingStarted();
+ const canSendAgentChatMessage = useCanSendAgentChatMessage();
+ const trimmedPrompt = prompt.trim();
+
+ const sendPrompt = () => {
+ openAskAiPageWithPreprompt({
+ serializedDocument:
+ serializePlainTextAsAdvancedTextEditorDocument(trimmedPrompt),
+ mode: 'SEND',
+ });
+ void updateGettingStarted({ completedStepActionKey: actionKey });
+ };
+
+ return (
+ <StyledComposer role="group" aria-label={promptLabel ?? undefined}>
+ <TextArea
+ textAreaId={`getting-started-${actionKey}-prompt`}
+ variant="transparent"
+ value={prompt}
+ onChange={setPrompt}
+ />
+ <AiChatComposerActionsRow
+ modelTierDropdownId={`getting-started-${actionKey}-model`}
+ sendButton={
+ <IconButton
+ size="sm"
+ variant="solid"
+ color="accent"
+ shape="round"
+ aria-label={t`Send instructions`}
+ disabled={
+ !canSendAgentChatMessage || !isNonEmptyString(trimmedPrompt)
+ }
+ onClick={sendPrompt}
+ >
+ <IconArrowUp />
+ </IconButton>
+ }
+ />
+ </StyledComposer>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedRollingText.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedRollingText.tsx
new file mode 100644
index 00000000000..e5b14a69153
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedRollingText.tsx
@@ -0,0 +1,42 @@
+import { EASE_OUT } from '@/ui/theme/constants/EaseOut';
+import { styled } from '@linaria/react';
+import { AnimatePresence, motion, useReducedMotion } from 'framer-motion';
+import { useTheme } from 'twenty-ui/theme';
+
+const ROLL_OFFSET_PERCENT = 60;
+
+const StyledContainer = styled.span`
+ display: inline-flex;
+ position: relative;
+`;
+
+type GettingStartedRollingTextProps = {
+ text: string;
+};
+
+export const GettingStartedRollingText = ({
+ text,
+}: GettingStartedRollingTextProps) => {
+ const theme = useTheme();
+ const shouldReduceMotion = useReducedMotion();
+ const rollOffsetPercent = shouldReduceMotion ? 0 : ROLL_OFFSET_PERCENT;
+
+ return (
+ <StyledContainer>
+ <AnimatePresence initial={false} mode="popLayout">
+ <motion.span
+ key={text}
+ initial={{ opacity: 0, y: `${rollOffsetPercent}%` }}
+ animate={{ opacity: 1, y: '0%' }}
+ exit={{ opacity: 0, y: `${-rollOffsetPercent}%` }}
+ transition={{
+ duration: theme.animation.duration.normal,
+ ease: EASE_OUT,
+ }}
+ >
+ {text}
+ </motion.span>
+ </AnimatePresence>
+ </StyledContainer>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedSidebarCard.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedSidebarCard.tsx
new file mode 100644
index 00000000000..9eff669fb8b
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedSidebarCard.tsx
@@ -0,0 +1,168 @@
+import { GettingStartedKeepPlanButton } from '@/getting-started/components/GettingStartedKeepPlanButton';
+import { GettingStartedSidebarTrialCountdown } from '@/getting-started/components/GettingStartedSidebarTrialCountdown';
+import { useGettingStartedProgress } from '@/getting-started/hooks/useGettingStartedProgress';
+import { useGettingStartedTrial } from '@/getting-started/hooks/useGettingStartedTrial';
+import { getGettingStartedRemainingSteps } from '@/getting-started/utils/getGettingStartedRemainingSteps';
+import { NavigationButton } from '@/ui/input/components/NavigationButton';
+import { NavigationDrawerSection } from '@/ui/navigation/navigation-drawer/components/NavigationDrawerSection';
+import { useIsNavigationDrawerContentExpanded } from '@/ui/navigation/navigation-drawer/hooks/useIsNavigationDrawerContentExpanded';
+import { useSubscriptionStatus } from '@/workspace/hooks/useSubscriptionStatus';
+import { styled } from '@linaria/react';
+import { useLingui } from '@lingui/react/macro';
+import { Link, useMatch } from 'react-router-dom';
+import { AppPath } from 'twenty-shared/types';
+import { isDefined } from 'twenty-shared/utils';
+import { IconChevronRight, IconRocket } from 'twenty-ui/icon';
+import { ProgressBar } from 'twenty-ui/primitives/feedback';
+import { Card } from 'twenty-ui/primitives/surfaces';
+import { themeCssVariables, useTheme } from 'twenty-ui/theme';
+
+import { SubscriptionStatus } from '~/generated-metadata/graphql';
+
+const StyledContainer = styled.div`
+ border-radius: ${themeCssVariables.border.radius.md};
+ box-shadow: ${themeCssVariables.boxShadow.light};
+ position: relative;
+`;
+
+const StyledCardLink = styled(Link)`
+ border-radius: inherit;
+ inset: 0;
+ position: absolute;
+`;
+
+const StyledButtonLayer = styled.div`
+ position: relative;
+ z-index: 1;
+`;
+
+const StyledCardBody = styled.div`
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[2]};
+ padding: ${themeCssVariables.spacing[3]};
+`;
+
+const StyledHeader = styled.div`
+ align-items: center;
+ color: ${themeCssVariables.font.color.primary};
+ display: flex;
+ font-weight: ${themeCssVariables.font.weight.medium};
+ gap: ${themeCssVariables.spacing[2]};
+ height: ${themeCssVariables.spacing[6]};
+ padding: 0 ${themeCssVariables.spacing[1]};
+ white-space: nowrap;
+
+ &[data-countdown] {
+ color: ${themeCssVariables.font.color.secondary};
+ height: ${themeCssVariables.spacing[8]};
+ }
+`;
+
+const StyledStepCount = styled.span`
+ color: ${themeCssVariables.font.color.secondary};
+ flex: 1;
+ font-weight: ${themeCssVariables.font.weight.regular};
+ text-align: end;
+
+ &[data-countdown] {
+ color: ${themeCssVariables.font.color.light};
+ text-align: start;
+ }
+`;
+
+export const GettingStartedSidebarCard = () => {
+ const { t } = useLingui();
+ const theme = useTheme();
+ const isTrialing = useSubscriptionStatus() === SubscriptionStatus.Trialing;
+ const { progress } = useGettingStartedProgress({ isEnabled: isTrialing });
+ const { isCountdownVisible, daysLeft, trialDays, canKeepPlan } =
+ useGettingStartedTrial();
+ const isNavigationDrawerContentExpanded =
+ useIsNavigationDrawerContentExpanded();
+ const isGettingStartedPageOpen = isDefined(useMatch(AppPath.GettingStarted));
+
+ if (
+ !isTrialing ||
+ !isNavigationDrawerContentExpanded ||
+ !isDefined(progress) ||
+ progress.isHidden
+ ) {
+ return null;
+ }
+
+ const remainingSteps = getGettingStartedRemainingSteps({
+ steps: progress.steps,
+ completedStepActionKeys: progress.completedStepActionKeys,
+ });
+
+ if (remainingSteps.length === 0) {
+ return null;
+ }
+
+ return (
+ <NavigationDrawerSection>
+ <StyledContainer>
+ <Card.Root backgroundColor={themeCssVariables.background.primary}>
+ <StyledCardBody>
+ <StyledHeader data-countdown={isCountdownVisible || undefined}>
+ <IconRocket
+ size={theme.icon.size.md}
+ color={
+ isCountdownVisible
+ ? theme.font.color.secondary
+ : theme.tag.text.purple
+ }
+ />
+ {t`Getting started`}
+ <StyledStepCount data-countdown={isCountdownVisible || undefined}>
+ {`${progress.completedStepActionKeys.length}/${progress.steps.length}`}
+ </StyledStepCount>
+ {!isGettingStartedPageOpen && (
+ <IconChevronRight
+ size={theme.icon.size.md}
+ color={theme.font.color.tertiary}
+ />
+ )}
+ </StyledHeader>
+ {isCountdownVisible ? (
+ <GettingStartedSidebarTrialCountdown
+ daysLeft={daysLeft}
+ trialDays={trialDays}
+ />
+ ) : (
+ <ProgressBar
+ aria-label={t`Getting started progress`}
+ value={progress.completedStepActionKeys.length}
+ max={progress.steps.length}
+ size="sm"
+ backgroundColor={
+ themeCssVariables.background.transparent.medium
+ }
+ barColor={themeCssVariables.color.blue}
+ withBorderRadius
+ />
+ )}
+ <StyledButtonLayer>
+ {canKeepPlan ? (
+ <GettingStartedKeepPlanButton size="sm" fullWidth />
+ ) : (
+ <NavigationButton
+ size="sm"
+ fullWidth
+ to={AppPath.GettingStarted}
+ >{t`Continue setup`}</NavigationButton>
+ )}
+ </StyledButtonLayer>
+ </StyledCardBody>
+ </Card.Root>
+ {!isGettingStartedPageOpen && (
+ <StyledCardLink
+ to={AppPath.GettingStarted}
+ aria-label={t`Open Getting started`}
+ />
+ )}
+ </StyledContainer>
+ </NavigationDrawerSection>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedSidebarTrialCountdown.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedSidebarTrialCountdown.tsx
new file mode 100644
index 00000000000..34cc4e6094f
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedSidebarTrialCountdown.tsx
@@ -0,0 +1,76 @@
+import { styled } from '@linaria/react';
+import { Plural, useLingui } from '@lingui/react/macro';
+import { IconHourglassHigh } from 'twenty-ui/icon';
+import { themeCssVariables, useTheme } from 'twenty-ui/theme';
+
+const StyledDivider = styled.div`
+ border-top: 1px solid ${themeCssVariables.border.color.light};
+`;
+
+const StyledTrialRow = styled.div`
+ align-items: center;
+ color: ${themeCssVariables.font.color.tertiary};
+ display: flex;
+ gap: ${themeCssVariables.spacing[1]};
+`;
+
+const StyledDaysLeft = styled.span`
+ color: ${themeCssVariables.font.color.primary};
+ flex: 1;
+ font-weight: ${themeCssVariables.font.weight.semiBold};
+`;
+
+const StyledTrialLabel = styled.span`
+ font-size: ${themeCssVariables.font.size.sm};
+`;
+
+const StyledTrialDays = styled.div`
+ display: flex;
+ gap: ${themeCssVariables.spacing[1]};
+`;
+
+const StyledTrialDay = styled.span`
+ background: ${themeCssVariables.background.transparent.medium};
+ border-radius: ${themeCssVariables.border.radius.pill};
+ corner-shape: round;
+ flex: 1;
+ height: ${themeCssVariables.spacing['1.5']};
+
+ &[data-remaining] {
+ background: ${themeCssVariables.color.amber10};
+ }
+`;
+
+type GettingStartedSidebarTrialCountdownProps = {
+ daysLeft: number;
+ trialDays: number;
+};
+
+export const GettingStartedSidebarTrialCountdown = ({
+ daysLeft,
+ trialDays,
+}: GettingStartedSidebarTrialCountdownProps) => {
+ const { t } = useLingui();
+ const theme = useTheme();
+
+ return (
+ <>
+ <StyledDivider />
+ <StyledTrialRow>
+ <IconHourglassHigh size={theme.icon.size.md} />
+ <StyledDaysLeft>
+ <Plural value={daysLeft} one="# day left" other="# days left" />
+ </StyledDaysLeft>
+ <StyledTrialLabel>{t`Trial`}</StyledTrialLabel>
+ </StyledTrialRow>
+ <StyledTrialDays aria-hidden>
+ {Array.from({ length: trialDays }, (_, index) => (
+ <StyledTrialDay
+ key={index}
+ data-remaining={index >= trialDays - daysLeft || undefined}
+ />
+ ))}
+ </StyledTrialDays>
+ </>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedSnoozeMenu.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedSnoozeMenu.tsx
new file mode 100644
index 00000000000..b942113cd4c
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedSnoozeMenu.tsx
@@ -0,0 +1,119 @@
+import { useGettingStartedTrial } from '@/getting-started/hooks/useGettingStartedTrial';
+import { useUpdateGettingStarted } from '@/getting-started/hooks/useUpdateGettingStarted';
+import { type GettingStartedSnoozeOption } from '@/getting-started/types/GettingStartedSnoozeOption';
+import { getGettingStartedSnoozedUntil } from '@/getting-started/utils/getGettingStartedSnoozedUntil';
+import { useDateTimeFormat } from '@/localization/hooks/useDateTimeFormat';
+import { dateLocaleState } from '@/localization/states/dateLocaleState';
+import { formatDateISOStringToCustomUnicodeFormat } from '@/localization/utils/formatDateISOStringToCustomUnicodeFormat';
+import { DropdownContent } from '@/ui/layout/dropdown/components/DropdownContent';
+import { DropdownRoot } from '@/ui/layout/dropdown/components/DropdownRoot';
+import { GenericDropdownContentWidth } from '@/ui/layout/dropdown/constants/GenericDropdownContentWidth';
+import { useDefaultHomePagePath } from '@/navigation/hooks/useDefaultHomePagePath';
+import { useAtomStateValue } from '@/ui/utilities/state/jotai/hooks/useAtomStateValue';
+import { useLingui } from '@lingui/react/macro';
+import { useId } from 'react';
+import { useNavigate } from 'react-router-dom';
+import { isDefined } from 'twenty-shared/utils';
+import { LightIconButton } from 'twenty-ui/components/input';
+import { Dropdown } from 'twenty-ui/components/navigation';
+import {
+ IconCalendar,
+ IconClock,
+ type IconComponent,
+ IconDotsVertical,
+ IconEyeOff,
+ IconZzz,
+} from 'twenty-ui/icon';
+import { type UpdateGettingStartedInput } from '~/generated-metadata/graphql';
+
+export const GettingStartedSnoozeMenu = () => {
+ const { t } = useLingui();
+ const dropdownId = `getting-started-snooze-${useId()}`;
+ const { updateGettingStarted, isSaving } = useUpdateGettingStarted();
+ const { trialEnd } = useGettingStartedTrial();
+ const { timeZone, dateFormat, timeFormat } = useDateTimeFormat();
+ const { localeCatalog } = useAtomStateValue(dateLocaleState);
+ const navigate = useNavigate();
+ const { defaultHomePagePath } = useDefaultHomePagePath();
+
+ const snoozeOptions: {
+ option: GettingStartedSnoozeOption;
+ label: string;
+ Icon: IconComponent;
+ }[] = [
+ { option: 'hour', label: t`In an hour`, Icon: IconClock },
+ { option: 'tomorrow', label: t`Tomorrow`, Icon: IconCalendar },
+ { option: 'lastThreeDays', label: t`Until the last 3 days`, Icon: IconZzz },
+ ];
+
+ const updateAndNavigateHome = async (input: UpdateGettingStartedInput) => {
+ const isUpdated = await updateGettingStarted(input);
+
+ if (isUpdated) {
+ navigate(defaultHomePagePath);
+ }
+ };
+
+ return (
+ <DropdownRoot dropdownId={dropdownId} type="menu">
+ <Dropdown.Trigger
+ render={
+ <LightIconButton aria-label={t`Snooze Getting started`}>
+ <IconDotsVertical />
+ </LightIconButton>
+ }
+ />
+ <DropdownContent
+ width={GenericDropdownContentWidth.ExtraLarge}
+ align="end"
+ aria-label={t`Snooze Getting started`}
+ >
+ <Dropdown.Header>
+ <Dropdown.Title>{t`Snooze Getting started`}</Dropdown.Title>
+ </Dropdown.Header>
+ <Dropdown.Section>
+ {snoozeOptions.map(({ option, label, Icon }) => {
+ const snoozedUntil = getGettingStartedSnoozedUntil({
+ option,
+ now: new Date(),
+ timeZone,
+ trialEnd,
+ });
+
+ return (
+ <Dropdown.ActionItem
+ key={option}
+ startIcon={<Icon />}
+ description={
+ isDefined(snoozedUntil)
+ ? formatDateISOStringToCustomUnicodeFormat({
+ date: snoozedUntil,
+ timeZone,
+ dateFormat: option === 'hour' ? timeFormat : dateFormat,
+ localeCatalog,
+ })
+ : undefined
+ }
+ descriptionPlacement="inline"
+ disabled={isSaving || !isDefined(snoozedUntil)}
+ onClick={() => void updateAndNavigateHome({ snoozedUntil })}
+ >
+ {label}
+ </Dropdown.ActionItem>
+ );
+ })}
+ </Dropdown.Section>
+ <Dropdown.Separator />
+ <Dropdown.Section>
+ <Dropdown.ActionItem
+ startIcon={<IconEyeOff />}
+ disabled={isSaving}
+ onClick={() => void updateAndNavigateHome({ isHidden: true })}
+ >
+ {t`Hide for good`}
+ </Dropdown.ActionItem>
+ </Dropdown.Section>
+ </DropdownContent>
+ </DropdownRoot>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedStepAction.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedStepAction.tsx
new file mode 100644
index 00000000000..5c219f80de1
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedStepAction.tsx
@@ -0,0 +1,34 @@
+import { GettingStartedPromptAction } from '@/getting-started/components/GettingStartedPromptAction';
+import { GettingStartedWorkflowAction } from '@/getting-started/components/GettingStartedWorkflowAction';
+import { GETTING_STARTED_CUSTOM_STEP_ACTIONS } from '@/getting-started/constants/GettingStartedCustomStepActions';
+import { isDefined } from 'twenty-shared/utils';
+
+import {
+ type GettingStartedStepDefinition,
+ GettingStartedStepKind,
+} from '~/generated-metadata/graphql';
+
+type GettingStartedStepActionProps = {
+ stepDefinition: GettingStartedStepDefinition;
+};
+
+export const GettingStartedStepAction = ({
+ stepDefinition,
+}: GettingStartedStepActionProps) => {
+ switch (stepDefinition.kind) {
+ case GettingStartedStepKind.PROMPT:
+ return <GettingStartedPromptAction stepDefinition={stepDefinition} />;
+ case GettingStartedStepKind.WORKFLOW:
+ return (
+ <GettingStartedWorkflowAction
+ stepActionKey={stepDefinition.actionKey}
+ />
+ );
+ case GettingStartedStepKind.CUSTOM: {
+ const CustomStepAction =
+ GETTING_STARTED_CUSTOM_STEP_ACTIONS[stepDefinition.actionKey];
+
+ return isDefined(CustomStepAction) ? <CustomStepAction /> : null;
+ }
+ }
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedStepCard.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedStepCard.tsx
new file mode 100644
index 00000000000..939d90b60e2
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedStepCard.tsx
@@ -0,0 +1,166 @@
+import { GettingStartedRollingText } from '@/getting-started/components/GettingStartedRollingText';
+import { GettingStartedStepAction } from '@/getting-started/components/GettingStartedStepAction';
+import { GETTING_STARTED_CUSTOM_STEP_DONE_DESCRIPTIONS } from '@/getting-started/constants/GettingStartedCustomStepDoneDescriptions';
+import { styled } from '@linaria/react';
+import { isDefined } from 'twenty-shared/utils';
+import { IconCircleCheck } from 'twenty-ui/icon';
+import { useIcons } from 'twenty-ui/icon/provider';
+import { Heading } from 'twenty-ui/primitives/typography';
+import { themeCssVariables, useTheme } from 'twenty-ui/theme';
+import { parseThemeColor } from 'twenty-ui/utilities';
+
+import { type GettingStartedStepDefinition } from '~/generated-metadata/graphql';
+
+const StyledCard = styled.section<{ isCompleted: boolean }>`
+ background: ${themeCssVariables.background.primary};
+ border: 1px solid
+ ${({ isCompleted }) =>
+ isCompleted
+ ? themeCssVariables.color.green5
+ : themeCssVariables.border.color.medium};
+ border-radius: ${themeCssVariables.border.radius.lg};
+ box-sizing: border-box;
+ overflow: hidden;
+ transition: border-color
+ calc(${themeCssVariables.animation.duration.normal} * 1s) ease-out;
+ width: 100%;
+
+ @media (prefers-reduced-motion: reduce) {
+ transition: none;
+ }
+`;
+
+const StyledHeading = styled.div<{ isCompleted: boolean }>`
+ align-items: flex-start;
+ background: ${({ isCompleted }) =>
+ isCompleted
+ ? themeCssVariables.color.green2
+ : themeCssVariables.background.secondary};
+ border-bottom: 1px solid
+ ${({ isCompleted }) =>
+ isCompleted
+ ? themeCssVariables.color.green3
+ : themeCssVariables.border.color.light};
+ display: flex;
+ gap: ${themeCssVariables.spacing[2]};
+ padding: ${themeCssVariables.spacing[4]} ${themeCssVariables.spacing[4]}
+ ${themeCssVariables.spacing[3]};
+ transition:
+ background calc(${themeCssVariables.animation.duration.normal} * 1s)
+ ease-out,
+ border-color calc(${themeCssVariables.animation.duration.normal} * 1s)
+ ease-out;
+
+ @media (prefers-reduced-motion: reduce) {
+ transition: none;
+ }
+`;
+
+const StyledDoneIcon = styled.span`
+ color: ${themeCssVariables.tag.text.green};
+ display: flex;
+
+ & svg path:last-of-type {
+ stroke-dasharray: 9;
+ stroke-dashoffset: 0;
+ }
+
+ &[data-animating] svg path:last-of-type {
+ animation: getting-started-step-card-draw-check
+ calc(${themeCssVariables.animation.duration.normal} * 1s) ease forwards;
+ stroke-dashoffset: 9;
+ }
+
+ @keyframes getting-started-step-card-draw-check {
+ to {
+ stroke-dashoffset: 0;
+ }
+ }
+
+ @media (prefers-reduced-motion: reduce) {
+ &[data-animating] svg path:last-of-type {
+ animation: none;
+ stroke-dashoffset: 0;
+ }
+ }
+`;
+
+const StyledTitle = styled.div`
+ display: flex;
+ flex: 1;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[1]};
+ min-width: 0;
+`;
+
+const StyledDescription = styled.span`
+ color: ${themeCssVariables.font.color.secondary};
+ line-height: ${themeCssVariables.text.lineHeight.lg};
+`;
+
+const StyledBody = styled.div`
+ padding: ${themeCssVariables.spacing[5]} ${themeCssVariables.spacing[6]};
+`;
+
+type GettingStartedStepCardProps = {
+ stepDefinition: GettingStartedStepDefinition;
+ isCompleted: boolean;
+ isJustCompleted: boolean;
+};
+
+export const GettingStartedStepCard = ({
+ stepDefinition,
+ isCompleted,
+ isJustCompleted,
+}: GettingStartedStepCardProps) => {
+ const theme = useTheme();
+ const { getIcon } = useIcons();
+
+ const StepIcon = getIcon(stepDefinition.icon);
+ const DoneDescription = isCompleted
+ ? GETTING_STARTED_CUSTOM_STEP_DONE_DESCRIPTIONS[stepDefinition.actionKey]
+ : undefined;
+
+ return (
+ <StyledCard
+ isCompleted={isCompleted}
+ aria-label={isCompleted ? stepDefinition.doneTitle : stepDefinition.title}
+ >
+ <StyledHeading isCompleted={isCompleted}>
+ {isCompleted ? (
+ <StyledDoneIcon data-animating={isJustCompleted || undefined}>
+ <IconCircleCheck size={theme.icon.size.xl} />
+ </StyledDoneIcon>
+ ) : (
+ <StepIcon
+ size={theme.icon.size.xl}
+ color={
+ themeCssVariables.tag.text[
+ parseThemeColor(stepDefinition.iconColor)
+ ]
+ }
+ />
+ )}
+ <StyledTitle>
+ <Heading size="lg">
+ <GettingStartedRollingText
+ text={
+ isCompleted ? stepDefinition.doneTitle : stepDefinition.title
+ }
+ />
+ </Heading>
+ <StyledDescription>
+ {isDefined(DoneDescription) ? (
+ <DoneDescription description={stepDefinition.description} />
+ ) : (
+ stepDefinition.description
+ )}
+ </StyledDescription>
+ </StyledTitle>
+ </StyledHeading>
+ <StyledBody>
+ <GettingStartedStepAction stepDefinition={stepDefinition} />
+ </StyledBody>
+ </StyledCard>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedStepStack.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedStepStack.tsx
new file mode 100644
index 00000000000..da3ecbf392a
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedStepStack.tsx
@@ -0,0 +1,225 @@
+import { GettingStartedStepCard } from '@/getting-started/components/GettingStartedStepCard';
+import { GETTING_STARTED_STACKED_STEP_COLOR_BY_DEPTH } from '@/getting-started/constants/GettingStartedStackedStepColorByDepth';
+import { GETTING_STARTED_STEP_TICKS_MIN_CONTAINER_WIDTH } from '@/getting-started/constants/GettingStartedStepTicksMinContainerWidth';
+import { useSelectGettingStartedStep } from '@/getting-started/hooks/useSelectGettingStartedStep';
+import { gettingStartedJustCompletedStepState } from '@/getting-started/states/gettingStartedJustCompletedStepState';
+import { EASE_OUT } from '@/ui/theme/constants/EaseOut';
+import { useAtomStateValue } from '@/ui/utilities/state/jotai/hooks/useAtomStateValue';
+import { styled } from '@linaria/react';
+import { useLingui } from '@lingui/react/macro';
+import { AnimatePresence, motion, useReducedMotion } from 'framer-motion';
+import { useIcons } from 'twenty-ui/icon/provider';
+import { themeCssVariables, useTheme } from 'twenty-ui/theme';
+import { parseThemeColor } from 'twenty-ui/utilities';
+
+import {
+ type GettingStartedStepActionKey,
+ type GettingStartedStepDefinition,
+} from '~/generated-metadata/graphql';
+
+const StyledActiveStep = styled.div`
+ border-radius: ${themeCssVariables.border.radius.lg};
+ box-shadow: ${themeCssVariables.boxShadow.strong};
+ position: relative;
+`;
+
+const StyledSteps = styled.nav`
+ align-items: flex-end;
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[2]};
+ position: absolute;
+ right: calc(100% + ${themeCssVariables.spacing[10]});
+ top: 50%;
+ transform: translateY(-50%);
+
+ @container getting-started-scroll (max-width: ${GETTING_STARTED_STEP_TICKS_MIN_CONTAINER_WIDTH}px) {
+ display: none;
+ }
+`;
+
+const StyledTick = styled.button`
+ background: ${themeCssVariables.border.color.strong};
+ border: 0;
+ border-radius: ${themeCssVariables.border.radius.xs};
+ cursor: pointer;
+ height: ${themeCssVariables.spacing[0.5]};
+ padding: 0;
+ transition:
+ background calc(${themeCssVariables.animation.duration.fast} * 1s) ease-out,
+ width calc(${themeCssVariables.animation.duration.fast} * 1s) ease-out;
+ width: ${themeCssVariables.spacing[3]};
+
+ @media (prefers-reduced-motion: reduce) {
+ transition: none;
+ }
+
+ &[data-completed] {
+ background: ${themeCssVariables.font.color.tertiary};
+ }
+
+ &[aria-current='step'] {
+ background: ${themeCssVariables.font.color.primary};
+ width: ${themeCssVariables.spacing[5]};
+ }
+
+ &::after {
+ content: '';
+ display: block;
+ height: ${themeCssVariables.spacing[2]};
+ margin-top: calc(-1 * ${themeCssVariables.spacing[1]});
+ width: 100%;
+ }
+`;
+
+const StyledStackedStepBase = styled.button<{ depth: number }>`
+ align-items: center;
+ background: ${themeCssVariables.background.primary};
+ border: 1px solid ${themeCssVariables.border.color.light};
+ border-radius: ${themeCssVariables.border.radius.lg}
+ ${themeCssVariables.border.radius.lg} 0 0;
+ color: ${({ depth }) => GETTING_STARTED_STACKED_STEP_COLOR_BY_DEPTH[depth]};
+ cursor: pointer;
+ display: flex;
+ font: inherit;
+ gap: ${themeCssVariables.spacing[2]};
+ height: ${themeCssVariables.spacing[11]};
+ margin: 0 auto calc(-1 * ${themeCssVariables.spacing['1.5']});
+ padding: 0 ${themeCssVariables.spacing[4]} ${themeCssVariables.spacing['1.5']};
+ transition:
+ color calc(${themeCssVariables.animation.duration.normal} * 1s) ease-out,
+ width calc(${themeCssVariables.animation.duration.normal} * 1s) ease-out;
+ width: ${({ depth }) =>
+ `calc(100% - ${depth} * ${themeCssVariables.spacing[8]})`};
+
+ @media (prefers-reduced-motion: reduce) {
+ transition: none;
+ }
+
+ &:hover {
+ color: ${themeCssVariables.font.color.primary};
+ }
+`;
+
+const StyledStackedStep = motion.create(StyledStackedStepBase);
+
+const StyledStackedStepTitle = styled.span`
+ flex: 1;
+ text-align: left;
+`;
+
+type GettingStartedStepStackProps = {
+ steps: GettingStartedStepDefinition[];
+ selectedStepActionKey: GettingStartedStepActionKey;
+ completedStepActionKeys: GettingStartedStepActionKey[];
+};
+
+export const GettingStartedStepStack = ({
+ steps,
+ selectedStepActionKey,
+ completedStepActionKeys,
+}: GettingStartedStepStackProps) => {
+ const { t } = useLingui();
+ const theme = useTheme();
+ const { getIcon } = useIcons();
+ const shouldReduceMotion = useReducedMotion();
+ const { selectGettingStartedStep, isSaving } = useSelectGettingStartedStep();
+ const gettingStartedJustCompletedStep = useAtomStateValue(
+ gettingStartedJustCompletedStepState,
+ );
+ const stepTransition = {
+ duration: theme.animation.duration.normal,
+ ease: EASE_OUT,
+ };
+ const stackOffset = shouldReduceMotion ? 0 : theme.spacingMultiplicator * 2;
+ const cardOffset = shouldReduceMotion ? 0 : theme.spacingMultiplicator * 4;
+
+ const selectedStepIndex = steps.findIndex(
+ ({ actionKey }) => actionKey === selectedStepActionKey,
+ );
+ const selectedStepDefinition = steps[selectedStepIndex];
+ const stackedSteps = [3, 2, 1]
+ .filter((depth) => depth < steps.length)
+ .map((depth) => ({
+ depth,
+ stepDefinition: steps[(selectedStepIndex + depth) % steps.length],
+ }));
+
+ return (
+ <div>
+ <AnimatePresence initial={false} mode="popLayout">
+ {stackedSteps.map(({ depth, stepDefinition }) => {
+ const { actionKey, icon, iconColor, title } = stepDefinition;
+ const StepIcon = getIcon(icon);
+
+ return (
+ <StyledStackedStep
+ key={actionKey}
+ layout="position"
+ initial={{ opacity: 0, y: -stackOffset }}
+ animate={{ opacity: 1, y: 0 }}
+ exit={{ opacity: 0, y: stackOffset }}
+ transition={stepTransition}
+ type="button"
+ depth={depth}
+ disabled={isSaving}
+ onClick={() => selectGettingStartedStep(actionKey)}
+ >
+ <StepIcon
+ size={theme.icon.size.md}
+ color={themeCssVariables.tag.text[parseThemeColor(iconColor)]}
+ />
+ <StyledStackedStepTitle>{title}</StyledStackedStepTitle>
+ </StyledStackedStep>
+ );
+ })}
+ </AnimatePresence>
+ <StyledActiveStep>
+ <StyledSteps aria-label={t`Getting started steps`}>
+ {steps.map(({ actionKey, title }) => (
+ <StyledTick
+ key={actionKey}
+ type="button"
+ aria-label={title}
+ aria-current={
+ actionKey === selectedStepActionKey ? 'step' : undefined
+ }
+ data-completed={
+ completedStepActionKeys.includes(actionKey) || undefined
+ }
+ disabled={isSaving}
+ onClick={() => selectGettingStartedStep(actionKey)}
+ />
+ ))}
+ </StyledSteps>
+ <AnimatePresence initial={false} mode="wait">
+ <motion.div
+ key={selectedStepActionKey}
+ initial={{ opacity: 0, y: -cardOffset }}
+ animate={{ opacity: 1, y: 0 }}
+ exit={{
+ opacity: 0,
+ y: cardOffset,
+ scale: shouldReduceMotion ? 1 : 0.98,
+ transition: {
+ duration: theme.animation.duration.fast,
+ ease: EASE_OUT,
+ },
+ }}
+ transition={stepTransition}
+ >
+ <GettingStartedStepCard
+ stepDefinition={selectedStepDefinition}
+ isCompleted={completedStepActionKeys.includes(
+ selectedStepActionKey,
+ )}
+ isJustCompleted={
+ gettingStartedJustCompletedStep === selectedStepActionKey
+ }
+ />
+ </motion.div>
+ </AnimatePresence>
+ </StyledActiveStep>
+ </div>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedWorkflowAction.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedWorkflowAction.tsx
new file mode 100644
index 00000000000..8c6d56d49c7
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedWorkflowAction.tsx
@@ -0,0 +1,76 @@
+import { getToastOptionsFromError } from '@/error-handler/utils/getToastOptionsFromError';
+import { GettingStartedWorkflowPreview } from '@/getting-started/components/GettingStartedWorkflowPreview';
+import { useGettingStartedProgress } from '@/getting-started/hooks/useGettingStartedProgress';
+import { useUpdateGettingStarted } from '@/getting-started/hooks/useUpdateGettingStarted';
+import { useMutation } from '@apollo/client/react';
+import { styled } from '@linaria/react';
+import { useLingui } from '@lingui/react/macro';
+import { AppPath } from 'twenty-shared/types';
+import { isDefined } from 'twenty-shared/utils';
+import { useToast } from 'twenty-ui/components/feedback';
+import { Button } from 'twenty-ui/primitives/input';
+import { themeCssVariables } from 'twenty-ui/theme';
+import {
+ type GettingStartedStepActionKey,
+ PrepareGettingStartedWorkflowDocument,
+} from '~/generated-metadata/graphql';
+import { useNavigateApp } from '~/hooks/useNavigateApp';
+
+const StyledColumn = styled.div`
+ align-items: flex-start;
+ display: flex;
+ flex-direction: column;
+ gap: ${themeCssVariables.spacing[4]};
+`;
+
+type GettingStartedWorkflowActionProps = {
+ stepActionKey: GettingStartedStepActionKey;
+};
+
+export const GettingStartedWorkflowAction = ({
+ stepActionKey,
+}: GettingStartedWorkflowActionProps) => {
+ const { t } = useLingui();
+ const navigateApp = useNavigateApp();
+ const { enqueueToast } = useToast();
+ const { progress } = useGettingStartedProgress();
+ const { updateGettingStarted } = useUpdateGettingStarted();
+ const [prepareGettingStartedWorkflow, { loading }] = useMutation(
+ PrepareGettingStartedWorkflowDocument,
+ );
+ const isWorkflowOn =
+ progress?.completedStepActionKeys.includes(stepActionKey) ?? false;
+
+ const openWorkflow = async () => {
+ try {
+ const { data } = await prepareGettingStartedWorkflow({
+ variables: { stepActionKey },
+ });
+
+ if (!isDefined(data)) {
+ return;
+ }
+
+ void updateGettingStarted({ completedStepActionKey: stepActionKey });
+ navigateApp(AppPath.WorkflowCoreShowPage, {
+ coreWorkflowId: data.prepareGettingStartedWorkflow.workflowId,
+ });
+ } catch (error) {
+ enqueueToast(getToastOptionsFromError({ error }));
+ }
+ };
+
+ return (
+ <StyledColumn>
+ <GettingStartedWorkflowPreview stepActionKey={stepActionKey} />
+ <Button
+ variant="solid"
+ color="accent"
+ loading={loading}
+ onClick={() => void openWorkflow()}
+ >
+ {isWorkflowOn ? t`Open the workflow` : t`Set up the workflow`}
+ </Button>
+ </StyledColumn>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/GettingStartedWorkflowPreview.tsx b/packages/twenty-front/src/modules/getting-started/components/GettingStartedWorkflowPreview.tsx
new file mode 100644
index 00000000000..a4e847b40ac
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/GettingStartedWorkflowPreview.tsx
@@ -0,0 +1,141 @@
+import { NODE_HANDLE_HEIGHT_PX } from '@/workflow/workflow-diagram/constants/NodeHandleHeightPx';
+import { NODE_HANDLE_WIDTH_PX } from '@/workflow/workflow-diagram/constants/NodeHandleWidthPx';
+import { WorkflowNodeContainer } from '@/workflow/workflow-diagram/workflow-nodes/components/WorkflowNodeContainer';
+import { WorkflowNodeIconContainer } from '@/workflow/workflow-diagram/workflow-nodes/components/WorkflowNodeIconContainer';
+import { WorkflowNodeLabel } from '@/workflow/workflow-diagram/workflow-nodes/components/WorkflowNodeLabel';
+import { WorkflowNodeRightPart } from '@/workflow/workflow-diagram/workflow-nodes/components/WorkflowNodeRightPart';
+import { WorkflowNodeTitle } from '@/workflow/workflow-diagram/workflow-nodes/components/WorkflowNodeTitle';
+import { getActionIcon } from '@/workflow/workflow-steps/workflow-actions/utils/getActionIcon';
+import { getTriggerTypeIcon } from '@/workflow/workflow-trigger/utils/getTriggerTypeIcon';
+import { useQuery } from '@apollo/client/react';
+import { styled } from '@linaria/react';
+import { useLingui } from '@lingui/react/macro';
+import { Fragment } from 'react';
+import { isDefined } from 'twenty-shared/utils';
+import { useIcons } from 'twenty-ui/icon/provider';
+import { themeCssVariables, useTheme } from 'twenty-ui/theme';
+import {
+ type GettingStartedStepActionKey,
+ GettingStartedWorkflowPreviewsDocument,
+} from '~/generated-metadata/graphql';
+
+const StyledWorkflowPreview = styled.div`
+ align-items: center;
+ align-self: stretch;
+ background-color: ${themeCssVariables.background.primary};
+ background-image: radial-gradient(
+ circle,
+ ${themeCssVariables.border.color.medium} 1px,
+ transparent 1px
+ );
+ background-position: ${themeCssVariables.spacing[2]}
+ ${themeCssVariables.spacing[2]};
+ background-size: calc(
+ ${themeCssVariables.spacing[4]} + ${themeCssVariables.spacing['0.5']}
+ )
+ calc(${themeCssVariables.spacing[4]} + ${themeCssVariables.spacing['0.5']});
+ border: 1px solid ${themeCssVariables.border.color.medium};
+ border-radius: ${themeCssVariables.border.radius.md};
+ display: flex;
+ flex-direction: column;
+ padding: ${themeCssVariables.spacing[6]};
+`;
+
+const StyledEdge = styled.div`
+ align-items: center;
+ display: flex;
+ flex-direction: column;
+ height: calc(
+ ${themeCssVariables.spacing[7]} + ${NODE_HANDLE_HEIGHT_PX / 2}px
+ );
+ margin-top: -${NODE_HANDLE_HEIGHT_PX / 2}px;
+ position: relative;
+`;
+
+const StyledEdgeHandle = styled.div`
+ background: ${themeCssVariables.background.primary};
+ border: 1px solid ${themeCssVariables.border.color.strong};
+ border-radius: ${themeCssVariables.border.radius.rounded};
+ box-sizing: border-box;
+ flex-shrink: 0;
+ height: ${NODE_HANDLE_HEIGHT_PX}px;
+ width: ${NODE_HANDLE_WIDTH_PX}px;
+`;
+
+const StyledEdgeLine = styled.div`
+ background: ${themeCssVariables.border.color.strong};
+ flex: 1;
+ width: 1px;
+`;
+
+type GettingStartedWorkflowPreviewProps = {
+ stepActionKey: GettingStartedStepActionKey;
+};
+
+export const GettingStartedWorkflowPreview = ({
+ stepActionKey,
+}: GettingStartedWorkflowPreviewProps) => {
+ const { t } = useLingui();
+ const theme = useTheme();
+ const { getIcon } = useIcons();
+ const { data } = useQuery(GettingStartedWorkflowPreviewsDocument);
+
+ const workflowPreview = data?.gettingStartedWorkflowPreviews.find(
+ (preview) => preview.stepActionKey === stepActionKey,
+ );
+
+ if (!isDefined(workflowPreview)) {
+ return <StyledWorkflowPreview />;
+ }
+
+ const previewNodes = [
+ {
+ label: t`Trigger`,
+ title: workflowPreview.trigger.title,
+ Icon: getIcon(
+ getTriggerTypeIcon({
+ type: workflowPreview.trigger.type,
+ databaseEvent: workflowPreview.trigger.databaseEventAction,
+ }),
+ ),
+ },
+ ...workflowPreview.actions.map((action) => ({
+ label: t`Action`,
+ title: action.title,
+ Icon: getIcon(getActionIcon(action.type)),
+ })),
+ ];
+
+ return (
+ <StyledWorkflowPreview>
+ {previewNodes.map(({ label, title, Icon }, index) => (
+ <Fragment key={index}>
+ {index > 0 && (
+ <StyledEdge aria-hidden>
+ <StyledEdgeHandle />
+ <StyledEdgeLine />
+ <svg width={10} height={8} viewBox="0 0 10 8">
+ <path
+ d="M1.7915 1.38672H8.18311C8.57541 1.38705 8.81458 1.81852 8.60693 2.15137L5.41064 7.26465C5.21481 7.57798 4.75882 7.57798 4.56299 7.26465L1.3667 2.15137C1.15906 1.81841 1.39896 1.38672 1.7915 1.38672Z"
+ stroke={theme.border.color.strong}
+ fill={theme.background.primary}
+ />
+ </svg>
+ </StyledEdge>
+ )}
+ <WorkflowNodeContainer selected={false}>
+ <WorkflowNodeIconContainer>
+ <Icon size={theme.icon.size.md} />
+ </WorkflowNodeIconContainer>
+ <WorkflowNodeRightPart>
+ <WorkflowNodeLabel selected={false}>{label}</WorkflowNodeLabel>
+ <WorkflowNodeTitle selected={false} highlight>
+ {title}
+ </WorkflowNodeTitle>
+ </WorkflowNodeRightPart>
+ </WorkflowNodeContainer>
+ </Fragment>
+ ))}
+ </StyledWorkflowPreview>
+ );
+};
diff --git a/packages/twenty-front/src/modules/getting-started/components/__stories__/GettingStartedPageContent.stories.tsx b/packages/twenty-front/src/modules/getting-started/components/__stories__/GettingStartedPageContent.stories.tsx
new file mode 100644
index 00000000000..37cf623d654
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/components/__stories__/GettingStartedPageContent.stories.tsx
@@ -0,0 +1,371 @@
+import { type MockedResponse } from '@apollo/client/testing';
+import { useApolloClient } from '@apollo/client/react';
+import { MockedProvider } from '@apollo/client/testing/react';
+import { styled } from '@linaria/react';
+import { type Meta, type StoryObj } from '@storybook/react-vite';
+import { expect, userEvent, waitFor, within } from 'storybook/test';
+
+import { currentWorkspaceState } from '@/auth/states/currentWorkspaceState';
+import { billingState } from '@/client-config/states/billingState';
+import { GettingStartedPageContent } from '@/getting-started/components/GettingStartedPageContent';
+import { useUpdateGettingStarted } from '@/getting-started/hooks/useUpdateGettingStarted';
+import { gettingStartedJustCompletedStepState } from '@/getting-started/states/gettingStartedJustCompletedStepState';
+import { getGettingStartedStepSelection } from '@/getting-started/utils/getGettingStartedStepSelection';
+import { useSetAtomState } from '@/ui/utilities/state/jotai/hooks/useSetAtomState';
+import { jotaiStore } from '@/ui/utilities/state/jotai/jotaiStore';
+import { isDefined } from 'twenty-shared/utils';
+import { Button } from 'twenty-ui/primitives/input';
+import { themeCssVariables } from 'twenty-ui/theme';
+import {
+ FeatureFlagKey,
+ GettingStartedProgressDocument,
+ type GettingStartedProgressQuery,
+ GettingStartedStepActionKey,
+ GettingStartedWorkflowPreviewsDocument,
+ SubscriptionStatus,
+ UpdateGettingStartedDocument,
+ type UpdateGettingStartedMutationVariables,
+ UserCreditsFallback,
+ WorkflowActionType,
+} from '~/generated-metadata/graphql';
+import { ComponentWithRouterDecorator } from '~/testing/decorators/ComponentWithRouterDecorator';
+import { ObjectMetadataItemsDecorator } from '~/testing/decorators/ObjectMetadataItemsDecorator';
+import { ToastDecorator } from '~/testing/decorators/ToastDecorator';
+import {
+ mockGettingStartedStepDefinitions,
+ mockGettingStartedStepActionKeys,
+} from '~/testing/mock-data/gettingStartedSteps';
+import { mockedClientConfig } from '~/testing/mock-data/config';
+import { mockCurrentWorkspace } from '~/testing/mock-data/users';
+
+const TRIALING_WORKSPACE = {
+ ...mockCurrentWorkspace,
+ featureFlags: [
+ { key: FeatureFlagKey.IS_GETTING_STARTED_ENABLED, value: true },
+ ],
+ currentBillingSubscription: {
+ ...mockCurrentWorkspace.currentBillingSubscription,
+ status: SubscriptionStatus.Trialing,
+ currentPeriodEnd: '2024-03-15T12:00:00.000Z',
+ },
+ billingCustomer: {
+ id: '20202020-1c25-4d02-bf25-6aeccf7ea419',
+ hasPaymentMethod: false,
+ userCreditsFallback: UserCreditsFallback.STOP,
+ },
+};
+
+const TRIAL_PROGRESS: GettingStartedProgressQuery['gettingStartedProgress'] = {
+ __typename: 'GettingStartedProgress',
+ steps: mockGettingStartedStepDefinitions,
+ completedStepActionKeys: [],
+ selectedStepActionKey: null,
+ snoozedUntil: null,
+ isHidden: false,
+};
+
+const WORKFLOW_PREVIEWS_MOCK: MockedResponse = {
+ request: { query: GettingStartedWorkflowPreviewsDocument },
+ maxUsageCount: Infinity,
+ result: {
+ data: {
+ gettingStartedWorkflowPreviews: [
+ {
+ __typename: 'GettingStartedWorkflowPreview',
+ stepActionKey: GettingStartedStepActionKey.HANDOVER_DEALS,
+ trigger: {
+ __typename: 'GettingStartedWorkflowPreviewTrigger',
+ type: 'DATABASE_EVENT',
+ databaseEventAction: 'updated',
+ title: 'A deal is won',
+ },
+ actions: [
+ {
+ __typename: 'GettingStartedWorkflowPreviewAction',
+ type: WorkflowActionType.CREATE_RECORD,
+ title: 'Create a kickoff task',
+ },
+ {
+ __typename: 'GettingStartedWorkflowPreviewAction',
+ type: WorkflowActionType.SEND_EMAIL,
+ title: 'Email the account owner',
+ },
+ ],
+ },
+ ],
+ },
+ },
+};
+
+const StyledPageFrame = styled.div`
+ width: 1200px;
+`;
+
+const meta: Meta<typeof GettingStartedPageContent> = {
+ title: 'Modules/GettingStarted/GettingStartedPageContent',
+ component: GettingStartedPageContent,
+ decorators: [
+ (Story) => (
+ <StyledPageFrame>
+ <Story />
+ </StyledPageFrame>
+ ),
+ ToastDecorator,
+ ObjectMetadataItemsDecorator,
+ ComponentWithRouterDecorator,
+ (Story, { parameters }) => {
+ const { apolloMocks }: { apolloMocks?: MockedResponse[] } = parameters;
+
+ return (
+ <MockedProvider mocks={apolloMocks}>
+ <Story />
+ </MockedProvider>
+ );
+ },
+ ],
+ parameters: { layout: 'fullscreen' },
+ beforeEach: () => {
+ jotaiStore.set(currentWorkspaceState.atom, TRIALING_WORKSPACE);
+ jotaiStore.set(billingState.atom, mockedClientConfig.billing);
+ jotaiStore.set(gettingStartedJustCompletedStepState.atom, null);
+ },
+};
+
+export default meta;
+
+type Story = StoryObj<typeof GettingStartedPageContent>;
+
+export const Trial: Story = {
+ parameters: {
+ apolloMocks: [
+ WORKFLOW_PREVIEWS_MOCK,
+ {
+ request: { query: GettingStartedProgressDocument },
+ maxUsageCount: Infinity,
+ result: { data: { gettingStartedProgress: TRIAL_PROGRESS } },
+ },
+ {
+ request: {
+ query: UpdateGettingStartedDocument,
+ variables: {
+ input: {
+ selectedStepActionKey: GettingStartedStepActionKey.INVITE_TEAM,
+ },
+ },
+ },
+ result: {
+ data: {
+ updateGettingStarted: {
+ ...TRIAL_PROGRESS,
+ selectedStepActionKey: GettingStartedStepActionKey.INVITE_TEAM,
+ },
+ },
+ },
+ },
+ ],
+ },
+ play: async ({ canvasElement }) => {
+ const canvas = within(canvasElement);
+
+ await expect(
+ await canvas.findByText('days left in your trial'),
+ ).toBeVisible();
+ await userEvent.click(
+ within(
+ await canvas.findByRole('navigation', {
+ name: 'Getting started steps',
+ }),
+ ).getByRole('button', { name: 'Invite your team' }),
+ );
+ const inviteStepCard = await canvas.findByRole('region', {
+ name: 'Invite your team',
+ });
+
+ await waitFor(() => expect(inviteStepCard).toBeVisible());
+ },
+};
+
+export const AllDone: Story = {
+ parameters: {
+ apolloMocks: [
+ WORKFLOW_PREVIEWS_MOCK,
+ {
+ request: { query: GettingStartedProgressDocument },
+ maxUsageCount: Infinity,
+ result: {
+ data: {
+ gettingStartedProgress: {
+ ...TRIAL_PROGRESS,
+ completedStepActionKeys: mockGettingStartedStepActionKeys,
+ selectedStepActionKey:
+ GettingStartedStepActionKey.CONNECT_MAILBOX,
+ },
+ },
+ },
+ },
+ ],
+ },
+ play: async ({ canvasElement }) => {
+ await expect(
+ await within(canvasElement).findByText('All steps done'),
+ ).toBeVisible();
+ },
+};
+
+export const Loading: Story = {
+ parameters: {
+ apolloMocks: [
+ {
+ request: { query: GettingStartedProgressDocument },
+ maxUsageCount: Infinity,
+ delay: Infinity,
+ result: { data: { gettingStartedProgress: TRIAL_PROGRESS } },
+ },
+ ],
+ },
+ play: async ({ canvasElement }) => {
+ await expect(
+ await within(canvasElement).findByRole('status'),
+ ).toBeVisible();
+ },
+};
+
+export const LoadError: Story = {
+ parameters: {
+ apolloMocks: [
+ {
+ request: { query: GettingStartedProgressDocument },
+ maxUsageCount: Infinity,
+ error: new Error('Progress unavailable'),
+ },
+ ],
+ },
+ play: async ({ canvasElement }) => {
+ await expect(
+ await within(canvasElement).findByText('Could not load Getting started.'),
+ ).toBeVisible();
+ },
+};
+
+const createAnimationPreviewProgress =
+ (): GettingStartedProgressQuery['gettingStartedProgress'] => ({
+ ...TRIAL_PROGRESS,
+ completedStepActionKeys: [GettingStartedStepActionKey.CONNECT_MAILBOX],
+ });
+
+let animationPreviewProgress = createAnimationPreviewProgress();
+
+const StyledAnimationPreviewToolbar = styled.div`
+ display: flex;
+ gap: ${themeCssVariables.spacing[2]};
+ justify-content: center;
+ padding: ${themeCssVariables.spacing[3]};
+`;
+
+const GettingStartedAnimationPreview = () => {
+ const apolloClient = useApolloClient();
+ const { updateGettingStarted } = useUpdateGettingStarted();
+ const setGettingStartedJustCompletedStep = useSetAtomState(
+ gettingStartedJustCompletedStepState,
+ );
+
+ const resetProgress = () => {
+ animationPreviewProgress = createAnimationPreviewProgress();
+ setGettingStartedJustCompletedStep(null);
+ apolloClient.writeQuery({
+ query: GettingStartedProgressDocument,
+ data: { gettingStartedProgress: animationPreviewProgress },
+ });
+ };
+
+ const completeDisplayedStep = () => {
+ const { steps, completedStepActionKeys, selectedStepActionKey } =
+ animationPreviewProgress;
+ const { selectedStepActionKey: displayedStepActionKey } =
+ getGettingStartedStepSelection({
+ stepActionKeys: steps.map(({ actionKey }) => actionKey),
+ completedStepActionKeys,
+ selectedStepActionKey,
+ });
+
+ void updateGettingStarted({
+ completedStepActionKey: displayedStepActionKey,
+ });
+ };
+
+ return (
+ <>
+ <StyledAnimationPreviewToolbar>
+ <Button variant="solid" color="accent" onClick={completeDisplayedStep}>
+ Complete the current step
+ </Button>
+ <Button variant="ghost" onClick={resetProgress}>
+ Reset
+ </Button>
+ </StyledAnimationPreviewToolbar>
+ <GettingStartedPageContent />
+ </>
+ );
+};
+
+export const StepAnimations: Story = {
+ beforeEach: () => {
+ animationPreviewProgress = createAnimationPreviewProgress();
+ },
+ parameters: {
+ apolloMocks: [
+ WORKFLOW_PREVIEWS_MOCK,
+ {
+ request: { query: GettingStartedProgressDocument },
+ maxUsageCount: Infinity,
+ result: () => ({
+ data: { gettingStartedProgress: animationPreviewProgress },
+ }),
+ },
+ {
+ request: { query: UpdateGettingStartedDocument, variables: () => true },
+ maxUsageCount: Infinity,
+ result: ({ input }: UpdateGettingStartedMutationVariables) => {
+ animationPreviewProgress = {
+ ...animationPreviewProgress,
+ completedStepActionKeys: [
+ ...new Set(
+ [
+ ...animationPreviewProgress.completedStepActionKeys,
+ input.completedStepActionKey,
+ ].filter(isDefined),
+ ),
+ ],
+ selectedStepActionKey:
+ input.selectedStepActionKey ??
+ animationPreviewProgress.selectedStepActionKey,
+ };
+
+ return {
+ data: { updateGettingStarted: animationPreviewProgress },
+ };
+ },
+ },
+ ],
+ },
+ render: () => <GettingStartedAnimationPreview />,
+ play: async ({ canvasElement }) => {
+ const canvas = within(canvasElement);
+
+ await userEvent.click(
+ await canvas.findByRole('button', { name: 'Complete the current step' }),
+ );
+
+ const steps = await canvas.findByRole('navigation', {
+ name: 'Getting started steps',
+ });
+
+ await waitFor(
+ () =>
+ expect(
+ within(steps).getByRole('button', { name: 'Install an app' }),
+ ).toHaveAttribute('aria-current', 'step'),
+ { timeout: 3000 },
+ );
+ },
+};
diff --git a/packages/twenty-front/src/modules/getting-started/constants/GettingStartedAutoAdvanceDelayMs.ts b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedAutoAdvanceDelayMs.ts
new file mode 100644
index 00000000000..9728d273c9b
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedAutoAdvanceDelayMs.ts
@@ -0,0 +1 @@
+export const GETTING_STARTED_AUTO_ADVANCE_DELAY_MS = 1200;
diff --git a/packages/twenty-front/src/modules/getting-started/constants/GettingStartedContentMaxWidth.ts b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedContentMaxWidth.ts
new file mode 100644
index 00000000000..760ae501c29
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedContentMaxWidth.ts
@@ -0,0 +1 @@
+export const GETTING_STARTED_CONTENT_MAX_WIDTH = 720;
diff --git a/packages/twenty-front/src/modules/getting-started/constants/GettingStartedCustomStepActions.ts b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedCustomStepActions.ts
new file mode 100644
index 00000000000..8023e998e2e
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedCustomStepActions.ts
@@ -0,0 +1,16 @@
+import { type ComponentType } from 'react';
+
+import { GettingStartedAppsAction } from '@/getting-started/components/GettingStartedAppsAction';
+import { GettingStartedImportAction } from '@/getting-started/components/GettingStartedImportAction';
+import { GettingStartedInviteAction } from '@/getting-started/components/GettingStartedInviteAction';
+import { GettingStartedMailboxAction } from '@/getting-started/components/GettingStartedMailboxAction';
+import { GettingStartedStepActionKey } from '~/generated-metadata/graphql';
+
+export const GETTING_STARTED_CUSTOM_STEP_ACTIONS: Partial<
+ Record<GettingStartedStepActionKey, ComponentType>
+> = {
+ [GettingStartedStepActionKey.CONNECT_MAILBOX]: GettingStartedMailboxAction,
+ [GettingStartedStepActionKey.IMPORT_DATA]: GettingStartedImportAction,
+ [GettingStartedStepActionKey.INSTALL_APP]: GettingStartedAppsAction,
+ [GettingStartedStepActionKey.INVITE_TEAM]: GettingStartedInviteAction,
+};
diff --git a/packages/twenty-front/src/modules/getting-started/constants/GettingStartedCustomStepDoneDescriptions.ts b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedCustomStepDoneDescriptions.ts
new file mode 100644
index 00000000000..db2c021954a
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedCustomStepDoneDescriptions.ts
@@ -0,0 +1,15 @@
+import { type ComponentType } from 'react';
+
+import { GettingStartedMailboxDoneDescription } from '@/getting-started/components/GettingStartedMailboxDoneDescription';
+import { type GettingStartedStepDoneDescriptionProps } from '@/getting-started/types/GettingStartedStepDoneDescriptionProps';
+import { GettingStartedStepActionKey } from '~/generated-metadata/graphql';
+
+export const GETTING_STARTED_CUSTOM_STEP_DONE_DESCRIPTIONS: Partial<
+ Record<
+ GettingStartedStepActionKey,
+ ComponentType<GettingStartedStepDoneDescriptionProps>
+ >
+> = {
+ [GettingStartedStepActionKey.CONNECT_MAILBOX]:
+ GettingStartedMailboxDoneDescription,
+};
diff --git a/packages/twenty-front/src/modules/getting-started/constants/GettingStartedImportContextStoreInstanceId.ts b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedImportContextStoreInstanceId.ts
new file mode 100644
index 00000000000..a3382fc6ae7
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedImportContextStoreInstanceId.ts
@@ -0,0 +1,2 @@
+export const GETTING_STARTED_IMPORT_CONTEXT_STORE_INSTANCE_ID =
+ 'getting-started-import';
diff --git a/packages/twenty-front/src/modules/getting-started/constants/GettingStartedImportPrompt.ts b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedImportPrompt.ts
new file mode 100644
index 00000000000..99f7ea29c3e
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedImportPrompt.ts
@@ -0,0 +1,3 @@
+import { msg } from '@lingui/core/macro';
+
+export const GETTING_STARTED_IMPORT_PROMPT = msg`Import the attached files into Twenty. Work out which records they contain, then create them and link them together.`;
diff --git a/packages/twenty-front/src/modules/getting-started/constants/GettingStartedLastDaysSnoozeHours.ts b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedLastDaysSnoozeHours.ts
new file mode 100644
index 00000000000..85f3e602a20
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedLastDaysSnoozeHours.ts
@@ -0,0 +1 @@
+export const GETTING_STARTED_LAST_DAYS_SNOOZE_HOURS = 72;
diff --git a/packages/twenty-front/src/modules/getting-started/constants/GettingStartedStackedStepColorByDepth.ts b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedStackedStepColorByDepth.ts
new file mode 100644
index 00000000000..680e3bd3dbf
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedStackedStepColorByDepth.ts
@@ -0,0 +1,10 @@
+import { themeCssVariables } from 'twenty-ui/theme';
+
+export const GETTING_STARTED_STACKED_STEP_COLOR_BY_DEPTH: Record<
+ number,
+ string
+> = {
+ 1: themeCssVariables.font.color.primary,
+ 2: themeCssVariables.font.color.secondary,
+ 3: themeCssVariables.font.color.tertiary,
+};
diff --git a/packages/twenty-front/src/modules/getting-started/constants/GettingStartedStepTicksMinContainerWidth.ts b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedStepTicksMinContainerWidth.ts
new file mode 100644
index 00000000000..941c6fdd27d
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/constants/GettingStartedStepTicksMinContainerWidth.ts
@@ -0,0 +1 @@
+export const GETTING_STARTED_STEP_TICKS_MIN_CONTAINER_WIDTH = 840;
diff --git a/packages/twenty-front/src/modules/getting-started/constants/SpreadsheetExportGuides.ts b/packages/twenty-front/src/modules/getting-started/constants/SpreadsheetExportGuides.ts
new file mode 100644
index 00000000000..7145aad0b97
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/constants/SpreadsheetExportGuides.ts
@@ -0,0 +1,16 @@
+import { doNotTranslate } from 'twenty-shared/i18n';
+
+export const SPREADSHEET_EXPORT_GUIDES = [
+ {
+ name: doNotTranslate('HubSpot'),
+ url: 'https://knowledge.hubspot.com/import-and-export/export-records',
+ },
+ {
+ name: doNotTranslate('Salesforce'),
+ url: 'https://help.salesforce.com/s/articleView?id=platform.admin_exportdata.htm&type=5',
+ },
+ {
+ name: doNotTranslate('Pipedrive'),
+ url: 'https://support.pipedrive.com/en/article/exporting-data-from-pipedrive',
+ },
+];
diff --git a/packages/twenty-front/src/modules/getting-started/graphql/fragments/gettingStartedProgressFragment.ts b/packages/twenty-front/src/modules/getting-started/graphql/fragments/gettingStartedProgressFragment.ts
new file mode 100644
index 00000000000..501606dd4f1
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/graphql/fragments/gettingStartedProgressFragment.ts
@@ -0,0 +1,21 @@
+import { gql } from '@apollo/client';
+
+export const GETTING_STARTED_PROGRESS_FRAGMENT = gql`
+ fragment GettingStartedProgressFields on GettingStartedProgress {
+ steps {
+ actionKey
+ kind
+ title
+ doneTitle
+ description
+ icon
+ iconColor
+ promptLabel
+ prompt
+ }
+ completedStepActionKeys
+ selectedStepActionKey
+ snoozedUntil
+ isHidden
+ }
+`;
diff --git a/packages/twenty-front/src/modules/getting-started/graphql/mutations/prepareGettingStartedWorkflow.ts b/packages/twenty-front/src/modules/getting-started/graphql/mutations/prepareGettingStartedWorkflow.ts
new file mode 100644
index 00000000000..cead705992f
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/graphql/mutations/prepareGettingStartedWorkflow.ts
@@ -0,0 +1,12 @@
+import { gql } from '@apollo/client';
+
+export const PREPARE_GETTING_STARTED_WORKFLOW = gql`
+ mutation PrepareGettingStartedWorkflow(
+ $stepActionKey: GettingStartedStepActionKey!
+ ) {
+ prepareGettingStartedWorkflow(stepActionKey: $stepActionKey) {
+ workflowId
+ versionId
+ }
+ }
+`;
diff --git a/packages/twenty-front/src/modules/getting-started/graphql/mutations/updateGettingStarted.ts b/packages/twenty-front/src/modules/getting-started/graphql/mutations/updateGettingStarted.ts
new file mode 100644
index 00000000000..42fd0528dc2
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/graphql/mutations/updateGettingStarted.ts
@@ -0,0 +1,12 @@
+import { gql } from '@apollo/client';
+
+import { GETTING_STARTED_PROGRESS_FRAGMENT } from '@/getting-started/graphql/fragments/gettingStartedProgressFragment';
+
+export const UPDATE_GETTING_STARTED = gql`
+ ${GETTING_STARTED_PROGRESS_FRAGMENT}
+ mutation UpdateGettingStarted($input: UpdateGettingStartedInput!) {
+ updateGettingStarted(input: $input) {
+ ...GettingStartedProgressFields
+ }
+ }
+`;
diff --git a/packages/twenty-front/src/modules/getting-started/graphql/queries/gettingStartedProgress.ts b/packages/twenty-front/src/modules/getting-started/graphql/queries/gettingStartedProgress.ts
new file mode 100644
index 00000000000..cfc63dbc321
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/graphql/queries/gettingStartedProgress.ts
@@ -0,0 +1,12 @@
+import { gql } from '@apollo/client';
+
+import { GETTING_STARTED_PROGRESS_FRAGMENT } from '@/getting-started/graphql/fragments/gettingStartedProgressFragment';
+
+export const GETTING_STARTED_PROGRESS = gql`
+ ${GETTING_STARTED_PROGRESS_FRAGMENT}
+ query GettingStartedProgress {
+ gettingStartedProgress {
+ ...GettingStartedProgressFields
+ }
+ }
+`;
diff --git a/packages/twenty-front/src/modules/getting-started/graphql/queries/gettingStartedWorkflowPreviews.ts b/packages/twenty-front/src/modules/getting-started/graphql/queries/gettingStartedWorkflowPreviews.ts
new file mode 100644
index 00000000000..006ede6c8bd
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/graphql/queries/gettingStartedWorkflowPreviews.ts
@@ -0,0 +1,18 @@
+import { gql } from '@apollo/client';
+
+export const GETTING_STARTED_WORKFLOW_PREVIEWS = gql`
+ query GettingStartedWorkflowPreviews {
+ gettingStartedWorkflowPreviews {
+ stepActionKey
+ trigger {
+ type
+ databaseEventAction
+ title
+ }
+ actions {
+ type
+ title
+ }
+ }
+ }
+`;
diff --git a/packages/twenty-front/src/modules/getting-started/hooks/__tests__/useIsGettingStartedEnabled.test.tsx b/packages/twenty-front/src/modules/getting-started/hooks/__tests__/useIsGettingStartedEnabled.test.tsx
new file mode 100644
index 00000000000..8674f1547ad
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/hooks/__tests__/useIsGettingStartedEnabled.test.tsx
@@ -0,0 +1,46 @@
+import { renderHook } from '@testing-library/react';
+import { Provider as JotaiProvider } from 'jotai';
+import { type ReactNode } from 'react';
+
+import { currentWorkspaceState } from '@/auth/states/currentWorkspaceState';
+import { billingState } from '@/client-config/states/billingState';
+import { useIsGettingStartedEnabled } from '@/getting-started/hooks/useIsGettingStartedEnabled';
+import { jotaiStore } from '@/ui/utilities/state/jotai/jotaiStore';
+import { FeatureFlagKey } from '~/generated-metadata/graphql';
+import { mockedClientConfig } from '~/testing/mock-data/config';
+import { mockCurrentWorkspace } from '~/testing/mock-data/users';
+
+const Wrapper = ({ children }: { children: ReactNode }) => (
+ <JotaiProvider store={jotaiStore}>{children}</JotaiProvider>
+);
+
+describe('useIsGettingStartedEnabled', () => {
+ it.each([
+ { isFeatureFlagEnabled: true, isBillingEnabled: true, expected: true },
+ { isFeatureFlagEnabled: true, isBillingEnabled: false, expected: false },
+ { isFeatureFlagEnabled: false, isBillingEnabled: true, expected: false },
+ ])(
+ 'returns $expected when the flag is $isFeatureFlagEnabled and billing is $isBillingEnabled',
+ ({ isFeatureFlagEnabled, isBillingEnabled, expected }) => {
+ jotaiStore.set(currentWorkspaceState.atom, {
+ ...mockCurrentWorkspace,
+ featureFlags: [
+ {
+ key: FeatureFlagKey.IS_GETTING_STARTED_ENABLED,
+ value: isFeatureFlagEnabled,
+ },
+ ],
+ });
+ jotaiStore.set(billingState.atom, {
+ ...mockedClientConfig.billing,
+ isBillingEnabled,
+ });
+
+ const { result } = renderHook(() => useIsGettingStartedEnabled(), {
+ wrapper: Wrapper,
+ });
+
+ expect(result.current).toBe(expected);
+ },
+ );
+});
diff --git a/packages/twenty-front/src/modules/getting-started/hooks/useGettingStartedProgress.ts b/packages/twenty-front/src/modules/getting-started/hooks/useGettingStartedProgress.ts
new file mode 100644
index 00000000000..3b49ef3d11b
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/hooks/useGettingStartedProgress.ts
@@ -0,0 +1,24 @@
+import { useIsGettingStartedEnabled } from '@/getting-started/hooks/useIsGettingStartedEnabled';
+import { useQuery } from '@apollo/client/react';
+
+import { GettingStartedProgressDocument } from '~/generated-metadata/graphql';
+
+export const useGettingStartedProgress = ({
+ isEnabled = true,
+}: {
+ isEnabled?: boolean;
+} = {}) => {
+ const isGettingStartedEnabled = useIsGettingStartedEnabled();
+
+ const { data, loading, error, refetch } = useQuery(
+ GettingStartedProgressDocument,
+ { skip: !isGettingStartedEnabled || !isEnabled },
+ );
+
+ return {
+ progress: data?.gettingStartedProgress,
+ loading,
+ error,
+ refetch,
+ };
+};
diff --git a/packages/twenty-front/src/modules/getting-started/hooks/useGettingStartedTrial.ts b/packages/twenty-front/src/modules/getting-started/hooks/useGettingStartedTrial.ts
new file mode 100644
index 00000000000..673a0b83e3d
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/hooks/useGettingStartedTrial.ts
@@ -0,0 +1,67 @@
+import { currentWorkspaceState } from '@/auth/states/currentWorkspaceState';
+import { billingState } from '@/client-config/states/billingState';
+import { getGettingStartedTrialCountdown } from '@/getting-started/utils/getGettingStartedTrialCountdown';
+import { useDateTimeFormat } from '@/localization/hooks/useDateTimeFormat';
+import { dateLocaleState } from '@/localization/states/dateLocaleState';
+import { formatDateISOStringToCustomUnicodeFormat } from '@/localization/utils/formatDateISOStringToCustomUnicodeFormat';
+import { BILLING_PLAN_LABELS } from '@/settings/billing/constants/BillingPlanLabels';
+import { billingHasPaymentMethodSelector } from '@/settings/billing/states/billingHasPaymentMethodSelector';
+import { getSubscriptionPlanKey } from '@/settings/billing/utils/getSubscriptionPlanKey';
+import { useHasPermissionFlag } from '@/settings/roles/hooks/useHasPermissionFlag';
+import { useAtomStateValue } from '@/ui/utilities/state/jotai/hooks/useAtomStateValue';
+import { useSubscriptionStatus } from '@/workspace/hooks/useSubscriptionStatus';
+import { useLingui } from '@lingui/react/macro';
+import { doNotTranslate } from 'twenty-shared/i18n';
+import { isDefined } from 'twenty-shared/utils';
+
+import { PermissionFlagType } from '~/generated-metadata/graphql';
+
+export const useGettingStartedTrial = () => {
+ const { t } = useLingui();
+ const subscriptionStatus = useSubscriptionStatus();
+ const currentWorkspace = useAtomStateValue(currentWorkspaceState);
+ const billingHasPaymentMethod = useAtomStateValue(
+ billingHasPaymentMethodSelector,
+ );
+ const hasBillingPermission = useHasPermissionFlag(PermissionFlagType.BILLING);
+ const billing = useAtomStateValue(billingState);
+ const { timeZone } = useDateTimeFormat();
+ const { localeCatalog } = useAtomStateValue(dateLocaleState);
+
+ const currentBillingSubscription =
+ currentWorkspace?.currentBillingSubscription;
+ const { trialEnd, isCountdownVisible, daysLeft, trialDays } =
+ getGettingStartedTrialCountdown({
+ subscriptionStatus,
+ currentPeriodEnd: currentBillingSubscription?.currentPeriodEnd,
+ hasPaymentMethod: billingHasPaymentMethod,
+ trialPeriods: billing?.trialPeriods ?? [],
+ now: new Date(),
+ });
+
+ const planKey = getSubscriptionPlanKey(currentBillingSubscription);
+ const planLabel = isDefined(planKey)
+ ? t(BILLING_PLAN_LABELS[planKey])
+ : undefined;
+
+ return {
+ trialEnd,
+ formattedTrialEnd:
+ isCountdownVisible && isDefined(trialEnd)
+ ? formatDateISOStringToCustomUnicodeFormat({
+ date: trialEnd.toISOString(),
+ timeZone,
+ dateFormat: doNotTranslate('EEE, MMM d'),
+ localeCatalog,
+ })
+ : undefined,
+ planLabel,
+ daysLeft,
+ trialDays,
+ isCountdownVisible,
+ canKeepPlan: isCountdownVisible && hasBillingPermission,
+ keepPlanLabel: isDefined(planLabel)
+ ? t`Keep ${planLabel}`
+ : t`Keep your plan`,
+ };
+};
diff --git a/packages/twenty-front/src/modules/getting-started/hooks/useIsGettingStartedEnabled.ts b/packages/twenty-front/src/modules/getting-started/hooks/useIsGettingStartedEnabled.ts
new file mode 100644
index 00000000000..283c2caf491
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/hooks/useIsGettingStartedEnabled.ts
@@ -0,0 +1,14 @@
+import { billingState } from '@/client-config/states/billingState';
+import { useAtomStateValue } from '@/ui/utilities/state/jotai/hooks/useAtomStateValue';
+import { useIsFeatureEnabled } from '@/workspace/hooks/useIsFeatureEnabled';
+
+import { FeatureFlagKey } from '~/generated-metadata/graphql';
+
+export const useIsGettingStartedEnabled = () => {
+ const billing = useAtomStateValue(billingState);
+ const isGettingStartedFeatureEnabled = useIsFeatureEnabled(
+ FeatureFlagKey.IS_GETTING_STARTED_ENABLED,
+ );
+
+ return isGettingStartedFeatureEnabled && (billing?.isBillingEnabled ?? false);
+};
diff --git a/packages/twenty-front/src/modules/getting-started/hooks/useSelectGettingStartedStep.ts b/packages/twenty-front/src/modules/getting-started/hooks/useSelectGettingStartedStep.ts
new file mode 100644
index 00000000000..51c5ab26a14
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/hooks/useSelectGettingStartedStep.ts
@@ -0,0 +1,21 @@
+import { useUpdateGettingStarted } from '@/getting-started/hooks/useUpdateGettingStarted';
+import { gettingStartedJustCompletedStepState } from '@/getting-started/states/gettingStartedJustCompletedStepState';
+import { useSetAtomState } from '@/ui/utilities/state/jotai/hooks/useSetAtomState';
+
+import { type GettingStartedStepActionKey } from '~/generated-metadata/graphql';
+
+export const useSelectGettingStartedStep = () => {
+ const setGettingStartedJustCompletedStep = useSetAtomState(
+ gettingStartedJustCompletedStepState,
+ );
+ const { updateGettingStarted, isSaving } = useUpdateGettingStarted();
+
+ const selectGettingStartedStep = (
+ stepActionKey: GettingStartedStepActionKey,
+ ) => {
+ setGettingStartedJustCompletedStep(null);
+ void updateGettingStarted({ selectedStepActionKey: stepActionKey });
+ };
+
+ return { selectGettingStartedStep, isSaving };
+};
diff --git a/packages/twenty-front/src/modules/getting-started/hooks/useShouldOpenGettingStarted.ts b/packages/twenty-front/src/modules/getting-started/hooks/useShouldOpenGettingStarted.ts
new file mode 100644
index 00000000000..6154bccc029
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/hooks/useShouldOpenGettingStarted.ts
@@ -0,0 +1,30 @@
+import { useGettingStartedProgress } from '@/getting-started/hooks/useGettingStartedProgress';
+import { getShouldOpenGettingStarted } from '@/getting-started/utils/getShouldOpenGettingStarted';
+import { useSubscriptionStatus } from '@/workspace/hooks/useSubscriptionStatus';
+import { isDefined } from 'twenty-shared/utils';
+
+import { SubscriptionStatus } from '~/generated-metadata/graphql';
+
+export const useShouldOpenGettingStarted = ({
+ isEnabled,
+}: {
+ isEnabled: boolean;
+}) => {
+ const subscriptionStatus = useSubscriptionStatus();
+
+ const { progress, loading } = useGettingStartedProgress({
+ isEnabled: isEnabled && subscriptionStatus === SubscriptionStatus.Trialing,
+ });
+
+ if (!isDefined(progress)) {
+ return { shouldOpenGettingStarted: false, isLoading: loading };
+ }
+
+ return {
+ shouldOpenGettingStarted: getShouldOpenGettingStarted({
+ progress,
+ now: new Date(),
+ }),
+ isLoading: false,
+ };
+};
diff --git a/packages/twenty-front/src/modules/getting-started/hooks/useUpdateGettingStarted.ts b/packages/twenty-front/src/modules/getting-started/hooks/useUpdateGettingStarted.ts
new file mode 100644
index 00000000000..c49ca9dd15d
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/hooks/useUpdateGettingStarted.ts
@@ -0,0 +1,63 @@
+import { getToastOptionsFromError } from '@/error-handler/utils/getToastOptionsFromError';
+import { gettingStartedJustCompletedStepState } from '@/getting-started/states/gettingStartedJustCompletedStepState';
+import { getGettingStartedJustCompletedStep } from '@/getting-started/utils/getGettingStartedJustCompletedStep';
+import { useSetAtomState } from '@/ui/utilities/state/jotai/hooks/useSetAtomState';
+import { useMutation } from '@apollo/client/react';
+import { isDefined } from 'twenty-shared/utils';
+import { useToast } from 'twenty-ui/components/feedback';
+
+import {
+ GettingStartedProgressDocument,
+ UpdateGettingStartedDocument,
+ type UpdateGettingStartedInput,
+} from '~/generated-metadata/graphql';
+
+export const useUpdateGettingStarted = () => {
+ const { enqueueToast } = useToast();
+ const setGettingStartedJustCompletedStep = useSetAtomState(
+ gettingStartedJustCompletedStepState,
+ );
+
+ const [updateGettingStartedMutation, { loading }] = useMutation(
+ UpdateGettingStartedDocument,
+ {
+ update: (cache, { data }) => {
+ if (!isDefined(data)) {
+ return;
+ }
+
+ const justCompletedStep = getGettingStartedJustCompletedStep({
+ previousProgress: cache.readQuery({
+ query: GettingStartedProgressDocument,
+ })?.gettingStartedProgress,
+ progress: data.updateGettingStarted,
+ });
+
+ if (isDefined(justCompletedStep)) {
+ setGettingStartedJustCompletedStep(justCompletedStep);
+ }
+
+ cache.writeQuery({
+ query: GettingStartedProgressDocument,
+ data: { gettingStartedProgress: data.updateGettingStarted },
+ });
+ },
+ },
+ );
+
+ const updateGettingStarted = async (
+ input: UpdateGettingStartedInput,
+ ): Promise<boolean> => {
+ try {
+ await updateGettingStartedMutation({ variables: { input } });
+
+ return true;
+ } catch (error) {
+ enqueueToast(getToastOptionsFromError({ error }));
+
+ return false;
+ }
+ };
+
+ return { updateGettingStarted, isSaving: loading };
+};
diff --git a/packages/twenty-front/src/modules/getting-started/states/gettingStartedJustCompletedStepState.ts b/packages/twenty-front/src/modules/getting-started/states/gettingStartedJustCompletedStepState.ts
new file mode 100644
index 00000000000..9caf39cd103
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/states/gettingStartedJustCompletedStepState.ts
@@ -0,0 +1,9 @@
+import { createAtomState } from '@/ui/utilities/state/jotai/utils/createAtomState';
+
+import { type GettingStartedStepActionKey } from '~/generated-metadata/graphql';
+
+export const gettingStartedJustCompletedStepState =
+ createAtomState<GettingStartedStepActionKey | null>({
+ key: 'gettingStartedJustCompletedStepState',
+ defaultValue: null,
+ });
diff --git a/packages/twenty-front/src/modules/getting-started/types/GettingStartedSnoozeOption.ts b/packages/twenty-front/src/modules/getting-started/types/GettingStartedSnoozeOption.ts
new file mode 100644
index 00000000000..fe3ee12fedd
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/types/GettingStartedSnoozeOption.ts
@@ -0,0 +1 @@
+export type GettingStartedSnoozeOption = 'hour' | 'tomorrow' | 'lastThreeDays';
diff --git a/packages/twenty-front/src/modules/getting-started/types/GettingStartedStepDoneDescriptionProps.ts b/packages/twenty-front/src/modules/getting-started/types/GettingStartedStepDoneDescriptionProps.ts
new file mode 100644
index 00000000000..b184733d9de
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/types/GettingStartedStepDoneDescriptionProps.ts
@@ -0,0 +1,3 @@
+export type GettingStartedStepDoneDescriptionProps = {
+ description: string;
+};
diff --git a/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedJustCompletedStep.test.ts b/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedJustCompletedStep.test.ts
new file mode 100644
index 00000000000..92489aceb0f
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedJustCompletedStep.test.ts
@@ -0,0 +1,81 @@
+import { getGettingStartedJustCompletedStep } from '@/getting-started/utils/getGettingStartedJustCompletedStep';
+import { GettingStartedStepActionKey } from '~/generated-metadata/graphql';
+import { mockGettingStartedStepDefinitions } from '~/testing/mock-data/gettingStartedSteps';
+
+const PREVIOUS_PROGRESS = {
+ steps: mockGettingStartedStepDefinitions,
+ completedStepActionKeys: [GettingStartedStepActionKey.CONNECT_MAILBOX],
+ selectedStepActionKey: GettingStartedStepActionKey.INVITE_TEAM,
+};
+
+describe('getGettingStartedJustCompletedStep', () => {
+ it('returns the displayed step when it goes from open to done', () => {
+ expect(
+ getGettingStartedJustCompletedStep({
+ previousProgress: PREVIOUS_PROGRESS,
+ progress: {
+ completedStepActionKeys: [
+ GettingStartedStepActionKey.CONNECT_MAILBOX,
+ GettingStartedStepActionKey.INVITE_TEAM,
+ ],
+ },
+ }),
+ ).toBe(GettingStartedStepActionKey.INVITE_TEAM);
+ });
+
+ it('falls back to the first remaining step when none is selected', () => {
+ expect(
+ getGettingStartedJustCompletedStep({
+ previousProgress: { ...PREVIOUS_PROGRESS, selectedStepActionKey: null },
+ progress: {
+ completedStepActionKeys: [
+ GettingStartedStepActionKey.CONNECT_MAILBOX,
+ GettingStartedStepActionKey.IMPORT_DATA,
+ ],
+ },
+ }),
+ ).toBe(GettingStartedStepActionKey.IMPORT_DATA);
+ });
+
+ it('returns null on the first progress, so a page load never animates', () => {
+ expect(
+ getGettingStartedJustCompletedStep({
+ previousProgress: undefined,
+ progress: {
+ completedStepActionKeys: [GettingStartedStepActionKey.INVITE_TEAM],
+ },
+ }),
+ ).toBeNull();
+ });
+
+ it('returns null when a step other than the displayed one completes', () => {
+ expect(
+ getGettingStartedJustCompletedStep({
+ previousProgress: PREVIOUS_PROGRESS,
+ progress: {
+ completedStepActionKeys: [
+ GettingStartedStepActionKey.CONNECT_MAILBOX,
+ GettingStartedStepActionKey.INSTALL_APP,
+ ],
+ },
+ }),
+ ).toBeNull();
+ });
+
+ it('returns null when the displayed step was already done', () => {
+ expect(
+ getGettingStartedJustCompletedStep({
+ previousProgress: {
+ ...PREVIOUS_PROGRESS,
+ selectedStepActionKey: GettingStartedStepActionKey.CONNECT_MAILBOX,
+ },
+ progress: {
+ completedStepActionKeys: [
+ GettingStartedStepActionKey.CONNECT_MAILBOX,
+ GettingStartedStepActionKey.INVITE_TEAM,
+ ],
+ },
+ }),
+ ).toBeNull();
+ });
+});
diff --git a/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedSnoozedUntil.test.ts b/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedSnoozedUntil.test.ts
new file mode 100644
index 00000000000..b1662026f96
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedSnoozedUntil.test.ts
@@ -0,0 +1,54 @@
+import { getGettingStartedSnoozedUntil } from '@/getting-started/utils/getGettingStartedSnoozedUntil';
+
+describe('getGettingStartedSnoozedUntil', () => {
+ it.each([
+ {
+ description: 'snoozes until the next local midnight across spring DST',
+ now: '2026-03-29T00:30:00Z',
+ timeZone: 'Europe/Paris',
+ expected: '2026-03-29T22:00:00.000Z',
+ },
+ {
+ description: 'snoozes until the next local midnight behind UTC',
+ now: '2026-01-01T02:00:00Z',
+ timeZone: 'America/Los_Angeles',
+ expected: '2026-01-01T08:00:00.000Z',
+ },
+ ])('$description', ({ now, timeZone, expected }) => {
+ expect(
+ getGettingStartedSnoozedUntil({
+ option: 'tomorrow',
+ now: new Date(now),
+ timeZone,
+ trialEnd: null,
+ }),
+ ).toBe(expected);
+ });
+
+ it.each([
+ {
+ description: 'snoozes until exactly 72 hours before the trial ends',
+ trialEnd: new Date('2026-04-05T12:34:00Z'),
+ expected: '2026-04-02T12:34:00.000Z',
+ },
+ {
+ description: 'returns null once the last three days have started',
+ trialEnd: new Date('2026-03-30T12:00:00Z'),
+ expected: null,
+ },
+ {
+ description: 'returns null without a trial end',
+ trialEnd: null,
+ expected: null,
+ },
+ ])('$description', ({ trialEnd, expected }) => {
+ expect(
+ getGettingStartedSnoozedUntil({
+ option: 'lastThreeDays',
+ now: new Date('2026-03-28T22:30:00Z'),
+ timeZone: 'UTC',
+ trialEnd,
+ }),
+ ).toBe(expected);
+ });
+});
diff --git a/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedStepSelection.test.ts b/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedStepSelection.test.ts
new file mode 100644
index 00000000000..c6b77778b2e
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedStepSelection.test.ts
@@ -0,0 +1,59 @@
+import { getGettingStartedStepSelection } from '@/getting-started/utils/getGettingStartedStepSelection';
+import { GettingStartedStepActionKey } from '~/generated-metadata/graphql';
+import { mockGettingStartedStepActionKeys } from '~/testing/mock-data/gettingStartedSteps';
+
+describe('getGettingStartedStepSelection', () => {
+ it.each([
+ {
+ description: 'keeps the saved step and skips to the next remaining step',
+ completedStepActionKeys: [GettingStartedStepActionKey.HANDOVER_DEALS],
+ selectedStepActionKey: GettingStartedStepActionKey.INVITE_TEAM,
+ expected: {
+ selectedStepActionKey: GettingStartedStepActionKey.INVITE_TEAM,
+ nextStep: GettingStartedStepActionKey.FOLLOW_UP_DEALS,
+ stepAfterSkip: GettingStartedStepActionKey.FOLLOW_UP_DEALS,
+ },
+ },
+ {
+ description: 'wraps to the first remaining step',
+ completedStepActionKeys: [],
+ selectedStepActionKey: GettingStartedStepActionKey.FOLLOW_UP_DEALS,
+ expected: {
+ selectedStepActionKey: GettingStartedStepActionKey.FOLLOW_UP_DEALS,
+ nextStep: GettingStartedStepActionKey.CONNECT_MAILBOX,
+ stepAfterSkip: GettingStartedStepActionKey.CONNECT_MAILBOX,
+ },
+ },
+ {
+ description: 'selects the first step once every step is completed',
+ completedStepActionKeys: mockGettingStartedStepActionKeys,
+ selectedStepActionKey: null,
+ expected: {
+ selectedStepActionKey: GettingStartedStepActionKey.CONNECT_MAILBOX,
+ nextStep: GettingStartedStepActionKey.CONNECT_MAILBOX,
+ stepAfterSkip: GettingStartedStepActionKey.CONNECT_MAILBOX,
+ },
+ },
+ {
+ description: 'skips from a completed step back to the current step',
+ completedStepActionKeys: [GettingStartedStepActionKey.INVITE_TEAM],
+ selectedStepActionKey: GettingStartedStepActionKey.INVITE_TEAM,
+ expected: {
+ selectedStepActionKey: GettingStartedStepActionKey.INVITE_TEAM,
+ nextStep: GettingStartedStepActionKey.HANDOVER_DEALS,
+ stepAfterSkip: GettingStartedStepActionKey.CONNECT_MAILBOX,
+ },
+ },
+ ])(
+ '$description',
+ ({ completedStepActionKeys, selectedStepActionKey, expected }) => {
+ expect(
+ getGettingStartedStepSelection({
+ stepActionKeys: mockGettingStartedStepActionKeys,
+ completedStepActionKeys,
+ selectedStepActionKey,
+ }),
+ ).toEqual(expected);
+ },
+ );
+});
diff --git a/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedTrialCountdown.test.ts b/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedTrialCountdown.test.ts
new file mode 100644
index 00000000000..41c94664df6
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/__tests__/getGettingStartedTrialCountdown.test.ts
@@ -0,0 +1,64 @@
+import { getGettingStartedTrialCountdown } from '@/getting-started/utils/getGettingStartedTrialCountdown';
+import { SubscriptionStatus } from '~/generated-metadata/graphql';
+
+const NOW = new Date('2026-03-01T12:00:00.000Z');
+
+const TRIAL_PERIODS = [
+ { duration: 30, isCreditCardRequired: true },
+ { duration: 14, isCreditCardRequired: false },
+];
+
+describe('getGettingStartedTrialCountdown', () => {
+ it.each([
+ {
+ description: 'returns no trial when the workspace is not trialing',
+ subscriptionStatus: SubscriptionStatus.Active,
+ currentPeriodEnd: '2026-03-11T12:00:00.000Z',
+ hasPaymentMethod: false,
+ expected: {
+ trialEnd: null,
+ isCountdownVisible: false,
+ daysLeft: 0,
+ trialDays: 0,
+ },
+ },
+ {
+ description: 'counts the days left against the no-card trial duration',
+ subscriptionStatus: SubscriptionStatus.Trialing,
+ currentPeriodEnd: '2026-03-11T12:00:00.000Z',
+ hasPaymentMethod: false,
+ expected: {
+ trialEnd: new Date('2026-03-11T12:00:00.000Z'),
+ isCountdownVisible: true,
+ daysLeft: 10,
+ trialDays: 14,
+ },
+ },
+ {
+ description:
+ 'hides the countdown with a payment method and never goes below zero days',
+ subscriptionStatus: SubscriptionStatus.Trialing,
+ currentPeriodEnd: '2026-02-27T12:00:00.000Z',
+ hasPaymentMethod: true,
+ expected: {
+ trialEnd: new Date('2026-02-27T12:00:00.000Z'),
+ isCountdownVisible: false,
+ daysLeft: 0,
+ trialDays: 14,
+ },
+ },
+ ])(
+ '$description',
+ ({ subscriptionStatus, currentPeriodEnd, hasPaymentMethod, expected }) => {
+ expect(
+ getGettingStartedTrialCountdown({
+ subscriptionStatus,
+ currentPeriodEnd,
+ hasPaymentMethod,
+ trialPeriods: TRIAL_PERIODS,
+ now: NOW,
+ }),
+ ).toEqual(expected);
+ },
+ );
+});
diff --git a/packages/twenty-front/src/modules/getting-started/utils/__tests__/getShouldOpenGettingStarted.test.ts b/packages/twenty-front/src/modules/getting-started/utils/__tests__/getShouldOpenGettingStarted.test.ts
new file mode 100644
index 00000000000..5161bbf3431
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/__tests__/getShouldOpenGettingStarted.test.ts
@@ -0,0 +1,49 @@
+import { getShouldOpenGettingStarted } from '@/getting-started/utils/getShouldOpenGettingStarted';
+import {
+ mockGettingStartedStepDefinitions,
+ mockGettingStartedStepActionKeys,
+} from '~/testing/mock-data/gettingStartedSteps';
+
+const NOW = new Date('2026-10-29T12:00:00.000Z');
+
+const OPEN_PROGRESS = {
+ steps: mockGettingStartedStepDefinitions,
+ completedStepActionKeys: [],
+ isHidden: false,
+ snoozedUntil: null,
+};
+
+describe('getShouldOpenGettingStarted', () => {
+ it.each([
+ {
+ description: 'opens with a remaining step and no snooze',
+ progress: OPEN_PROGRESS,
+ expected: true,
+ },
+ {
+ description: 'stays closed once hidden',
+ progress: { ...OPEN_PROGRESS, isHidden: true },
+ expected: false,
+ },
+ {
+ description: 'stays closed once every step is done',
+ progress: {
+ ...OPEN_PROGRESS,
+ completedStepActionKeys: mockGettingStartedStepActionKeys,
+ },
+ expected: false,
+ },
+ {
+ description: 'stays closed while snoozed',
+ progress: { ...OPEN_PROGRESS, snoozedUntil: '2026-10-29T12:00:01.000Z' },
+ expected: false,
+ },
+ {
+ description: 'opens again when the snooze ends',
+ progress: { ...OPEN_PROGRESS, snoozedUntil: NOW.toISOString() },
+ expected: true,
+ },
+ ])('$description', ({ progress, expected }) => {
+ expect(getShouldOpenGettingStarted({ progress, now: NOW })).toBe(expected);
+ });
+});
diff --git a/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedJustCompletedStep.ts b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedJustCompletedStep.ts
new file mode 100644
index 00000000000..8c06e7b380b
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedJustCompletedStep.ts
@@ -0,0 +1,44 @@
+import { getGettingStartedStepSelection } from '@/getting-started/utils/getGettingStartedStepSelection';
+import { isDefined } from 'twenty-shared/utils';
+
+import {
+ type GettingStartedProgressQuery,
+ type GettingStartedStepActionKey,
+} from '~/generated-metadata/graphql';
+
+type GettingStartedProgress =
+ GettingStartedProgressQuery['gettingStartedProgress'];
+
+export const getGettingStartedJustCompletedStep = ({
+ previousProgress,
+ progress,
+}: {
+ previousProgress:
+ | Pick<
+ GettingStartedProgress,
+ 'steps' | 'completedStepActionKeys' | 'selectedStepActionKey'
+ >
+ | undefined;
+ progress: Pick<GettingStartedProgress, 'completedStepActionKeys'>;
+}): GettingStartedStepActionKey | null => {
+ if (!isDefined(previousProgress)) {
+ return null;
+ }
+
+ const { selectedStepActionKey: previouslyDisplayedStep } =
+ getGettingStartedStepSelection({
+ stepActionKeys: previousProgress.steps.map(({ actionKey }) => actionKey),
+ completedStepActionKeys: previousProgress.completedStepActionKeys,
+ selectedStepActionKey: previousProgress.selectedStepActionKey,
+ });
+
+ const wasDisplayedStepCompleted =
+ previousProgress.completedStepActionKeys.includes(previouslyDisplayedStep);
+ const isDisplayedStepCompleted = progress.completedStepActionKeys.includes(
+ previouslyDisplayedStep,
+ );
+
+ return !wasDisplayedStepCompleted && isDisplayedStepCompleted
+ ? previouslyDisplayedStep
+ : null;
+};
diff --git a/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedKeepPlanDescription.ts b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedKeepPlanDescription.ts
new file mode 100644
index 00000000000..faf5b766c9a
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedKeepPlanDescription.ts
@@ -0,0 +1,16 @@
+import { t } from '@lingui/core/macro';
+import { isDefined } from 'twenty-shared/utils';
+
+export const getGettingStartedKeepPlanDescription = ({
+ planLabel,
+ formattedTrialEnd,
+}: {
+ planLabel: string | undefined;
+ formattedTrialEnd: string;
+}): string => {
+ if (!isDefined(planLabel)) {
+ return t`Your trial ends on ${formattedTrialEnd}. Add a card now to keep your plan after that. You won't be charged before then.`;
+ }
+
+ return t`Your trial ends on ${formattedTrialEnd}. Add a card now to stay on the ${planLabel} plan after that. You won't be charged before then.`;
+};
diff --git a/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedRemainingSteps.ts b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedRemainingSteps.ts
new file mode 100644
index 00000000000..17e3a055238
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedRemainingSteps.ts
@@ -0,0 +1,13 @@
+import {
+ type GettingStartedStepActionKey,
+ type GettingStartedStepDefinition,
+} from '~/generated-metadata/graphql';
+
+export const getGettingStartedRemainingSteps = ({
+ steps,
+ completedStepActionKeys,
+}: {
+ steps: GettingStartedStepDefinition[];
+ completedStepActionKeys: GettingStartedStepActionKey[];
+}): GettingStartedStepDefinition[] =>
+ steps.filter(({ actionKey }) => !completedStepActionKeys.includes(actionKey));
diff --git a/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedSnoozedUntil.ts b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedSnoozedUntil.ts
new file mode 100644
index 00000000000..81496df4a3a
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedSnoozedUntil.ts
@@ -0,0 +1,47 @@
+import { addHours, isAfter, subHours } from 'date-fns';
+import { Temporal } from 'temporal-polyfill';
+import { doNotTranslate } from 'twenty-shared/i18n';
+import { getNextPeriodStart, isDefined } from 'twenty-shared/utils';
+
+import { GETTING_STARTED_LAST_DAYS_SNOOZE_HOURS } from '@/getting-started/constants/GettingStartedLastDaysSnoozeHours';
+import { type GettingStartedSnoozeOption } from '@/getting-started/types/GettingStartedSnoozeOption';
+
+export const getGettingStartedSnoozedUntil = ({
+ option,
+ now,
+ timeZone,
+ trialEnd,
+}: {
+ option: GettingStartedSnoozeOption;
+ now: Date;
+ timeZone: string;
+ trialEnd: Date | null;
+}): string | null => {
+ if (option === 'hour') {
+ return addHours(now, 1).toISOString();
+ }
+
+ if (option === 'lastThreeDays') {
+ if (!isDefined(trialEnd)) {
+ return null;
+ }
+
+ const lastThreeDaysStart = subHours(
+ trialEnd,
+ GETTING_STARTED_LAST_DAYS_SNOOZE_HOURS,
+ );
+
+ return isAfter(lastThreeDaysStart, now)
+ ? lastThreeDaysStart.toISOString()
+ : null;
+ }
+
+ const nextLocalMidnight = getNextPeriodStart(
+ Temporal.Instant.fromEpochMilliseconds(now.getTime()).toZonedDateTimeISO(
+ timeZone,
+ ),
+ doNotTranslate('DAY'),
+ );
+
+ return new Date(nextLocalMidnight.epochMilliseconds).toISOString();
+};
diff --git a/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedStepSelection.ts b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedStepSelection.ts
new file mode 100644
index 00000000000..af3284f4f23
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedStepSelection.ts
@@ -0,0 +1,37 @@
+import { type GettingStartedStepActionKey } from '~/generated-metadata/graphql';
+
+export const getGettingStartedStepSelection = ({
+ stepActionKeys,
+ completedStepActionKeys,
+ selectedStepActionKey,
+}: {
+ stepActionKeys: GettingStartedStepActionKey[];
+ completedStepActionKeys: GettingStartedStepActionKey[];
+ selectedStepActionKey: GettingStartedStepActionKey | null | undefined;
+}): {
+ selectedStepActionKey: GettingStartedStepActionKey;
+ nextStep: GettingStartedStepActionKey;
+ stepAfterSkip: GettingStartedStepActionKey;
+} => {
+ const currentStep =
+ stepActionKeys.find(
+ (stepActionKey) => !completedStepActionKeys.includes(stepActionKey),
+ ) ?? stepActionKeys[0];
+ const displayedStep = selectedStepActionKey ?? currentStep;
+ const displayedStepIndex = stepActionKeys.indexOf(displayedStep);
+ const nextStep =
+ [
+ ...stepActionKeys.slice(displayedStepIndex + 1),
+ ...stepActionKeys.slice(0, displayedStepIndex),
+ ].find(
+ (stepActionKey) => !completedStepActionKeys.includes(stepActionKey),
+ ) ?? displayedStep;
+
+ return {
+ selectedStepActionKey: displayedStep,
+ nextStep,
+ stepAfterSkip: completedStepActionKeys.includes(displayedStep)
+ ? currentStep
+ : nextStep,
+ };
+};
diff --git a/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedTrialCountdown.ts b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedTrialCountdown.ts
new file mode 100644
index 00000000000..da9da2340d6
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/getGettingStartedTrialCountdown.ts
@@ -0,0 +1,51 @@
+import { differenceInCalendarDays } from 'date-fns';
+import { isDefined } from 'twenty-shared/utils';
+
+import {
+ type BillingTrialPeriod,
+ SubscriptionStatus,
+} from '~/generated-metadata/graphql';
+
+export const getGettingStartedTrialCountdown = ({
+ subscriptionStatus,
+ currentPeriodEnd,
+ hasPaymentMethod,
+ trialPeriods,
+ now,
+}: {
+ subscriptionStatus: SubscriptionStatus | undefined;
+ currentPeriodEnd: string | null | undefined;
+ hasPaymentMethod: boolean | null | undefined;
+ trialPeriods: Pick<BillingTrialPeriod, 'duration' | 'isCreditCardRequired'>[];
+ now: Date;
+}): {
+ trialEnd: Date | null;
+ isCountdownVisible: boolean;
+ daysLeft: number;
+ trialDays: number;
+} => {
+ if (
+ subscriptionStatus !== SubscriptionStatus.Trialing ||
+ !isDefined(currentPeriodEnd)
+ ) {
+ return {
+ trialEnd: null,
+ isCountdownVisible: false,
+ daysLeft: 0,
+ trialDays: 0,
+ };
+ }
+
+ const trialEnd = new Date(currentPeriodEnd);
+ const daysLeft = Math.max(0, differenceInCalendarDays(trialEnd, now));
+ const trialDurationInDays =
+ trialPeriods.find(({ isCreditCardRequired }) => !isCreditCardRequired)
+ ?.duration ?? 0;
+
+ return {
+ trialEnd,
+ isCountdownVisible: hasPaymentMethod === false,
+ daysLeft,
+ trialDays: Math.max(trialDurationInDays, daysLeft),
+ };
+};
diff --git a/packages/twenty-front/src/modules/getting-started/utils/getShouldOpenGettingStarted.ts b/packages/twenty-front/src/modules/getting-started/utils/getShouldOpenGettingStarted.ts
new file mode 100644
index 00000000000..fb24999ff5f
--- /dev/null
+++ b/packages/twenty-front/src/modules/getting-started/utils/getShouldOpenGettingStarted.ts
@@ -0,0 +1,33 @@
+import { getGettingStartedRemainingSteps } from '@/getting-started/utils/getGettingStartedRemainingSteps';
+import { isDefined } from 'twenty-shared/utils';
+
+import { type GettingStartedProgressQuery } from '~/generated-metadata/graphql';
+
+export const getShouldOpenGettingStarted = ({
+ progress,
+ now,
+}: {
+ progress: Pick<
+ GettingStartedProgressQuery['gettingStartedProgress'],
+ 'steps' | 'completedStepActionKeys' | 'isHidden' | 'snoozedUntil'
+ >;
+ now: Date;
+}): boolean => {
+ if (progress.isHidden) {
+ return false;
+ }
+
+ const remainingSteps = getGettingStartedRemainingSteps({
+ steps: progress.steps,
+ completedStepActionKeys: progress.completedStepActionKeys,
+ });
+
+ if (remainingSteps.length === 0) {
+ return false;
+ }
+
+ return (
+ !isDefined(progress.snoozedUntil) ||
+ Date.parse(progress.snoozedUntil) <= now.getTime()
+ );
+};
diff --git a/packages/twenty-front/src/modules/navigation/components/AppNavigationDrawer.tsx b/packages/twenty-front/src/modules/navigation/components/AppNavigationDrawer.tsx
index fc8af2bc874..65ecf7dc80e 100644
--- a/packages/twenty-front/src/modules/navigation/components/AppNavigationDrawer.tsx
+++ b/packages/twenty-front/src/modules/navigation/components/AppNavigationDrawer.tsx
@@ -1,3 +1,4 @@
+import { GettingStartedSidebarCard } from '@/getting-started/components/GettingStartedSidebarCard';
import { useIsSettingsDrawer } from '@/navigation/hooks/useIsSettingsDrawer';
import { MainNavigationDrawerContent } from '@/navigation/components/MainNavigationDrawerContent';
@@ -40,6 +41,7 @@ export const AppNavigationDrawer = ({
<MainNavigationDrawerContent />
)}
</NavigationDrawerModeTransition>
+ {!isSettingsDrawer && <GettingStartedSidebarCard />}
</NavigationDrawer>
);
};
diff --git a/packages/twenty-front/src/modules/navigation/components/MainNavigationDrawerScrollableItems.tsx b/packages/twenty-front/src/modules/navigation/components/MainNavigationDrawerScrollableItems.tsx
index b3b14a338ae..a987aea80bc 100644
--- a/packages/twenty-front/src/modules/navigation/components/MainNavigationDrawerScrollableItems.tsx
+++ b/packages/twenty-front/src/modules/navigation/components/MainNavigationDrawerScrollableItems.tsx
@@ -1,3 +1,4 @@
+import { GettingStartedOpenedSection } from '@/getting-started/components/GettingStartedOpenedSection';
import { NavigationDrawerOpenedSection } from '@/navigation-menu-item/display/sections/components/NavigationDrawerOpenedSection';
import { NavigationDrawerWorkspaceSectionSkeletonLoader } from '@/object-metadata/components/NavigationDrawerWorkspaceSectionSkeletonLoader';
@@ -32,6 +33,7 @@ export const MainNavigationDrawerScrollableItems = () => {
return (
<StyledScrollableItemsContainer>
<NavigationDrawerOpenedSection />
+ <GettingStartedOpenedSection />
<Suspense fallback={<NavigationDrawerWorkspaceSectionSkeletonLoader />}>
<FavoritesSectionDispatcher />
<WorkspaceSectionDispatcher />
diff --git a/packages/twenty-front/src/modules/navigation/components/__tests__/AppNavigationDrawer.test.tsx b/packages/twenty-front/src/modules/navigation/components/__tests__/AppNavigationDrawer.test.tsx
index 708ac01db96..c3cd0879cea 100644
--- a/packages/twenty-front/src/modules/navigation/components/__tests__/AppNavigationDrawer.test.tsx
+++ b/packages/twenty-front/src/modules/navigation/components/__tests__/AppNavigationDrawer.test.tsx
@@ -10,6 +10,10 @@ jest.mock('twenty-ui/utilities', () => ({
useIsMobile: jest.fn(),
}));
+jest.mock('@/getting-started/components/GettingStartedSidebarCard', () => ({
+ GettingStartedSidebarCard: () => null,
+}));
+
jest.mock('@/navigation/components/MainNavigationDrawerContent', () => ({
MainNavigationDrawerContent: () => <div>Main content</div>,
}));
diff --git a/packages/twenty-front/src/pages/getting-started/GettingStartedPage.tsx b/packages/twenty-front/src/pages/getting-started/GettingStartedPage.tsx
new file mode 100644
index 00000000000..d3b9f303ba3
--- /dev/null
+++ b/packages/twenty-front/src/pages/getting-started/GettingStartedPage.tsx
@@ -0,0 +1,46 @@
+import { GettingStartedKeepPlanButton } from '@/getting-started/components/GettingStartedKeepPlanButton';
+import { GettingStartedPageContent } from '@/getting-started/components/GettingStartedPageContent';
+import { GettingStartedSnoozeMenu } from '@/getting-started/components/GettingStartedSnoozeMenu';
+import { useGettingStartedTrial } from '@/getting-started/hooks/useGettingStartedTrial';
+import { useIsGettingStartedEnabled } from '@/getting-started/hooks/useIsGettingStartedEnabled';
+import { PageCardHeader } from '@/ui/layout/page/components/PageCardHeader';
+import { PageCardLayout } from '@/ui/layout/page/components/PageCardLayout';
+import { PageTitle } from '@/ui/utilities/page-title/components/PageTitle';
+import { useLingui } from '@lingui/react/macro';
+import { Navigate } from 'react-router-dom';
+import { AppPath } from 'twenty-shared/types';
+import { IconRocket } from 'twenty-ui/icon';
+import { useTheme } from 'twenty-ui/theme';
+
+export const GettingStartedPage = () => {
+ const { t } = useLingui();
+ const theme = useTheme();
+ const isGettingStartedEnabled = useIsGettingStartedEnabled();
+ const { canKeepPlan } = useGettingStartedTrial();
+
+ if (!isGettingStartedEnabled) {
+ return <Navigate to={AppPath.Index} replace />;
+ }
+
+ return (
+ <>
+ <PageTitle title={t`Getting started`} />
+ <PageCardLayout
+ header={
+ <PageCardHeader
+ icon={<IconRocket size={theme.icon.size.md} />}
+ title={t`Getting started`}
+ actionButton={
+ <>
+ {canKeepPlan && <GettingStartedKeepPlanButton size="sm" />}
+ <GettingStartedSnoozeMenu />
+ </>
+ }
+ />
+ }
+ >
+ <GettingStartedPageContent />
+ </PageCardLayout>
+ </>
+ );
+};
diff --git a/packages/twenty-front/src/pages/mobile-home/MobileHomePage.tsx b/packages/twenty-front/src/pages/mobile-home/MobileHomePage.tsx
index 2570c2fff14..21bb0933bba 100644
--- a/packages/twenty-front/src/pages/mobile-home/MobileHomePage.tsx
+++ b/packages/twenty-front/src/pages/mobile-home/MobileHomePage.tsx
@@ -1,3 +1,4 @@
+import { GettingStartedSidebarCard } from '@/getting-started/components/GettingStartedSidebarCard';
import { MobileHomeAiChatSection } from '@/ai/components/MobileHomeAiChatSection';
import { MainNavigationDrawerNavigationContent } from '@/navigation/components/MainNavigationDrawerNavigationContent';
import { useDefaultHomePagePath } from '@/navigation/hooks/useDefaultHomePagePath';
@@ -47,6 +48,7 @@ export const MobileHomePage = () => {
<NavigationDrawerScrollableContent>
<StyledSections>
<MainNavigationDrawerNavigationContent />
+ <GettingStartedSidebarCard />
{hasAiPermission && <MobileHomeAiChatSection />}
</StyledSections>
</NavigationDrawerScrollableContent>
diff --git a/packages/twenty-front/src/testing/mock-data/gettingStartedSteps.ts b/packages/twenty-front/src/testing/mock-data/gettingStartedSteps.ts
new file mode 100644
index 00000000000..6c826f56419
--- /dev/null
+++ b/packages/twenty-front/src/testing/mock-data/gettingStartedSteps.ts
@@ -0,0 +1,87 @@
+import {
+ type GettingStartedProgressQuery,
+ GettingStartedStepActionKey,
+ GettingStartedStepKind,
+} from '~/generated-metadata/graphql';
+
+export const mockGettingStartedStepDefinitions: GettingStartedProgressQuery['gettingStartedProgress']['steps'] =
+ [
+ {
+ __typename: 'GettingStartedStepDefinition',
+ actionKey: GettingStartedStepActionKey.CONNECT_MAILBOX,
+ kind: GettingStartedStepKind.CUSTOM,
+ title: 'Connect your mailbox',
+ doneTitle: 'Mailbox connected',
+ description:
+ 'Companies and people fill in from your emails and meetings.',
+ icon: 'IconAt',
+ iconColor: 'blue',
+ promptLabel: null,
+ prompt: null,
+ },
+ {
+ __typename: 'GettingStartedStepDefinition',
+ actionKey: GettingStartedStepActionKey.IMPORT_DATA,
+ kind: GettingStartedStepKind.CUSTOM,
+ title: 'Import your data',
+ doneTitle: 'Spreadsheet uploaded',
+ description:
+ 'Bring your companies, contacts and deals from any CRM export.',
+ icon: 'IconFileImport',
+ iconColor: 'gray',
+ promptLabel: null,
+ prompt: null,
+ },
+ {
+ __typename: 'GettingStartedStepDefinition',
+ actionKey: GettingStartedStepActionKey.INSTALL_APP,
+ kind: GettingStartedStepKind.CUSTOM,
+ title: 'Install an app',
+ doneTitle: 'App installed',
+ description: 'Add tools to your workspace.',
+ icon: 'IconApps',
+ iconColor: 'turquoise',
+ promptLabel: null,
+ prompt: null,
+ },
+ {
+ __typename: 'GettingStartedStepDefinition',
+ actionKey: GettingStartedStepActionKey.INVITE_TEAM,
+ kind: GettingStartedStepKind.CUSTOM,
+ title: 'Invite your team',
+ doneTitle: 'Invitations sent',
+ description: 'Bring your team into Twenty.',
+ icon: 'IconUsers',
+ iconColor: 'orange',
+ promptLabel: null,
+ prompt: null,
+ },
+ {
+ __typename: 'GettingStartedStepDefinition',
+ actionKey: GettingStartedStepActionKey.HANDOVER_DEALS,
+ kind: GettingStartedStepKind.WORKFLOW,
+ title: 'Hand over won deals',
+ doneTitle: 'Workflow enabled',
+ description: 'Start the handover when a deal is won.',
+ icon: 'IconSettingsAutomation',
+ iconColor: 'gray',
+ promptLabel: null,
+ prompt: null,
+ },
+ {
+ __typename: 'GettingStartedStepDefinition',
+ actionKey: GettingStartedStepActionKey.FOLLOW_UP_DEALS,
+ kind: GettingStartedStepKind.PROMPT,
+ title: 'Follow up on closing deals',
+ doneTitle: 'Follow-up request sent',
+ description: 'An agent drafts a follow-up for every deal about to close.',
+ icon: 'IconSparkles',
+ iconColor: 'purple',
+ promptLabel: 'Follow-up instructions',
+ prompt:
+ 'Every Monday, draft a follow-up email for each deal closing in the next 30 days.',
+ },
+ ];
+
+export const mockGettingStartedStepActionKeys: GettingStartedStepActionKey[] =
+ mockGettingStartedStepDefinitions.map(({ actionKey }) => actionKey);
diff --git a/packages/twenty-shared/src/types/AppPath.ts b/packages/twenty-shared/src/types/AppPath.ts
index 23d156e3228..2ac233f3d47 100644
--- a/packages/twenty-shared/src/types/AppPath.ts
+++ b/packages/twenty-shared/src/types/AppPath.ts
@@ -15,6 +15,7 @@ export enum AppPath {
AiChat = '/chat/:threadId?',
AiChatInbox = '/inbox/:threadId?',
+ GettingStarted = '/getting-started',
Index = '/',
// Mobile only: the navigation menu is a page there rather than a drawer.
Home = '/home',