tectonic -X new

Create a new Tectonic workspace.

This is a V2 CLI command. For information on the original (“V1” CLI), see its reference page.

Usage Synopsis

tectonic -X new [DIRECTORY]

If {DIRECTORY} is unspecified, the workspace is created in the current directory.


This command will create a bare-bones Tectonic.toml file in the target directory. The project’s name will be initialized to the name of the workspace directory.

It will also create placeholder source files in a src subdirectory: index.tex, _preamble.tex, and _postamble.tex. The default build command will process these files in the expected order:

  1. src/_preamble.tex
  2. src/index.tex
  3. src/_postamble.tex

The intention of this framework is to allow you to isolate the main content of your document from the usual LaTeX boilerplate. There are no restrictions on what kind of content may be placed in each file, though.