diff --git a/docs/images/templates-storybook.png b/docs/images/templates-storybook.png new file mode 100644 index 000000000..a8c3e3c55 Binary files /dev/null and b/docs/images/templates-storybook.png differ diff --git a/docs/images/templates-vs-code.png b/docs/images/templates-vs-code.png new file mode 100644 index 000000000..182a20c6a Binary files /dev/null and b/docs/images/templates-vs-code.png differ diff --git a/internal/cli/branding.go b/internal/cli/branding.go index 088e08be0..ca36d4533 100644 --- a/internal/cli/branding.go +++ b/internal/cli/branding.go @@ -92,7 +92,22 @@ func templateCmd(cli *cli) *cobra.Command { cmd := &cobra.Command{ Use: "templates", Short: "Manage custom page templates", - Long: "Manage custom page templates. This requires at least one custom domain to be configured for the tenant.", + Long: `Manage custom [page templates](https://auth0.com/docs/universal-login/new-experience/universal-login-page-templates). This requires a custom domain to be configured for the tenant. + +This command will open two windows: + +* A browser window with a [Storybook](https://storybook.js.org/) that shows the login page with the page template applied: + +![storybook](images/templates-storybook.png) + +* The default terminal editor, with the page template code: + +![storybook](images/templates-vs-code.png) + +You now change the page template code, and the changes will be reflected in the browser window. + +Once you close the window, you’ll be asked if you want to save the template. If you answer Yes, the template will be uploaded to your tenant. +`, } cmd.SetUsageTemplate(resourceUsageTemplate())