A comprehensive, extensible Typst template for theses and dissertations at the University of São Paulo (USP) and specifically the Institute of Mathematics and Statistics (IMEUSP), following the official guidelines (5th edition, 2024).

Example output PDF generated with this template: usp-example.pdf

Features

• Official Layout: Correct margins (3cm/2cm), A4 size, and 1.5 line spacing.
• Automated Elements: Generates Cover, Title Page, Approval Sheet, and Abstracts.
• IMEUSP Support: Specific branding and “Standard Statement” for the Institute of Mathematics and Statistics.
• Extensible: Easily adaptable to other USP institutes.
• Pre-textual Elements: Support for Dedication, Acknowledgments, and Epigraph.
• PDF Bookmarks: Cover, lists and table of contents appear in the PDF viewer’s outline.
• References: ABNT (NBR 6023) layout in the IME-USP author-date style by default.
• Appendices and Annexes: #show: appendix / #show: annex give lettered headings (“APPENDIX A – TITLE”) in the text and the table of contents.
• Drafting Notes: #todo(kind: "verify")[...] inline notes, colored by kind, listed by #note-outline().

Table of Contents

• USP Thesis Typst Template
  • Features
  • Table of Contents
  • Prerequisites
  • Getting Started
  • Example Usage
  • Configuration Options
  • Future Extensions
  • Development and Testing
  • License

Prerequisites

• Typst Compiler: Typst is a modern, faster, and more intuitive typesetting alternative to LaTeX, featuring cleaner syntax and instant compilation, making it ideal for new projects.

  [Click to expand] How to install Typst ⚙️

  MacOS

  Open Terminal and run:

  brew install typst
  

  Linux

  Open Terminal and run:

  # For Debian/Ubuntu-based distributions
  sudo apt install typst
  # For Fedora-based distributions
  sudo dnf install typst
  # Snap
  sudo snap install typst
  

  Windows

  Open PowerShell and run:

  winget install typst
  

Getting Started

Typst web app

Click Start from template on typst.app and search for modern-usp-thesis.

Command line

Create a new project from the template:

typst init @preview/modern-usp-thesis:0.1.0

Then generate the PDF with:

cd modern-usp-thesis
typst compile main.typ

To watch for changes and recompile automatically:

typst watch main.typ

Example Usage

#import "@preview/modern-usp-thesis:0.1.0": usp-thesis, appendix

#show: usp-thesis.with(
  title: [Your Thesis Title],
  author: "Your Name",
  advisor: "Advisor's Name",
  institute: "Instituto de Matemática e Estatística",
  program: "Estatística",
  degree: "Mestre", // or "Doutor"
  abstract-pt: [ ... ],
  keywords-pt: ("Keyword1", "Keyword2"),
  abstract-en: [ ... ],
  keywords-en: ("Keyword1", "Keyword2"),
  banca: (
    (nome: "Examiner 1", instituicao: "USP"),
    (nome: "Examiner 2", instituicao: "Unicamp"),
  ),
)

= Introduction
Your content starts here...

#bibliography("refs.bib") // ABNT / IME-USP style unless `style:` is given

#show: appendix
= Proofs // printed as "APPENDIX A – PROOFS", referenced as "Appendix A"

Configuration Options

The usp-thesis function accepts the following parameters. Only title, author, advisor, program and the abstracts really need to be set; everything else has a sensible default.

Leaving out pre-textual elements

Most pre-textual elements are only printed when you pass them (abstracts, dedication, banca…). The cover, title page and table of contents are always printed unless you turn them off with cover: false, title-page: false or table-of-contents: false. Page numbering counts from the title page (ABNT), or from the first page printed when there is no title page.

To compile only your chapters, e.g. to share a draft with your advisor, set front-matter: false. Every pre-textual element is left out, whatever the other parameters say, so they can stay as they are; the text keeps the same layout, chapter references and bibliography style, numbered from page 1.

#show: usp-thesis.with(
  title: [Your Thesis Title],
  // ...
  front-matter: false,
)

With the defaults above, the title page of an IME master’s dissertation reads:

Dissertação apresentada ao IME-USP para obtenção do título de Mestre em Ciências. Programa: Estatística

and for another institute, e.g. institute: "Escola Politécnica", degree: "Doutor em Engenharia":

Tese apresentada à Escola Politécnica da Universidade de São Paulo para obtenção do título de Doutor em Engenharia. Programa: Engenharia Elétrica

Future Extensions

To add support for a new institute with a specific “Nature Text”, modify the nature-text logic in src/usp-thesis.typ:

let nature-text = if institute.contains("Your Institute") {
  "Specific Statement for your Institute"
} else {
  // default ABNT/USP statement
}

Development and Testing

To test changes before publishing, link this repository as a local package (macOS example; use ~/.local/share on Linux or %APPDATA% on Windows, or run typst info to see the package path):

mkdir -p ~/Library/Application\ Support/typst/packages/preview/modern-usp-thesis/
ln -sfn $PWD ~/Library/Application\ Support/typst/packages/preview/modern-usp-thesis/0.1.0

Then typst init @preview/modern-usp-thesis:0.1.0 uses your local copy. Run just test to compile the files in examples/.

License

The package code is licensed under the MIT License, with two exceptions:

• The files in src/template/, which are copied into your project by typst init, are licensed under MIT No Attribution, so you can use and distribute your thesis without any license obligations.
• src/usp-ime.csl is the Universidade de São Paulo – Instituto de Matemática e Estatística citation style from the Zotero Style Repository, licensed under CC BY-SA 3.0.