A highly configurable variant of the Metropolis theme for Touying presentations in Typst. This theme allows for many font and color options, while still maintaing compatibility with the original Metropolis beamer theme.
Use the package directly in your document:
#import "@preview/metropolyst:0.1.0": metropolyst-theme, brandsInitialize a new project with the template:
typst init @preview/metropolyst:0.1.0Metropolyst provides four slide types:
#title-slide()
// or with extra information:
#title-slide(extra: [Conference Name 2025])Creates the opening slide with title, subtitle, author, date, institution, and optional logo. Configure the content using config-info().
#slide[
= Slide Title
Your content here...
]Standard slide with header showing the slide title, footer with slide counter, and your content.
== Section NameAutomatically creates a section divider slide when you use a level-2 heading. Shows the section name with a progress bar.
#focus-slide[
*Key Message*
]High-contrast slide with dark background and light text. Use for important messages or transitions.
All options are passed to metropolyst-theme.with(...).
| Parameter | Default | Description |
|---|---|---|
aspect-ratio |
"16-9" |
Slide aspect ratio ("16-9" or "4-3") |
align |
horizon |
Vertical content alignment (horizon, top, bottom) |
footer-progress |
false |
Show progress bar at bottom of slides |
header |
current heading | Header left content (content or self => content) |
header-right |
logo | Header right content |
footer |
none |
Footer left content |
footer-right |
slide counter | Footer right content |
Fonts cascade: set font to change all fonts, or override specific elements. All *-font options default to auto (inherit from font).
#show: metropolyst-theme.with(
font: ("Libertinus Serif",), // Base font
header-font: ("Fira Sans",), // Override for headers
)| Parameter | Default | Description |
|---|---|---|
font |
("Fira Sans",) |
Base font family (inherited by all *-font options) |
header-font |
auto |
Slide header font |
header-size |
1.2em |
Slide header size |
header-weight |
"regular" |
Slide header weight |
footer-font |
auto |
Footer font |
footer-size |
0.6em |
Footer size |
footer-weight |
"regular" |
Footer weight |
title-font |
auto |
Title slide title font |
title-size |
1.4em |
Title slide title size |
title-weight |
"regular" |
Title slide title weight |
subtitle-size |
1.0em |
Subtitle size |
subtitle-weight |
"light" |
Subtitle weight |
author-size |
0.8em |
Author size |
author-weight |
"light" |
Author weight |
date-size |
0.8em |
Date size |
date-weight |
"light" |
Date weight |
institution-size |
0.8em |
Institution size |
institution-weight |
"light" |
Institution weight |
extra-size |
0.8em |
Extra text size (#title-slide(extra: [...])) |
extra-weight |
"light" |
Extra text weight |
logo-size |
2em |
Logo size |
section-font |
auto |
Section slide font |
section-size |
1.4em |
Section slide size |
section-weight |
"regular" |
Section slide weight |
focus-font |
auto |
Focus slide font |
focus-size |
1.4em |
Focus slide size |
focus-weight |
"regular" |
Focus slide weight |
Colors cascade: accent-color affects links, separators, and progress bars when they're set to auto. Background colors have independent defaults.
#show: metropolyst-theme.with(
accent-color: rgb("#e63946"), // Affects links, separators, progress bars
hyperlink-color: rgb("#0077b6"), // Override just links
)| Parameter | Default | Inherits | Description |
|---|---|---|---|
accent-color |
rgb("#eb811b") |
— | Primary accent for #alert[...] text |
hyperlink-color |
auto |
accent-color |
Link color |
line-separator-color |
auto |
accent-color |
Title slide separator line |
progress-bar-color |
auto |
accent-color |
Progress bar foreground |
progress-bar-background |
rgb("#d6c6b7") |
— | Progress bar background |
header-background-color |
rgb("#23373b") |
— | Slide header background |
focus-background-color |
auto |
header-background-color |
Focus slide background |
main-background-color |
rgb("#fafafa") |
— | Slide, title, and section background |
main-text-color |
rgb("#23373b") |
— | Body text, title, and section text |
header-text-color |
auto |
main-background-color |
Slide header text |
focus-text-color |
auto |
main-background-color |
Focus slide text |
footer-text-color |
auto |
main-text-color |
Slide footer text |
Brands are preset configurations that apply organizational styling with a single setting. Use the spread operator (..) to apply a brand:
#import "@preview/metropolyst:0.1.0": metropolyst-theme, brands
#show: metropolyst-theme.with(..brands.EPI)| Brand | Description |
|---|---|
EPI |
Economic Policy Institute branding (Roboto font, red accent #C01F41, dark blue header #063957, no page counter) |
You can apply a brand and then override specific settings:
#show: metropolyst-theme.with(
..brands.EPI,
footer-progress: true, // Add progress bar to EPI brand
)Create custom brands as dictionaries in your own file:
// my-brands.typ
#let brands = (
"my-company": (
accent-color: rgb("#ff0000"),
header-background-color: rgb("#333333"),
font: ("Roboto",),
),
)Then import and use:
#import "@preview/metropolyst:0.1.0": metropolyst-theme
#import "my-brands.typ": brands
#show: metropolyst-theme.with(..brands.my-company)Or define inline:
#let my-brand = (
accent-color: rgb("#0066cc"),
footer-right: none,
)
#show: metropolyst-theme.with(..my-brand)#import "@preview/metropolyst:0.1.0": metropolyst-theme, brands
#show: metropolyst-theme.with(
config-info(
title: [Your Title],
subtitle: [Your Subtitle],
author: [Your Name],
date: datetime.today(),
institution: [Your Institution],
),
)
#set text(font: "Fira Sans", weight: "light", size: 20pt)
#set strong(delta: 100)
#title-slide()
== Section Title
#slide[
= Slide Title
Your content here...
]Set presentation metadata using config-info():
#show: metropolyst-theme.with(
config-info(
title: [Presentation Title],
subtitle: [Optional Subtitle],
author: [Author Name],
date: datetime.today(),
institution: [Organization],
logo: emoji.rocket, // or an image
),
)For best results, install the Fira Sans font family:
Linux:
# Ubuntu/Debian
sudo apt install fonts-fira-sans
# Or download from GitHub
wget https://github.com/mozilla/Fira/archive/refs/heads/master.zip
unzip master.zip
sudo cp Fira-master/ttf/*.ttf /usr/share/fonts/truetype/
fc-cache -fvmacOS:
brew install --cask font-fira-sansWindows: Download from Google Fonts and install.
- example-default.typ (PDF) - Minimal example using default settings
- example-custom.typ (PDF) - Comprehensive example demonstrating all configuration options
- example-epi.typ (PDF) - Example using the built-in EPI brand preset
- Tries to copy Matthias Vogelgesang's Beamer Metropolis theme
- Based on the Touying Metropolis theme by @Enivex
- Built for the Touying presentation framework
MIT License. See LICENSE for details.