Project Options

This article documents options that define the type, render targets, and output of a project.

See the Project Basics article for additional documentation on using projects.

Project options are specified under the project key. For example:

---
project:
  type: website
  output-dir: _site
---

`title`
`type`	Project type (`default`, `website`, or `book`)
`render`	Files to render (defaults to all files)
`execute-dir`	Control the working directory for computations. `file`: Use the directory of the file that is currently executing. `project`: Use the root directory of the project.
`output-dir`	Output directory
`lib-dir`	HTML library (JS/CSS/etc.) directory
`resources`	Additional file resources to be copied to output directory
`preview`	Options for `quarto preview` (see Preview)
`pre-render`	Scripts to run as a pre-render step
`post-render`	Scripts to run as a post-render step

Specify options that control the behavior of quarto preview within the preview key. For example:

---
project:
  type: website
  output-dir: _site
  preview:
    port: 4200
    browser: false
---

Available preview options include:

`port`	Port to listen on (defaults to random value between 3000 and 8000)
`host`	Hostname to bind to (defaults to 127.0.0.1)
`serve`	Options for external preview server (see Serve)
`browser`	Open a web browser to view the preview (defaults to true)
`watch-inputs`	Re-render input files when they change (defaults to true)
`navigate`	Navigate the browser automatically when outputs are updated (defaults to true)
`timeout`	Time (in seconds) after which to exit if there are no active clients