feat: add universal-portals setup command (Beta)

docs/auth0_universal-portals.md

@@ -0,0 +1,13 @@
+---
+layout: default
+has_toc: false
+has_children: true
+---
+# auth0 universal-portals
+
+Manage Auth0 Universal Portals resources.
+
+## Commands
+
+- [auth0 universal-portals setup](auth0_universal-portals_setup.md) - Set up Auth0 resources for a Universal Portals application
+

docs/auth0_universal-portals_setup.md

@@ -0,0 +1,50 @@
+---
+layout: default
+parent: auth0 universal-portals
+has_toc: false
+---
+# auth0 universal-portals setup
+
+Provisions the Auth0 resources required by a Universal Portals application:
+
+  - Auth0 My Account API and My Organization API (resource servers)
+  - A Regular Web App client with the required configuration
+  - Client grants for My Account API, My Organization API, and the Management API
+
+## Usage
+```
+auth0 universal-portals setup [flags]
+```
+
+## Examples
+
+```
+  auth0 universal-portals setup
+  auth0 universal-portals setup --name "Acme" --slug "acme"
+  auth0 up setup -n "Acme" -s "acme"
+```
+
+
+## Flags
+
+```
+  -n, --name string   Display name of the portal.
+  -s, --slug string   URL-friendly identifier for the portal (e.g. my-portal).
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 universal-portals setup](auth0_universal-portals_setup.md) - Set up Auth0 resources for a Universal Portals application
+
+

docs/index.md

@@ -105,5 +105,6 @@ Authenticating as a user is not supported for **private cloud** tenants. Instead
 - [auth0 test](auth0_test.md) - Try your Universal Login box or get a token
 - [auth0 token-exchange](auth0_token-exchange.md) - Manage token exchange profiles
 - [auth0 universal-login](auth0_universal-login.md) - Manage the Universal Login experience
+- [auth0 universal-portals](auth0_universal-portals.md) - Manage Universal Portals resources
 - [auth0 users](auth0_users.md) - Manage resources for users
 

internal/ansi/ansi.go

@@ -71,6 +71,13 @@ func URL(text string) string {
 	return color.Sprintf(color.Underline(text))
 }
 
+// Hyperlink wraps text in an OSC8 terminal hyperlink.
+// Terminals that support OSC8 (iTerm2, Warp, GNOME Terminal, etc.) render the
+// text as an underlined, clickable link. Unsupported terminals show plain text.
+func Hyperlink(url, text string) string {
+	return "\x1b]8;;" + url + "\x1b\\" + text + "\x1b]8;;\x1b\\"
+}
+
 // Red returns text colored red.
 func Red(text string) string {
 	return color.Sprintf(color.Red(text))

internal/cli/root.go

@@ -190,6 +190,7 @@ func addSubCommands(rootCmd *cobra.Command, cli *cli) {
 	rootCmd.AddCommand(terraformCmd(cli))
 	rootCmd.AddCommand(eventStreamsCmd(cli))
 	rootCmd.AddCommand(experimentationCmd(cli))
+	rootCmd.AddCommand(universalPortalsCmd(cli))
 	rootCmd.AddCommand(networkACLCmd(cli))
 	rootCmd.AddCommand(tenantSettingsCmd(cli))
 	rootCmd.AddCommand(tokenExchangeCmd(cli))