[Spec] Shell: How to do Login, Onboarding, and similar scenarios

[davidortinau]

Non-Navigation Pages in Shell

How might Shell make it clearer how you can add pages to AppShell.xaml that do not belong in a tab bar or flyout menu?

This could be a single page or a series of pages. Common use cases:

• Onboarding
• Login, Registration

In some cases the user should only see these when intended, often at the start of an app, and should not be able to return via a back navigation. This aspect is more to do with the navigation service.

https://gist.github.com/davidortinau/ab64a5f937c1f4bd44f50b9365f128e3

<Shell>
  <Stack>
    <ShellContent Route="Login" ContentTemplate="{DataTemplate LoginPage}"/>
    <ShellContent Route="Registration" ContentTemplate="{DataTemplate RegistrationPage}"/>
    <ShellContent Route="ForgotPassword" ContentTemplate="{DataTemplate ForgotPasswordPage}"/>
  </Stack>
  <TabBar>
    <Tab ../>
    <Tab ../>
  </TabBar/>
</Shell>

The first page in AppShell is displayed first. Since this proposal is not a ShellItem, no menus are displayed.

Navigation bar should be visible by default, and may be hidden.

What should this section of the app be called?

• Stack - it is a preset stack of pages to be displayed in order or as desired by route
• Flow - similar but a bit more descriptive perhaps

An app may have multiple, for example both an Onboarding and a Login.

<Shell>
   <Stack Route=“onboarding”>
     <ShellContent ContentTemplate="{DataTemplate Onboarding}"/>
  </Stack>
  <Stack Route=“login”>
     <ShellContent Route=“login” ContentTemplate="{DataTemplate LoginPage}"/>
    <ShellContent Route=“registration” ContentTemplate="{DataTemplate RegistrationPage}"/>
    <ShellContent Route=“forgot” ContentTemplate="{DataTemplate RecoverPasswordPage}"/>
  </Stack>

 <TabBar>
    <Tab ../>
    <Tab ../>
  </TabBar/>

</Shell>

API

[ class ]

Properties

API	Description
[name]	Gets or sets [description].

Events

API	Description
[name]	[API documentation/description]

Scenarios

Backward Compatibility

Difficulty : [low/medium/high]

[PureWeen]

related #5272

[davidortinau]

How you can do a Login or similar today with existing Shell features: https://github.com/davidortinau/ShellLoginSample

[PureWeen]

Closing and moving discussion to here #8528