# InitWizard

Source: /tuil/docs/reference/components/initializer/init-wizard
Locale: en

InitWizard component API, behavior, and executable example.





{/* Generated by tooling/docs/generate-reference.ts. */}

<PublishedStory storyId="component-acceptance" variant="InitWizard" />

## API and events [#api-and-events]

A complete source-owned application block combining forms, navigation, dialogs, operations, themes, and workflow state into a project creator.

```tsx
export function InitWizard(props: InitWizardProps): ReactNode;
```

### Props, functions, and events [#props-functions-and-events]

| Member        | Type                             | Required | Description                                                                 | Related types                                                  |
| ------------- | -------------------------------- | -------- | --------------------------------------------------------------------------- | -------------------------------------------------------------- |
| `initialName` | `string`                         | Yes      | The `initialName` member uses the `string` contract.                        | —                                                              |
| `onComplete`  | `(answers: InitAnswers) => void` | Yes      | The `onComplete` member uses the `(answers: InitAnswers) => void` contract. | [`InitAnswers`](/tuil/docs/reference/packages/cli/api/init-answers) |
| `onCancel`    | `() => void`                     | Yes      | The `onCancel` member uses the `() => void` contract.                       | —                                                              |

`onComplete` returns validated answers and `onCancel` reports abandonment.

Callback props run after the documented input is accepted. Callbacks are not cancellable unless their return type or description states otherwise.

## Interaction and capabilities [#interaction-and-capabilities]

The guided flow validates names, template choice, features, confirmation, cancellation, and capability-aware static fallbacks.

The published manifest records keyboard, focus, pointer, theme, terminal, semantic, event, and dependency requirements.

## Complete import [#complete-import]

```tsx
import { InitWizard } from "@/components/tuil/blocks/init-wizard";
```