refactor(experiment): separate huh and lipgloss changes of charm (#411)

Author: zimeg

cmd/help/help.go

@@ -35,7 +35,7 @@ func HelpFunc(
 		if help, _ := clients.Config.Flags.GetBool("help"); help {
 			clients.Config.LoadExperiments(ctx, clients.IO.PrintDebug)
 		}
-		style.ToggleCharm(clients.Config.WithExperimentOn(experiment.Charm))
+		style.ToggleLipgloss(clients.Config.WithExperimentOn(experiment.Lipgloss))
 		experiments := []string{}
 		for _, exp := range clients.Config.GetExperiments() {
 			if experiment.Includes(exp) {
@@ -68,7 +68,7 @@ func PrintHelpTemplate(cmd *cobra.Command, data style.TemplateData) {
 	}
 	cmd.Long = cmdLongF.String()
 	tmpl := legacyHelpTemplate
-	if style.IsCharmEnabled() {
+	if style.IsLipglossEnabled() {
 		tmpl = charmHelpTemplate
 	}
 	err = style.PrintTemplate(cmd.OutOrStdout(), tmpl, templateInfo{cmd, data})
@@ -121,7 +121,7 @@ const charmHelpTemplate string = `{{.Long | ToDescription}}
 // ════════════════════════════════════════════════════════════════════════════════
 // DEPRECATED: Legacy help template — aurora styling
 //
-// Delete this entire block when the charm experiment is permanently enabled.
+// Delete this entire block when the lipgloss experiment is permanently enabled.
 // ════════════════════════════════════════════════════════════════════════════════
 
 const legacyHelpTemplate string = `{{.Long}}

cmd/project/create_samples.go

@@ -67,7 +67,7 @@ func promptSampleSelection(ctx context.Context, clients *shared.ClientFactory, s
 	sortedRepos := sortRepos(filteredRepos)
 	selectOptions := make([]string, len(sortedRepos))
 	for i, r := range sortedRepos {
-		if !clients.Config.WithExperimentOn(experiment.Charm) {
+		if !clients.Config.WithExperimentOn(experiment.Huh) {
 			selectOptions[i] = fmt.Sprint(i+1, ". ", r.Name)
 		} else {
 			selectOptions[i] = r.Name
@@ -78,7 +78,7 @@ func promptSampleSelection(ctx context.Context, clients *shared.ClientFactory, s
 	selection, err = clients.IO.SelectPrompt(ctx, "Select a sample to build upon:", selectOptions, iostreams.SelectPromptConfig{
 		Description: func(value string, index int) string {
 			desc := sortedRepos[index].Description
-			if !clients.Config.WithExperimentOn(experiment.Charm) {
+			if !clients.Config.WithExperimentOn(experiment.Huh) {
 				desc += "\n  https://github.com/" + sortedRepos[index].FullName
 			}
 			return desc

cmd/root.go

@@ -295,7 +295,7 @@ func InitConfig(ctx context.Context, clients *shared.ClientFactory, rootCmd *cob
 
 	// Init configurations
 	clients.Config.LoadExperiments(ctx, clients.IO.PrintDebug)
-	style.ToggleCharm(clients.Config.WithExperimentOn(experiment.Charm))
+	style.ToggleLipgloss(clients.Config.WithExperimentOn(experiment.Lipgloss))
 	// TODO(slackcontext) Consolidate storing CLI version to slackcontext
 	clients.Config.Version = clients.CLIVersion
 

docs/reference/experiments.md

@@ -6,13 +6,15 @@ The Slack CLI has an experiment (`-e`) flag behind which we put features current
 
 The following is a list of currently available experiments. We'll remove experiments from this page if we decide they are no longer needed or once they are released, in which case we'll make an announcement about the feature's general availability in the [developer changelog](https://docs.slack.dev/changelog).
 
-- `charm`: shows beautiful prompts ([PR#348](https://github.com/slackapi/slack-cli/pull/348)).
+- `huh`: shows beautiful prompts.
+- `lipgloss`: shows pretty styles.
 - `sandboxes`: enables users who have joined the Slack Developer Program to manage their sandboxes ([PR#379](https://github.com/slackapi/slack-cli/pull/379)).
 
 ## Experiments changelog
 
 Below is a list of updates related to experiments.
 
+- **March 2026**: Split the `charm` experiment into more beautiful `huh` prompts and prettier `lipgloss` styles for ongoing change.
 - **March 2026**: Concluded the `bolt` and `bolt-install` experiments with full Bolt framework support now enabled by default in the Slack CLI. All Bolt project features including remote manifest management are now standard functionality. See the announcement [here](https://slack.dev/slackcli-supports-bolt-apps/).
 - **February 2026**: Added the `charm` experiment.
 - **December 2025**: Concluded the `read-only-collaborators` experiment with full support introduced to the Slack CLI. See the changelog announcement [here](https://docs.slack.dev/changelog/2025/12/04/slack-cli).

internal/experiment/experiment.go

@@ -30,20 +30,24 @@ type Experiment string
 // e.g. --experiment=first-toggle,second-toggle
 
 const (
-	// Charm experiment enables beautiful prompts.
-	Charm Experiment = "charm"
+	// Huh experiment shows beautiful prompts.
+	Huh Experiment = "huh"
 
-	// Sandboxes experiment lets users who have joined the Slack Developer Program use the CLI to manage their sandboxes.
-	Sandboxes Experiment = "sandboxes"
+	// Lipgloss experiment shows pretty styles.
+	Lipgloss Experiment = "lipgloss"
 
 	// Placeholder experiment is a placeholder for testing and does nothing... or does it?
 	Placeholder Experiment = "placeholder"
+
+	// Sandboxes experiment lets users who have joined the Slack Developer Program use the CLI to manage their sandboxes.
+	Sandboxes Experiment = "sandboxes"
 )
 
 // AllExperiments is a list of all available experiments that can be enabled
 // Please also add here 👇
 var AllExperiments = []Experiment{
-	Charm,
+	Huh,
+	Lipgloss,
 	Placeholder,
 	Sandboxes,
 }

internal/experiment/experiment_test.go

@@ -25,7 +25,8 @@ func Test_Includes(t *testing.T) {
 	require.Equal(t, true, Includes(Experiment(Placeholder)))
 
 	// Test expected experiments
-	require.Equal(t, true, Includes(Experiment("charm")))
+	require.Equal(t, true, Includes(Experiment("huh")))
+	require.Equal(t, true, Includes(Experiment("lipgloss")))
 
 	// Test invalid experiment
 	require.Equal(t, false, Includes(Experiment("should-fail")))

internal/iostreams/charm.go

@@ -14,21 +14,31 @@
 
 package iostreams
 
-// Charm-based prompt implementations using the huh library
-// These are used when the "charm" experiment is enabled
+// Charm-based prompt implementations using the huh library.
+// These are used when the "huh" experiment is enabled.
 
 import (
 	"context"
 	"errors"
 	"slices"
 
 	huh "charm.land/huh/v2"
+	"github.com/slackapi/slack-cli/internal/experiment"
 	"github.com/slackapi/slack-cli/internal/slackerror"
 	"github.com/slackapi/slack-cli/internal/style"
 )
 
+// newForm wraps a field in a huh form, applying the Slack theme when the lipgloss experiment is enabled.
+func newForm(io *IOStreams, field huh.Field) *huh.Form {
+	form := huh.NewForm(huh.NewGroup(field))
+	if io != nil && io.config.WithExperimentOn(experiment.Lipgloss) {
+		form = form.WithTheme(style.ThemeSlack())
+	}
+	return form
+}
+
 // buildInputForm constructs a huh form for text input prompts.
-func buildInputForm(message string, cfg InputPromptConfig, input *string) *huh.Form {
+func buildInputForm(io *IOStreams, message string, cfg InputPromptConfig, input *string) *huh.Form {
 	field := huh.NewInput().
 		Title(message).
 		Prompt(style.Chevron() + " ").
@@ -37,13 +47,13 @@ func buildInputForm(message string, cfg InputPromptConfig, input *string) *huh.F
 	if cfg.Required {
 		field.Validate(huh.ValidateMinLength(1))
 	}
-	return huh.NewForm(huh.NewGroup(field)).WithTheme(style.ThemeSlack())
+	return newForm(io, field)
 }
 
 // charmInputPrompt prompts for text input using a charm huh form
-func charmInputPrompt(_ *IOStreams, _ context.Context, message string, cfg InputPromptConfig) (string, error) {
+func charmInputPrompt(io *IOStreams, _ context.Context, message string, cfg InputPromptConfig) (string, error) {
 	var input string
-	err := buildInputForm(message, cfg, &input).Run()
+	err := buildInputForm(io, message, cfg, &input).Run()
 	if errors.Is(err, huh.ErrUserAborted) {
 		return "", slackerror.New(slackerror.ErrProcessInterrupted)
 	} else if err != nil {
@@ -53,17 +63,17 @@ func charmInputPrompt(_ *IOStreams, _ context.Context, message string, cfg Input
 }
 
 // buildConfirmForm constructs a huh form for yes/no confirmation prompts.
-func buildConfirmForm(message string, choice *bool) *huh.Form {
+func buildConfirmForm(io *IOStreams, message string, choice *bool) *huh.Form {
 	field := huh.NewConfirm().
 		Title(message).
 		Value(choice)
-	return huh.NewForm(huh.NewGroup(field)).WithTheme(style.ThemeSlack())
+	return newForm(io, field)
 }
 
 // charmConfirmPrompt prompts for a yes/no confirmation using a charm huh form
-func charmConfirmPrompt(_ *IOStreams, _ context.Context, message string, defaultValue bool) (bool, error) {
+func charmConfirmPrompt(io *IOStreams, _ context.Context, message string, defaultValue bool) (bool, error) {
 	var choice = defaultValue
-	err := buildConfirmForm(message, &choice).Run()
+	err := buildConfirmForm(io, message, &choice).Run()
 	if errors.Is(err, huh.ErrUserAborted) {
 		return false, slackerror.New(slackerror.ErrProcessInterrupted)
 	} else if err != nil {
@@ -73,7 +83,7 @@ func charmConfirmPrompt(_ *IOStreams, _ context.Context, message string, default
 }
 
 // buildSelectForm constructs a huh form for single-selection prompts.
-func buildSelectForm(msg string, options []string, cfg SelectPromptConfig, selected *string) *huh.Form {
+func buildSelectForm(io *IOStreams, msg string, options []string, cfg SelectPromptConfig, selected *string) *huh.Form {
 	var opts []huh.Option[string]
 	for _, opt := range options {
 		key := opt
@@ -91,13 +101,13 @@ func buildSelectForm(msg string, options []string, cfg SelectPromptConfig, selec
 		Options(opts...).
 		Value(selected)
 
-	return huh.NewForm(huh.NewGroup(field)).WithTheme(style.ThemeSlack())
+	return newForm(io, field)
 }
 
 // charmSelectPrompt prompts the user to select one option using a charm huh form
-func charmSelectPrompt(_ *IOStreams, _ context.Context, msg string, options []string, cfg SelectPromptConfig) (SelectPromptResponse, error) {
+func charmSelectPrompt(io *IOStreams, _ context.Context, msg string, options []string, cfg SelectPromptConfig) (SelectPromptResponse, error) {
 	var selected string
-	err := buildSelectForm(msg, options, cfg, &selected).Run()
+	err := buildSelectForm(io, msg, options, cfg, &selected).Run()
 	if errors.Is(err, huh.ErrUserAborted) {
 		return SelectPromptResponse{}, slackerror.New(slackerror.ErrProcessInterrupted)
 	} else if err != nil {
@@ -109,7 +119,7 @@ func charmSelectPrompt(_ *IOStreams, _ context.Context, msg string, options []st
 }
 
 // buildPasswordForm constructs a huh form for password (hidden input) prompts.
-func buildPasswordForm(message string, cfg PasswordPromptConfig, input *string) *huh.Form {
+func buildPasswordForm(io *IOStreams, message string, cfg PasswordPromptConfig, input *string) *huh.Form {
 	field := huh.NewInput().
 		Title(message).
 		Prompt(style.Chevron() + " ").
@@ -118,13 +128,13 @@ func buildPasswordForm(message string, cfg PasswordPromptConfig, input *string)
 	if cfg.Required {
 		field.Validate(huh.ValidateMinLength(1))
 	}
-	return huh.NewForm(huh.NewGroup(field)).WithTheme(style.ThemeSlack())
+	return newForm(io, field)
 }
 
 // charmPasswordPrompt prompts for a password (hidden input) using a charm huh form
-func charmPasswordPrompt(_ *IOStreams, _ context.Context, message string, cfg PasswordPromptConfig) (PasswordPromptResponse, error) {
+func charmPasswordPrompt(io *IOStreams, _ context.Context, message string, cfg PasswordPromptConfig) (PasswordPromptResponse, error) {
 	var input string
-	err := buildPasswordForm(message, cfg, &input).Run()
+	err := buildPasswordForm(io, message, cfg, &input).Run()
 	if errors.Is(err, huh.ErrUserAborted) {
 		return PasswordPromptResponse{}, slackerror.New(slackerror.ErrProcessInterrupted)
 	} else if err != nil {
@@ -134,7 +144,7 @@ func charmPasswordPrompt(_ *IOStreams, _ context.Context, message string, cfg Pa
 }
 
 // buildMultiSelectForm constructs a huh form for multiple-selection prompts.
-func buildMultiSelectForm(message string, options []string, selected *[]string) *huh.Form {
+func buildMultiSelectForm(io *IOStreams, message string, options []string, selected *[]string) *huh.Form {
 	var opts []huh.Option[string]
 	for _, opt := range options {
 		opts = append(opts, huh.NewOption(opt, opt))
@@ -145,13 +155,13 @@ func buildMultiSelectForm(message string, options []string, selected *[]string)
 		Options(opts...).
 		Value(selected)
 
-	return huh.NewForm(huh.NewGroup(field)).WithTheme(style.ThemeSlack())
+	return newForm(io, field)
 }
 
 // charmMultiSelectPrompt prompts the user to select multiple options using a charm huh form
-func charmMultiSelectPrompt(_ *IOStreams, _ context.Context, message string, options []string) ([]string, error) {
+func charmMultiSelectPrompt(io *IOStreams, _ context.Context, message string, options []string) ([]string, error) {
 	var selected []string
-	err := buildMultiSelectForm(message, options, &selected).Run()
+	err := buildMultiSelectForm(io, message, options, &selected).Run()
 	if errors.Is(err, huh.ErrUserAborted) {
 		return []string{}, slackerror.New(slackerror.ErrProcessInterrupted)
 	} else if err != nil {