> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wp-content.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Start a new theme

> wpc theme:start

Create a folder with a minimal theme file. If no arguments or options are passed to the command, they can be entered interactively.

## Usage

```bash theme={null}
wpc theme:start [options] [--] [<name> [<slug>]]
```

## Arguments

<ParamField body="name" type="string" required>
  Name of the theme.
</ParamField>

<ParamField body="slug" type="string">
  This will be the folder name and the slug of the theme. If you don’t specify the slug, the name will be used to create one.
</ParamField>

## Options

The options allow you to set the information in your theme’s header ([see the WordPress documentation](https://developer.wordpress.org/themes/basics/main-stylesheet-style-css/)).

<ParamField body="--theme-version" type="string" default="1.0.0">
  Version theme header
</ParamField>

<ParamField body="--author" type="string">
  Author theme header
</ParamField>

<ParamField body="--author-uri" type="string">
  Author URI theme header
</ParamField>

<ParamField body="--theme-uri" type="string">
  Theme URI theme header
</ParamField>

<ParamField body="--description" type="string">
  Description theme header
</ParamField>

<ParamField body="--requires-at-least" type="string">
  Requires at least theme header
</ParamField>

<ParamField body="--requires-php" type="string">
  Requires PHP theme header
</ParamField>

<ParamField body="--license" type="string">
  License theme header
</ParamField>

<ParamField body="--license-uri" type="string">
  License URI theme header
</ParamField>

<ParamField body="--text-domain" type="string">
  Text Domain theme header
</ParamField>

<ParamField body="--domain-path" type="string">
  Domain Path theme header
</ParamField>

<ParamField body="--tags" type="string">
  Tags theme header
</ParamField>

## Interactive mode

If you don't pass any argument or option, the command runs in interactive mode. You’ll be prompted to enter the theme name and can optionally define additional headers.

## Examples

<Tabs>
  <Tab title="Create a theme without any interaction">
    <CodeGroup>
      ```bash Input theme={null}
      $ cd /Users/mkey/Wordpress/wp-content/themes/

      $ wpc theme:start --author="Happy Monkey" --author-uri="https://mkey.fr" --theme-version=1.0.0 --no-interaction dummy
      Theme initialized at path : /Users/mkey/Wordpress/wp-content/themes/dummy
      ```

      ```css Output file: dummy/style.css theme={null}
       /**
       * Theme Name: dummy
       * Description:
       * Version: 1.0.0
       * Author: Happy Monkey
       * Author URI: https://mkey.fr
       * Update URI: https://registry.wp-content.io
       *
       * Generated by WPC-CLI Generator (https://wp-content.io).
       */
      ```
    </CodeGroup>
  </Tab>

  <Tab title="Create a theme interactively">
    <CodeGroup>
      ```bash Input theme={null}
      $ wpc theme:start
      Theme name: <dummy>
      Would you like to define plugin additional headers ? [N/y] <y>
      Plugin URI: <>
      Description: <Lorem ipsum dolor sit amet>
      Version: <1.0.1>
      Requires at least: <6.0>
      Requires PHP: <8.2>
      Author: <Happy Monkey>
      Author URI: <https://mkey.fr>
      License: <>
      License URI: <>
      Text Domain: <dummy>
      Domain Path: <>
      Tags: <>
      Network:<>

      Plugin initialized at path : /Users/mkey/Wordpress/wp-content/plugins/dummy
      ```

      ```css Output file: dummy/style.css theme={null}
       /**
       * Theme Name: dummy
       * Description: Lorem ipsum dolor sit amet
       * Version: 1.0.1
       * Requires at least: 6.0
       * Requires PHP: 8.2
       * Author: Happy Monkey
       * Author URI: https://mkey.fr
       * Text Domain: dummy
       * Update URI: https://registry.wp-content.io
       *
       * Generated by WPC-CLI Generator (https://wp-content.io).
       */
      ```
    </CodeGroup>
  </Tab>
</Tabs>