---
title: "Configuration"
description: "Configure a repository for Trevize with .trevize/settings.json — hooks, preview targets and processes, and resources."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.trevize.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

A repository tells Trevize how to set itself up, run, and preview through a
single file: **`.trevize/settings.json`**. It lives in your repo, is versioned
alongside your code, and controls what happens inside every sandbox Trevize
creates for a session or automation.

- [**Overview & schema**](/configuration/settings-json) — the shape of
  `settings.json` and what each top-level key does.
- [**Hooks**](/configuration/hooks) — commands that run at sandbox lifecycle
  points such as `SandboxReady` (install dependencies, select a runtime, run
  setup).
- [**Preview targets & processes**](/configuration/preview) — declare the
  processes that serve your app so reviewers get a live preview (`command`,
  `port`, `env`, `defaultProcess`).
- [**Resources**](/configuration/resources) — attach managed resources such as a
  Neon database and map their connection details into environment variables.
- [**Annotated example**](/configuration/example) — a complete `settings.json`
  walked through section by section.

For the exhaustive field list, see the
[settings.json reference](/reference).

Source: https://docs.trevize.dev/configuration/index.mdx