apps init: show template ref in header and clone spinner

Drops the standalone "Using AppKit template version X" line. The
resolved ref (e.g. "version 0.24.0" or "branch feature-x") now appears
on the interactive header before the name prompt and as a suffix on
the clone spinner so the user can cancel before naming the project.

Author: calvarjorge

cmd/apps/init.go

@@ -548,7 +548,7 @@ func cloneRepo(ctx context.Context, repoURL, branch string) (string, error) {
 // Used by commands that don't benefit from background cloning (e.g., manifest).
 func resolveTemplate(ctx context.Context, templatePath, branch, subdir string) (string, func(), error) {
 	ch := resolveTemplateAsync(ctx, templatePath, branch, subdir)
-	return awaitTemplate(ctx, ch)
+	return awaitTemplate(ctx, ch, "")
 }
 
 // templateResult holds the outcome of a background template resolution.
@@ -599,18 +599,24 @@ func resolveTemplateAsync(ctx context.Context, templatePath, branch, subdir stri
 // awaitTemplate waits for the background clone to finish.
 // If the result is already available it returns immediately with a
 // checkmark; otherwise it shows a spinner while waiting.
-func awaitTemplate(ctx context.Context, ch <-chan templateResult) (string, func(), error) {
+// refLabel, if non-empty (e.g. "version 0.24.0" or "branch feature-x"),
+// is appended to spinner and done messages.
+func awaitTemplate(ctx context.Context, ch <-chan templateResult, refLabel string) (string, func(), error) {
+	suffix := ""
+	if refLabel != "" {
+		suffix = " (" + refLabel + ")"
+	}
 	select {
 	case res := <-ch:
 		// Clone finished while the user was typing — print completion.
 		if res.err == nil && res.cleanup != nil {
-			prompt.PrintDone(ctx, "Template cloned")
+			prompt.PrintDone(ctx, "Template cloned"+suffix)
 		}
 		return res.path, res.cleanup, res.err
 	default:
 		// Still cloning — show a spinner for the remaining wait.
 		var res templateResult
-		err := prompt.RunWithSpinnerCtx(ctx, "Cloning template...", func() error {
+		err := prompt.RunWithSpinnerCtx(ctx, "Cloning template"+suffix+"...", func() error {
 			res = <-ch
 			return res.err
 		})
@@ -794,25 +800,36 @@ func runCreate(ctx context.Context, opts createOptions) error {
 		templateSrc = env.Get(ctx, templatePathEnvVar)
 	}
 
-	// Resolve the git reference (branch/tag) to use for default appkit template
+	// Resolve the git reference (branch/tag) to use for default appkit template.
+	// refLabel is a human-readable description of the ref we're cloning
+	// (e.g. "version 0.24.0", "branch feature-x"). It's surfaced in the
+	// interactive header and the clone spinner so the user can cancel before
+	// naming the project. Empty when there's nothing meaningful to show
+	// (e.g. a custom --template URL with no explicit branch).
 	gitRef := opts.branch
+	var refLabel string
 	usingDefaultTemplate := templateSrc == ""
 	if usingDefaultTemplate {
 		// Using default appkit template - resolve version
 		switch {
 		case opts.branch != "":
 			// --branch takes precedence (already set in gitRef)
+			refLabel = "branch " + opts.branch
 		case opts.version != "":
 			gitRef = normalizeVersion(opts.version)
+			refLabel = "version " + opts.version
 		default:
-			appkitVersion, err := clicompat.ResolveAppKitVersion(ctx)
+			resolved, err := clicompat.ResolveAppKitVersion(ctx)
 			if err != nil {
 				return fmt.Errorf("could not resolve AppKit template version: %w; use --version to specify a version manually", err)
 			}
-			gitRef = normalizeVersion(appkitVersion)
-			cmdio.LogString(ctx, "Using AppKit template version "+appkitVersion)
+			gitRef = normalizeVersion(resolved)
+			refLabel = "version " + resolved
 		}
 		templateSrc = appkitRepoURL
+	} else if opts.branch != "" {
+		// Custom template with an explicit branch — show it for traceability.
+		refLabel = "branch " + opts.branch
 	}
 
 	// Start cloning in the background so it runs while the user types the name.
@@ -843,7 +860,7 @@ func runCreate(ctx context.Context, opts createOptions) error {
 		if !isInteractive {
 			return errors.New("--name is required in non-interactive mode")
 		}
-		name, err := prompt.PromptForProjectName(ctx, opts.outputDir)
+		name, err := prompt.PromptForProjectName(ctx, opts.outputDir, refLabel)
 		if err != nil {
 			return err
 		}
@@ -862,7 +879,7 @@ func runCreate(ctx context.Context, opts createOptions) error {
 	}
 
 	// Step 2: Wait for template (may already be done if the user took time typing the name)
-	resolvedPath, cleanup, err := awaitTemplate(ctx, templateCh)
+	resolvedPath, cleanup, err := awaitTemplate(ctx, templateCh, refLabel)
 	// Only fall back to the embedded version when the version was auto-resolved
 	// from the manifest, not when the user explicitly passed --version or --branch.
 	versionAutoResolved := opts.version == "" && opts.branch == ""
@@ -872,7 +889,8 @@ func runCreate(ctx context.Context, opts createOptions) error {
 			log.Warnf(ctx, "Template version not found, falling back to embedded version %s", fallbackVersion)
 			fallbackRef := normalizeVersion(fallbackVersion)
 			templateCh = resolveTemplateAsync(ctx, templateSrc, fallbackRef, appkitTemplateDir)
-			resolvedPath, cleanup, err = awaitTemplate(ctx, templateCh)
+			refLabel = "version " + fallbackVersion
+			resolvedPath, cleanup, err = awaitTemplate(ctx, templateCh, refLabel)
 		} else if fbErr != nil {
 			log.Warnf(ctx, "Could not resolve embedded AppKit version: %v", fbErr)
 		}

libs/apps/prompt/prompt.go

@@ -155,7 +155,10 @@ func ValidateProjectName(s string) error {
 }
 
 // PrintHeader prints the AppKit header banner.
-func PrintHeader(ctx context.Context) {
+// If refLabel is non-empty (e.g. "version 0.24.0" or "branch feature-x"),
+// an extra dimmed line shows the resolved template ref so the user can
+// decide whether to continue before naming the project.
+func PrintHeader(ctx context.Context, refLabel string) {
 	headerStyle := lipgloss.NewStyle().
 		Foreground(colorRed).
 		Bold(true)
@@ -166,14 +169,18 @@ func PrintHeader(ctx context.Context) {
 	cmdio.LogString(ctx, "")
 	cmdio.LogString(ctx, headerStyle.Render("◆ Create a new Databricks AppKit project"))
 	cmdio.LogString(ctx, subtitleStyle.Render("  Full-stack TypeScript • React • Tailwind CSS"))
+	if refLabel != "" {
+		cmdio.LogString(ctx, subtitleStyle.Render("  Template "+refLabel))
+	}
 	cmdio.LogString(ctx, "")
 }
 
 // PromptForProjectName prompts only for project name.
 // Used as the first step before resolving templates.
 // outputDir is used to check if the destination directory already exists.
-func PromptForProjectName(ctx context.Context, outputDir string) (string, error) {
-	PrintHeader(ctx)
+// refLabel, if non-empty, is shown in the header so the user can cancel before naming.
+func PromptForProjectName(ctx context.Context, outputDir, refLabel string) (string, error) {
+	PrintHeader(ctx, refLabel)
 	theme := AppkitTheme()
 
 	var name string