Skip to content

Commit fcce23b

Browse files
committed
Update docs
1 parent edb339f commit fcce23b

File tree

8 files changed

+43
-38
lines changed

8 files changed

+43
-38
lines changed

docs/auth0_universal-login.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Manage Universal Login branding and customization settings.
1010
� DEPRECATION WARNING: Advanced Customizations (ACUL) have moved!
1111

1212
The 'auth0 ul customize --rendering-mode advanced' functionality will be
13-
DEPRECATED on April 18, 2026. Please migrate to the new ACUL commands:
13+
DEPRECATED on June 15, 2026. Please migrate to the new ACUL commands:
1414

1515
✅ auth0 acul config generate|get|set|list|docs
1616

docs/auth0_universal-login_customize.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,12 +36,12 @@ auth0 universal-login customize [flags]
3636
## Flags
3737

3838
```
39-
-f, --file string File to save the rendering configs to.
4039
-p, --prompt string Name of the prompt to to switch or customize.
4140
-r, --rendering-mode string standardMode is recommended for customizating consistent, branded experience for users.
4241
Alternatively, advancedMode is recommended for full customization/granular control of the login experience and to integrate own component design system
4342
44-
-s, --screen string Name of the screen to customize.
43+
-s, --screen string Name of the screen to to switch or customize.
44+
-f, --settings-file string File to save the rendering configs to.
4545
```
4646

4747

docs/auth0_universal-login_switch.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@ has_toc: false
77

88
Switch the rendering mode for Universal Login. Note that this requires a custom domain to be configured for the tenant.
99

10-
🚨 DEPRECATION WARNING: The 'auth0 ul switch' command will be DEPRECATED on April 30, 2026
10+
🚨 DEPRECATION WARNING: The 'auth0 ul switch' command will be DEPRECATED on June 15, 2026
1111

