Add setup command for Auth0 quickstart applications (#1428)

* feat(quickstart): add setup command for Auth0 quickstart applications

* add documentation for quickstarts setup and fix lint

* enhance setup command with input validation and user prompts

Author: ramya18101

docs/auth0_quickstarts.md

@@ -11,4 +11,5 @@ Step-by-step guides to quickly integrate Auth0 into your application.
 
 - [auth0 quickstarts download](auth0_quickstarts_download.md) - Download a Quickstart sample app for a specific tech stack
 - [auth0 quickstarts list](auth0_quickstarts_list.md) - List the available Quickstarts
+- [auth0 quickstarts setup](auth0_quickstarts_setup.md) - Set up Auth0 for your quickstart application
 

docs/auth0_quickstarts_download.md

@@ -46,5 +46,6 @@ auth0 quickstarts download [flags]
 
 - [auth0 quickstarts download](auth0_quickstarts_download.md) - Download a Quickstart sample app for a specific tech stack
 - [auth0 quickstarts list](auth0_quickstarts_list.md) - List the available Quickstarts
+- [auth0 quickstarts setup](auth0_quickstarts_setup.md) - Set up Auth0 for your quickstart application
 
 

docs/auth0_quickstarts_list.md

@@ -48,5 +48,6 @@ auth0 quickstarts list [flags]
 
 - [auth0 quickstarts download](auth0_quickstarts_download.md) - Download a Quickstart sample app for a specific tech stack
 - [auth0 quickstarts list](auth0_quickstarts_list.md) - List the available Quickstarts
+- [auth0 quickstarts setup](auth0_quickstarts_setup.md) - Set up Auth0 for your quickstart application
 
 

docs/auth0_quickstarts_setup.md

@@ -0,0 +1,61 @@
+---
+layout: default
+parent: auth0 quickstarts
+has_toc: false
+---
+# auth0 quickstarts setup
+
+Creates an Auth0 application and generates a .env file with the necessary configuration.
+
+The command will:
+  1. Check if you are authenticated (and prompt for login if needed)
+  2. Create an Auth0 application based on the specified type
+  3. Generate a .env file with the appropriate environment variables
+
+Supported types:
+  - vite: For client-side SPAs (React, Vue, Svelte, etc.)
+  - nextjs: For Next.js server-side applications
+
+## Usage
+```
+auth0 quickstarts setup [flags]
+```
+
+## Examples
+
+```
+  auth0 quickstarts setup --type vite
+  auth0 quickstarts setup --type nextjs
+  auth0 quickstarts setup --type vite --name "My App"
+  auth0 quickstarts setup --type nextjs --port 8080
+  auth0 qs setup --type vite -n "My App" -p 5173
+```
+
+
+## Flags
+
+```
+      --json          Output in json format.
+  -n, --name string   Name of the Auth0 application (defaults to current directory name)
+  -p, --port int      Port number for the application (default: 5173 for vite, 3000 for nextjs)
+  -t, --type string   Type of quickstart (vite, nextjs)
+```
+
+
+## Inherited Flags
+
+```
+      --debug           Enable debug mode.
+      --no-color        Disable colors.
+      --no-input        Disable interactivity.
+      --tenant string   Specific tenant to use.
+```
+
+
+## Related Commands
+
+- [auth0 quickstarts download](auth0_quickstarts_download.md) - Download a Quickstart sample app for a specific tech stack
+- [auth0 quickstarts list](auth0_quickstarts_list.md) - List the available Quickstarts
+- [auth0 quickstarts setup](auth0_quickstarts_setup.md) - Set up Auth0 for your quickstart application
+
+

internal/cli/quickstarts.go

@@ -66,6 +66,7 @@ func quickstartsCmd(cli *cli) *cobra.Command {
 
 	cmd.AddCommand(listQuickstartsCmd(cli))
 	cmd.AddCommand(downloadQuickstartCmd(cli))
+	cmd.AddCommand(setupQuickstartCmd(cli))
 
 	return cmd
 }
@@ -413,3 +414,197 @@ func (i *qsInputs) fromArgs(cmd *cobra.Command, args []string, cli *cli) error {
 
 	return nil
 }
+
+var (
+	qsType = Flag{
+		Name:       "Type",
+		LongForm:   "type",
+		ShortForm:  "t",
+		Help:       "Type of quickstart (vite, nextjs)",
+		IsRequired: true,
+	}
+	qsAppName = Flag{
+		Name:      "Name",
+		LongForm:  "name",
+		ShortForm: "n",
+		Help:      "Name of the Auth0 application (defaults to current directory name)",
+	}
+	qsPort = Flag{
+		Name:      "Port",
+		LongForm:  "port",
+		ShortForm: "p",
+		Help:      "Port number for the application (default: 5173 for vite, 3000 for nextjs)",
+	}
+)
+
+func setupQuickstartCmd(cli *cli) *cobra.Command {
+	var inputs struct {
+		Type string
+		Name string
+		Port int
+	}
+
+	cmd := &cobra.Command{
+		Use:   "setup",
+		Args:  cobra.NoArgs,
+		Short: "Set up Auth0 for your quickstart application",
+		Long: "Creates an Auth0 application and generates a .env file with the necessary configuration.\n\n" +
+			"The command will:\n" +
+			"  1. Check if you are authenticated (and prompt for login if needed)\n" +
+			"  2. Create an Auth0 application based on the specified type\n" +
+			"  3. Generate a .env file with the appropriate environment variables\n\n" +
+			"Supported types:\n" +
+			"  - vite: For client-side SPAs (React, Vue, Svelte, etc.)\n" +
+			"  - nextjs: For Next.js server-side applications",
+		Example: `  auth0 quickstarts setup --type vite
+  auth0 quickstarts setup --type nextjs
+  auth0 quickstarts setup --type vite --name "My App"
+  auth0 quickstarts setup --type nextjs --port 8080
+  auth0 qs setup --type vite -n "My App" -p 5173`,
+		RunE: func(cmd *cobra.Command, args []string) error {
+			ctx := cmd.Context()
+
+			normalizedType := strings.ToLower(inputs.Type)
+			if normalizedType != "vite" && normalizedType != "nextjs" {
+				return fmt.Errorf("unsupported quickstart type: %s (supported types: vite, nextjs)", inputs.Type)
+			}
+
+			if err := qsType.Select(cmd, &inputs.Type, []string{"vite (React, Svelte, Vue, Vanilla JS)", "nextjs"}, nil); err != nil {
+				return err
+			}
+
+			if err := cli.setupWithAuthentication(ctx); err != nil {
+				return fmt.Errorf("authentication required: %w", err)
+			}
+
+			defaultName := "My App"
+
+			if err := qsAppName.Ask(cmd, &inputs.Name, &defaultName); err != nil {
+				return err
+			}
+
+			var appType, baseURL, envFileName string
+			var callbacks, logoutURLs, origins, webOrigins []string
+			var defaultPort int
+
+			switch inputs.Type {
+			case "vite":
+				appType = appTypeSPA
+				defaultPort = 5173
+				envFileName = ".env"
+
+			case "nextjs":
+				appType = appTypeRegularWeb
+				defaultPort = 3000
+				envFileName = ".env.local"
+			}
+
+			if inputs.Port == 0 {
+				inputs.Port = defaultPort
+			}
+
+			if inputs.Port < 1024 || inputs.Port > 65535 {
+				return fmt.Errorf("invalid port number: %d (must be between 1024 and 65535)", inputs.Port)
+			}
+
+			baseURL = fmt.Sprintf("http://localhost:%d", inputs.Port)
+
+			// Configure URLs based on app type.
+			if inputs.Type == "vite" {
+				callbacks = []string{baseURL}
+				logoutURLs = []string{baseURL}
+				origins = []string{baseURL}
+				webOrigins = []string{baseURL}
+			} else {
+				callbackURL := fmt.Sprintf("%s/auth/callback", baseURL)
+				callbacks = []string{callbackURL}
+				logoutURLs = []string{baseURL}
+			}
+
+			cli.renderer.Infof("Creating Auth0 application '%s'...", inputs.Name)
+
+			oidcConformant := true
+			algorithm := "RS256"
+			metadata := map[string]interface{}{
+				"created_by": "quickstart-docs-manual-cli",
+			}
+
+			a := &management.Client{
+				Name:              &inputs.Name,
+				AppType:           &appType,
+				Callbacks:         &callbacks,
+				AllowedLogoutURLs: &logoutURLs,
+				OIDCConformant:    &oidcConformant,
+				JWTConfiguration: &management.ClientJWTConfiguration{
+					Algorithm: &algorithm,
+				},
+				ClientMetadata: &metadata,
+			}
+
+			if inputs.Type == "vite" {
+				a.AllowedOrigins = &origins
+				a.WebOrigins = &webOrigins
+			}
+
+			if err := ansi.Waiting(func() error {
+				return cli.api.Client.Create(ctx, a)
+			}); err != nil {
+				return fmt.Errorf("failed to create application: %w", err)
+			}
+
+			cli.renderer.Infof("Application created successfully with Client ID: %s", a.GetClientID())
+
+			tenant, err := cli.Config.GetTenant(cli.tenant)
+			if err != nil {
+				return fmt.Errorf("failed to get tenant: %w", err)
+			}
+
+			var envContent strings.Builder
+
+			switch inputs.Type {
+			case "vite":
+				envContent.WriteString(fmt.Sprintf("VITE_AUTH0_DOMAIN=%s\n", tenant.Domain))
+				envContent.WriteString(fmt.Sprintf("VITE_AUTH0_CLIENT_ID=%s\n", a.GetClientID()))
+
+			case "nextjs":
+				secret, err := generateState(32)
+				if err != nil {
+					return fmt.Errorf("failed to generate AUTH0_SECRET: %w", err)
+				}
+
+				envContent.WriteString(fmt.Sprintf("AUTH0_DOMAIN=%s\n", tenant.Domain))
+				envContent.WriteString(fmt.Sprintf("AUTH0_CLIENT_ID=%s\n", a.GetClientID()))
+				envContent.WriteString(fmt.Sprintf("AUTH0_CLIENT_SECRET=%s\n", a.GetClientSecret()))
+				envContent.WriteString(fmt.Sprintf("AUTH0_SECRET=%s\n", secret))
+				envContent.WriteString(fmt.Sprintf("APP_BASE_URL=%s\n", baseURL))
+			}
+
+			message := fmt.Sprintf("Proceed to overwrite '%s' file? : ", envFileName)
+			if shouldCancelOverwrite(cli, cmd, envFileName, message) {
+				cli.renderer.Warnf("Aborted creating %s file. Please create it manually using the following content:\n\n"+
+					"─────────────────────────────────────────────────────────────\n"+"%s"+
+					"─────────────────────────────────────────────────────────────\n", envFileName, envContent.String())
+			} else {
+				if err = os.WriteFile(envFileName, []byte(envContent.String()), 0600); err != nil {
+					return fmt.Errorf("failed to write .env file: %w", err)
+				}
+
+				cli.renderer.Infof("%s file created successfully with your Auth0 configuration\n", envFileName)
+			}
+
+			cli.renderer.Infof("Next steps: \n"+
+				"       1. Install dependencies: npm install \n"+
+				"       2. Start your application: npm run dev\n"+
+				"       3. Open your browser at %s", baseURL)
+
+			return nil
+		},
+	}
+
+	cmd.Flags().BoolVar(&cli.json, "json", false, "Output in json format.")
+	qsType.RegisterString(cmd, &inputs.Type, "")
+	qsAppName.RegisterString(cmd, &inputs.Name, "")
+	qsPort.RegisterInt(cmd, &inputs.Port, 0)
+
+	return cmd
+}