Prompts

The @clack/prompts package provides a collection of pre-built, high-level prompts that make it easy to create interactive command-line interfaces. It builds on top of the core package to provide a more developer-friendly experience.

Key Features

Pre-built prompts: Ready-to-use prompt components
Consistent styling: Unified look and feel across all prompts
Type-safe: Full TypeScript support
Customizable: Easy to extend and modify

Available Prompts

Text Input

import { 
const text: (opts: TextOptions) => Promise<string | symbol>
text } from '@clack/prompts';

const 
const name: string | symbol
name = await 
function text(opts: TextOptions): Promise<string | symbol>
text({
  
TextOptions.message: string
message: 'What is your name?',
  
TextOptions.placeholder?: string
placeholder: 'John Doe',
  
TextOptions.validate?: (value: string) => string | Error | undefined
validate: (
value: string
value) => {
    if (
value: string
value.
String.length: number
Returns the length of a String object.
length < 2) return 'Name must be at least 2 characters';
    return 
var undefined
undefined;
  },
});

Selection

import { 
const select: <Value>(opts: SelectOptions<Value>) => Promise<symbol | Value>
select } from '@clack/prompts';

const 
const framework: symbol | "next" | "astro" | "svelte"
framework = await 
select<"next" | "astro" | "svelte">(opts: SelectOptions<"next" | "astro" | "svelte">): Promise<symbol | "next" | "astro" | "svelte">
select({
  
SelectOptions<Value>.message: string
message: 'Pick a framework',
  
SelectOptions<"next" | "astro" | "svelte">.options: ({
    value: "next";
    label?: string;
    hint?: string;
} | {
    value: "astro";
    label?: string;
    hint?: string;
} | {
    value: "svelte";
    label?: string;
    hint?: string;
})[]
options: [
    { 
value: "next"
Internal data for this option.
value: 'next', 
label?: string
The optional, user-facing text for this option.
By default, the value is converted to a string.
label: 'Next.js' },
    { 
value: "astro"
Internal data for this option.
value: 'astro', 
label?: string
The optional, user-facing text for this option.
By default, the value is converted to a string.
label: 'Astro' },
    { 
value: "svelte"
Internal data for this option.
value: 'svelte', 
label?: string
The optional, user-facing text for this option.
By default, the value is converted to a string.
label: 'SvelteKit' },
  ],
});

Confirmation

import { 
const confirm: (opts: ConfirmOptions) => Promise<boolean | symbol>
confirm } from '@clack/prompts';

const 
const shouldProceed: boolean | symbol
shouldProceed = await 
function confirm(opts: ConfirmOptions): Promise<boolean | symbol>
confirm({
  
ConfirmOptions.message: string
message: 'Do you want to continue?',
});

Installation

npm install @clack/prompts

Usage

The prompts package is designed to be intuitive and easy to use. Each prompt function returns a Promise that resolves to the user’s input.

For more detailed examples and advanced usage patterns, check out our examples guide and best practices.