12-
✅ For Advanced Customizations, migrate to the new ACUL config commands:
12+
✅ For Advanced Customizations, Use new ACUL config commands:
1313
• auth0 acul config generate <screen>
1414
• auth0 acul config get <screen>
1515
• auth0 acul config set <screen>
@@ -37,7 +37,7 @@ auth0 universal-login switch [flags]
3737
-r, --rendering-mode string standardMode is recommended for customizating consistent, branded experience for users.
3838
Alternatively, advancedMode is recommended for full customization/granular control of the login experience and to integrate own component design system
3939
40-
-s, --screen string Name of the screen to customize.
40+
-s, --screen string Name of the screen to to switch or customize.
4141
```
4242

4343

docs/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ Authenticating as a user is not supported for **private cloud** tenants. Instead
8080
## Available Commands
8181

8282
- [auth0 actions](auth0_actions.md) - Manage resources for actions
83-
- [auth0 acul](auth0_acul.md) - Advance Customize the Universal Login experience
83+
- [auth0 acul](auth0_acul.md) - Advanced Customization the Universal Login experience
8484
- [auth0 api](auth0_api.md) - Makes an authenticated HTTP request to the Auth0 Management API
8585
- [auth0 apis](auth0_apis.md) - Manage resources for APIs
8686
- [auth0 apps](auth0_apps.md) - Manage resources for applications

internal/cli/acul.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ import (
1111
func aculCmd(cli *cli) *cobra.Command {
1212
cmd := &cobra.Command{
1313
Use: "acul",
14-
Short: "Advance Customize the Universal Login experience",
14+
Short: "Advanced Customization the Universal Login experience",
1515
Long: `Customize the Universal Login experience. This requires a custom domain to be configured for the tenant.`,
1616
}
1717

internal/cli/acul_app_scaffolding.go

Lines changed: 13 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -236,6 +236,7 @@ func runScaffold(cli *cli, cmd *cobra.Command, args []string, inputs *struct {
236236
runNpmGenerateScreenLoader(cli, destDir)
237237

238238
if prompt.Confirm("Would you like to proceed with installing the required dependencies using 'npm install'?") {
239+
fmt.Println(ansi.Cyan("Installing Dependencies... This may take a little while."))
239240
runNpmInstall(cli, destDir)
240241
}
241242

@@ -395,8 +396,7 @@ func copyTemplateBaseDirs(cli *cli, baseDirs []string, chosenTemplate, tempUnzip
395396
destPath := filepath.Join(destDir, dirPath)
396397

397398
if _, err := os.Stat(srcPath); os.IsNotExist(err) {
398-
cli.renderer.Warnf("%s Source directory does not exist: %s",
399-
ansi.Bold(ansi.Yellow("⚠️")), ansi.Faint(srcPath))
399+
cli.renderer.Warnf("⚠️ Source directory does not exist: %s", ansi.Faint(srcPath))
400400
continue
401401
}
402402

@@ -421,15 +421,13 @@ func copyProjectTemplateFiles(cli *cli, baseFiles []string, chosenTemplate, temp
421421
destPath := filepath.Join(destDir, filePath)
422422

423423
if _, err := os.Stat(srcPath); os.IsNotExist(err) {
424-
cli.renderer.Warnf("%s Source file does not exist: %s",
425-
ansi.Bold(ansi.Yellow("⚠️")), ansi.Faint(srcPath))
424+
cli.renderer.Warnf("⚠️ Source file does not exist: %s", ansi.Faint(srcPath))
426425
continue
427426
}
428427

429428
parentDir := filepath.Dir(destPath)
430429
if err := os.MkdirAll(parentDir, 0755); err != nil {
431-
cli.renderer.Warnf("%s Error creating parent directory for %s: %v",
432-
ansi.Bold(ansi.Red("❌")), ansi.Bold(filePath), err)
430+
cli.renderer.Warnf("❌ Error creating parent directory for %s: %v", ansi.Bold(filePath), err)
433431
continue
434432
}
435433

@@ -463,8 +461,7 @@ func copyProjectScreens(cli *cli, screens []Screens, selectedScreens []string, c
463461

464462
parentDir := filepath.Dir(destPath)
465463
if err := os.MkdirAll(parentDir, 0755); err != nil {
466-
cli.renderer.Warnf("%s Error creating parent directory for %s: %v",
467-
ansi.Bold(ansi.Red("❌")), ansi.Bold(screen.Path), err)
464+
cli.renderer.Warnf("❌ Error creating parent directory for %s: %v", ansi.Bold(screen.Path), err)
468465
continue
469466
}
470467

@@ -596,8 +593,7 @@ func createScreenMap(screens []Screens) map[string]Screens {
596593
// success message, documentation, Node version check, next steps, and available commands.
597594
func showPostScaffoldingOutput(cli *cli, destDir, successMessage string) {
598595
cli.renderer.Output("")
599-
cli.renderer.Infof("🎉 %s in %s!",
600-
successMessage, ansi.Bold(ansi.Cyan(fmt.Sprintf("'%s'", destDir))))
596+
cli.renderer.Infof("🎉 %s in %s!", successMessage, ansi.Bold(ansi.Cyan(fmt.Sprintf("'%s'", destDir))))
601597
cli.renderer.Output("")
602598

603599
cli.renderer.Infof("📖 Explore the sample app: %s",
@@ -620,20 +616,13 @@ func printAvailableCommands() {
620616
fmt.Println(ansi.Bold("📋 Available Commands:"))
621617
fmt.Println()
622618

623-
fmt.Printf(" %s - Add authentication screens\n",
624-
ansi.Bold(ansi.Green("auth0 acul screen add <screen-name>")))
625-
fmt.Printf(" %s - Local development with hot-reload\n",
626-
ansi.Bold(ansi.Green("auth0 acul dev")))
627-
fmt.Printf(" %s - Live sync changes to Auth0 tenant\n",
628-
ansi.Bold(ansi.Green("auth0 acul dev --connected")))
629-
fmt.Printf(" %s - Create starter config template\n",
630-
ansi.Bold(ansi.Green("auth0 acul config generate <screen>")))
631-
fmt.Printf(" %s - Pull current Auth0 settings\n",
632-
ansi.Bold(ansi.Green("auth0 acul config get <screen>")))
633-
fmt.Printf(" %s - Push local config to Auth0\n",
634-
ansi.Bold(ansi.Green("auth0 acul config set <screen>")))
635-
fmt.Printf(" %s - List all configurable screens\n",
636-
ansi.Bold(ansi.Green("auth0 acul config list")))
619+
fmt.Printf(" %s - Add authentication screens\n", ansi.Bold(ansi.Green("auth0 acul screen add <screen-name>")))
620+
fmt.Printf(" %s - Local development with hot-reload\n", ansi.Bold(ansi.Green("auth0 acul dev")))
621+
fmt.Printf(" %s - Live sync changes to Auth0 tenant\n", ansi.Bold(ansi.Green("auth0 acul dev --connected")))
622+
fmt.Printf(" %s - Create starter config template\n", ansi.Bold(ansi.Green("auth0 acul config generate <screen>")))
623+
fmt.Printf(" %s - Pull current Auth0 settings\n", ansi.Bold(ansi.Green("auth0 acul config get <screen>")))
624+
fmt.Printf(" %s - Push local config to Auth0\n", ansi.Bold(ansi.Green("auth0 acul config set <screen>")))
625+
fmt.Printf(" %s - List all configurable screens\n", ansi.Bold(ansi.Green("auth0 acul config list")))
637626

638627
fmt.Println()
639628
fmt.Printf("%s Use %s to see all available commands\n",

internal/cli/universal_login.go

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ func universalLoginCmd(cli *cli) *cobra.Command {
6161
� DEPRECATION WARNING: Advanced Customizations (ACUL) have moved!
6262
6363
The 'auth0 ul customize --rendering-mode advanced' functionality will be
64-
DEPRECATED on April 18, 2026. Please migrate to the new ACUL commands:
64+
DEPRECATED on June 15, 2026. Please migrate to the new ACUL commands:
6565
6666
✅ auth0 acul config generate|get|set|list|docs
6767

internal/cli/universal_login_customize.go

Lines changed: 21 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,22 @@ var (
7070
Help: "Name of the prompt to to switch or customize.",
7171
IsRequired: true,
7272
}
73+
74+
screenNameFlag = Flag{
75+
Name: "Screen Name",
76+
LongForm: "screen",
77+
ShortForm: "s",
78+
Help: "Name of the screen to to switch or customize.",
79+
IsRequired: true,
80+
}
81+
82+
fileFlag = Flag{
83+
Name: "File",
84+
LongForm: "settings-file",
85+
ShortForm: "f",
86+
Help: "File to save the rendering configs to.",
87+
IsRequired: false,
88+
}
7389
)
7490

7591
var allowedPromptsWithPartials = []management.PromptType{
@@ -323,8 +339,8 @@ func customizeUniversalLoginCmd(cli *cli) *cobra.Command {
323339

324340
renderingMode.RegisterString(cmd, &selectedRenderingMode, "")
325341
promptName.RegisterString(cmd, &input.promptName, "")
326-
screenName.RegisterString(cmd, &input.screenName, "")
327-
file.RegisterString(cmd, &input.filePath, "")
342+
screenNameFlag.RegisterString(cmd, &input.screenName, "")
343+
fileFlag.RegisterString(cmd, &input.filePath, "")
328344

329345
return cmd
330346
}
@@ -1039,9 +1055,9 @@ func switchUniversalLoginRendererModeCmd(cli *cli) *cobra.Command {
10391055
Short: "⚠️ Switch rendering mode (DEPRECATED)",
10401056
Long: `Switch the rendering mode for Universal Login. Note that this requires a custom domain to be configured for the tenant.
10411057
1042-
🚨 DEPRECATION WARNING: The 'auth0 ul switch' command will be DEPRECATED on April 30, 2026
1058+
🚨 DEPRECATION WARNING: The 'auth0 ul switch' command will be DEPRECATED on June 15, 2026
10431059
1044-
✅ For Advanced Customizations, migrate to the new ACUL config commands:
1060+
✅ For Advanced Customizations, Use new ACUL config commands:
10451061
• auth0 acul config generate <screen>
10461062
• auth0 acul config get <screen>
10471063
• auth0 acul config set <screen>
@@ -1089,7 +1105,7 @@ func switchUniversalLoginRendererModeCmd(cli *cli) *cobra.Command {
10891105
}
10901106

10911107
promptName.RegisterString(cmd, &input.promptName, "")
1092-
screenName.RegisterString(cmd, &input.screenName, "")
1108+
screenNameFlag.RegisterString(cmd, &input.screenName, "")
10931109
renderingMode.RegisterString(cmd, &selectedRenderingMode, "")
10941110

10951111
return cmd

0 commit comments

Comments
 (0)