---
title: dotui.json
---

The `dotui.json` file holds configuration for your project.

We use it to understand how your project is set up and how to generate components customized for your project.

<Alert fill>Note: This file config is only required for CLI use.</Alert>

## Schema

After running the init command, you’ll have a new `dotui.json` file in your directory:

```json title="dotui.config.json"
{
  "$schema": "https://dotui.org/schema.json",
  "aliases": {
    "components": "@/components",
    "utils": "@/lib/utils",
    "core": "@/lib/core",
    "lib": "@/lib",
    "hooks": "@/hooks"
  },
  "style": {
    "iconLibrary": "lucide",
    "componentsOverrides": {
      "button": "button-01"
    }
  }
}
```

### $schema

The `$schema` field is used to validate the configuration file.

### Aliases

Aliases are used to map the default import paths to your project's paths.

### Style

The `style` object is used to configure the project's style.

| Key                   | Type                                | Description                     |
| --------------------- | ----------------------------------- | ------------------------------- |
| `iconLibrary`         | `"lucide" \| "phosphor" \| "remix"` | The icon library to use.        |
| `componentsOverrides` | `Record<string, string>`            | The component overrides to use. |
