PRESENTATION

01 / 10

Presentations in Fig

By Silen Locatelli


A guide to creating and delivering presentations from inside your Git repositories.

Use arrow keys to navigate.

PRESENTATION

02 / 10

What is Fig?

Fig is a Git server with a web UI built in Rust.

It serves repositories over HTTP and provides a browser interface for:

  • Browsing code
  • Viewing files and commits
  • Delivering presentations right from your repo

The presentation feature turns Markdown files into slides, viewable in the browser with fullscreen support.

PRESENTATION

03 / 10

The .fig.toml File

Every configuration lives in a .fig.toml file at the repository root.

It controls:

KeyPurpose
ignore_for_viewGlob patterns for files to hide in the UI
tabsWhich tabs to display
deleteableAllow repo deletion from the UI
presentPresentation configuration

The [present] section is what powers the slides.

PRESENTATION

04 / 10

The [present] Section

Inside .fig.toml, add a [present] section:

[present]
files = [
  "slides/intro.md",
  "slides/conclusion.md"
]

The files key is a list of Markdown file paths relative to the repository root.

Each file becomes one slide in the presentation, displayed in the order listed.

If files is missing or empty, the "Present" tab will show a helpful message instead.

PRESENTATION

05 / 10

Template Variables

You can define custom variables in the [present] section:

[present]
files = ["slides/intro.md"]
author = "Jane Doe"
title = "My Talk"

Any key that is not files becomes a template variable.

Use them in your Markdown with mustache syntax:

Presented by **Silen Locatelli**
Title: **{{title}}**

They are replaced before the Markdown is rendered to HTML.

PRESENTATION

06 / 10

Slide Files

Each slide is a plain Markdown file:

  • Headings (#, ##) become styled headers
  • Bold, italic, and code work as expected
  • Tables are supported
  • Ordered and unordered lists work
  • Horizontal rules (---) create visual separators

Place your slides in a folder like slides/ at the repo root:

my-repo/
  .fig.toml
  slides/
    01-intro.md
    02-topic.md
    03-summary.md

Numbering the filenames keeps them sorted.

PRESENTATION

07 / 10

Full Example

Here is a complete .fig.toml for a presentation:

ignore_for_view = ["drafts/"]

[present]
files = [
  "slides/01-intro.md",
  "slides/02-setup.md",
  "slides/03-demo.md",
  "slides/04-summary.md"
]
author = "Jane Doe"
conference = "RustConf 2026"

And the referenced Markdown files use Silen Locatelli and {{conference}} to personalize the content.

The repository itself is the presentation - no build step, no extra tooling.

PRESENTATION

08 / 10

Viewing the Presentation

Once your repo has a .fig.toml with a [present] section:

  1. Push the repository to your Fig server
  2. Open the repo in your browser
  3. Click the Present tab

You will see:

  • Slide content rendered as HTML
  • Navigation with Previous / Next buttons
  • Dot indicators to jump to any slide
  • Arrow keys (← →) for keyboard navigation
  • A Fullscreen button for presenting

The "Present" tab only appears when [present] is configured.

PRESENTATION

09 / 10

Tips

  • Keep slides focused - one idea per file works best
  • Use template variables to avoid repeating names, dates, or URLs
  • Number your files so they sort naturally (01-, 02-, etc.)
  • Use ignore_for_view to hide draft or support files from the browser
  • Markdown supports tables - great for comparison slides
  • Fullscreen mode uses requestFullscreen() - great for projectors
  • No build step needed - just push Markdown and .fig.toml

PRESENTATION

10 / 10

Recap

To create a Fig presentation:

  1. Create slide files in Markdown
  2. Add a .fig.toml with a [present] section
  3. List your slide files in files
  4. Optionally add template variables
  5. Push to Fig and click Present

That is it. Your repo is your slide deck.


Made with Fig by Silen Locatelli

LICENSE

Non-Commercial License This license covers everything in this repository that its author created, not just the software: source code, documentation, papers and notes, slides and presentations, data, images, and other original material (together, the "Works"). Third-party content is not covered — see clause 2. 1. **Non-Commercial Use Only**: The Works may only be used for non-commercial purposes. Any commercial use, including but not limited to sale, licensing, or use in commercial products or services, is strictly prohibited. 2. **Third-Party Content**: Vendored dependencies, submodules, datasets, fonts, and any other third-party material included in the repository remain under their own licenses and terms. This license grants no rights to that content, and using it is subject to its own license regardless of what this one allows. 3. **No AI/ML Training**: The Works may not be used for training large language models (LLMs), machine learning models, or for any other form of AI/ML training or fine-tuning, whether commercial or non-commercial. 4. **No Redistribution for Training**: You may not distribute, share, or make the Works available to others for the purpose of AI/ML training. 5. **Attribution**: When you share or adapt the Works in a way this license permits, keep a notice of this license and credit the author as the copyright holder. 6. **Permitted Uses**: You may use and adapt the Works for personal, educational, research (non-AI/ML), and other non-commercial purposes, provided you comply with all other restrictions. 7. **No Warranty**: The Works are provided "AS IS" without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. 8. **Termination**: Violation of any of these terms will result in immediate termination of your rights to use the Works.

PRINT

Choose “Save as PDF” in the dialog to download the deck.