## Documentation index

This index lists every available documentation page and its Markdown source.

- [Documentation](https://veta.varavel.com/docs/index.md)
  - [Getting Started](https://veta.varavel.com/docs/getting-started/index.md)
  - [Installation](https://veta.varavel.com/docs/installation/index.md)
  - [Guides](https://veta.varavel.com/docs/guides/index.md)
    - [Project Structure](https://veta.varavel.com/docs/guides/project-structure/index.md)
    - [Configuration](https://veta.varavel.com/docs/guides/configuration/index.md)
    - [Pages](https://veta.varavel.com/docs/guides/pages/index.md)
    - [Data](https://veta.varavel.com/docs/guides/data/index.md)
    - [Markdown](https://veta.varavel.com/docs/guides/markdown/index.md)
    - [Templates](https://veta.varavel.com/docs/guides/templates/index.md)
    - [Components](https://veta.varavel.com/docs/guides/components/index.md)
    - [Filters](https://veta.varavel.com/docs/guides/filters/index.md)
    - [Assets And Tailwind CSS](https://veta.varavel.com/docs/guides/assets-and-tailwind/index.md)
    - [Themes](https://veta.varavel.com/docs/guides/themes/index.md)
    - [Development Server](https://veta.varavel.com/docs/guides/development-server/index.md)
    - [Build And Output](https://veta.varavel.com/docs/guides/build-and-output/index.md)
    - [Deployment](https://veta.varavel.com/docs/guides/deployment/index.md)
  - [Reference](https://veta.varavel.com/docs/reference/index.md)
    - [CLI Reference](https://veta.varavel.com/docs/reference/cli/index.md)
    - [Config Reference](https://veta.varavel.com/docs/reference/config/index.md)
    - [Page Generators Reference](https://veta.varavel.com/docs/reference/page-generators/index.md)
    - [Template Context Reference](https://veta.varavel.com/docs/reference/template-context/index.md)
    - [Troubleshooting](https://veta.varavel.com/docs/reference/troubleshooting/index.md)
  - [API](https://veta.varavel.com/docs/api/index.md)
    - [JavaScript API](https://veta.varavel.com/docs/api/javascript/index.md)
    - [File API](https://veta.varavel.com/docs/api/files/index.md)
    - [HTTP Client](https://veta.varavel.com/docs/api/http-client/index.md)
    - [Parse API](https://veta.varavel.com/docs/api/parse/index.md)
    - [Template Functions](https://veta.varavel.com/docs/api/template-functions/index.md)
    - [Environment And Console](https://veta.varavel.com/docs/api/environment-and-console/index.md)
    - [Markdown Frontmatter](https://veta.varavel.com/docs/api/frontmatter/index.md)


## Documentation content

The documentation for the current page follows, reproduced verbatim.


# Config Reference

Veta config is YAML. Unknown fields are rejected.

## Example

```yaml
build:
  output: dist
  clean: true

html:
  minify: true

dev:
  host: 127.0.0.1
  port: 3000
  watch:
    - content

tailwindcss:
  stylesheets:
    - styles.css
  minify: true

theme:
  source: "./theme"
```

## `build.output`

Type: string

Default: `dist`

The production output directory used by `veta build`.

Must be a relative project path.

## `build.clean`

Type: boolean

Default: `false`

When true, Veta removes the output directory before writing the build.

## `html.minify`

Type: boolean

Default: `false`

When true, minifies generated `.html` files only.

## `dev.host`

Type: string

Default: `127.0.0.1`

The local interface used by `veta dev`.

## `dev.port`

Type: number

Default: `3000`

The TCP port used by `veta dev`.

## `dev.watch`

Type: array of strings

Default: `[]`

Additional project-relative files or directories watched by `veta dev`. Directories are watched recursively. These paths are added to Veta's built-in watch set.

Example:

```yaml
dev:
  watch:
    - content
    - docs
```

## `tailwindcss.stylesheets`

Type: array of strings

Default: `[]`

When set, enables Tailwind CSS. Each path is relative to `public/`.

Example:

```yaml
tailwindcss:
  stylesheets:
    - styles.css
    - admin.css
```

This reads `public/styles.css` and `public/admin.css`, then writes generated CSS to `dist/styles.css` and `dist/admin.css`.

## `tailwindcss.minify`

Type: boolean

Default: `false`

When true, passes Tailwind's minification flag to the embedded Tailwind CSS standalone CLI.

## `theme.source`

Type: string

Default: empty

When set, resolves and composes a theme with the project.

Examples:

```yaml
theme:
  source: "./themes/blog"
```

```yaml
theme:
  source: "owner/veta-theme-name@v1.0.0"
```

> Note: The theme should match the owner/veta-theme-{name}@{ref} pattern.

## Supported File Names

Veta checks these names in order:

```txt
veta.yaml
veta.yml
.veta.yaml
.veta.yml
```