A modern, minimalist presentation theme for Touying. Calm, approachable, and intelligent—designed to let your content shine.

Installation

From Typst Universe

Use the template directly:

# Create a new presentation from template
typst init @preview/calmly-touying:0.2.0 my-presentation
cd my-presentation
typst compile main.typ

Or import it in an existing project:

#import "@preview/calmly-touying:0.2.0": *

Local Development

For local development or contributing, see the GitHub repository.

Features

• Four Color Themes: Tomorrow, Warm Amber, Paper, and Dracula palettes
• Light/Dark Variants: Adapt to different venues and preferences
• Moloch-Inspired Design: Clean headers, progress bars, and academic styling
• Multiple Slide Types: Title, content, focus, standout, section, figure, equation, and more
• Rich Components: Highlight boxes, alert/example boxes, algorithm containers, citation gadgets
• Progressive Reveals: #only() and #pause for animations
• Golden Ratio Spacing: Mathematically pleasing proportions
• Bibliography Integration: Styled citations and reference slides

Quick Start

#import "@preview/calmly-touying:0.2.0": *

#show: calmly.with(
  config-info(
    title: [Your Presentation Title],
    subtitle: [Event or Context],
    author: [Your Name],
    date: datetime.today(),
    institution: [Your Institution],
  ),
)

#title-slide()

== First Slide

Your content here...

- Bullet points are styled automatically
- *Emphasis* and **strong text** work as expected

#focus-slide[
  Key Takeaway Message
]

#ending-slide(
  contact: ("email@example.com", "github.com/username"),
)

Configuration Options

The theme supports extensive customization through configuration options:

#show: calmly.with(
  config-info(
    title: [Your Title],
    author: [Your Name],
  ),
  variant: "light",           // "light" | "dark"
  colortheme: "tomorrow",     // "tomorrow" | "warm-amber" | "paper" | "dracula"
  progressbar: "foot",        // "foot" | "head" | "frametitle" | "none"
  header-style: "moloch",     // "moloch" | "minimal"
  title-layout: "moloch",     // "moloch" | "centered" | "split"
)

Color Themes

• Tomorrow (default): Programmer-friendly palette based on Tomorrow theme. Balanced colors.
• Warm Amber: Soft, warm tones with amber accents. Premium, modern feel.
• Paper: High contrast black/white with blue accents. Academic style.
• Dracula: Purple and pink accents.

Slide Types

Title Slide

#title-slide()
#title-slide(layout: "centered")  // Alternative layouts
#title-slide(layout: "split")

Content Slides

Standard slides are created automatically with level-2 headings:

== Slide Title

Content goes here...

Focus Slide

Full-bleed accent gradient background for emphasis:

#focus-slide[
  Important statement or takeaway
]

Standout Slide

High-contrast background for maximum emphasis:

#standout-slide[
  Key Message
]

Section Slide

Clean section dividers with optional progress:

#section-slide[Methods]
#section-slide(show-progress: true)[Results]

Figure Slide

Centered figure with optional caption:

#figure-slide(
  image("figure.svg"),
  title: [Figure Title],
  caption: [Description of the figure],
)

Split Figure Slide

Two figures side-by-side:

#figure-slide-split(
  image("left.svg"),
  image("right.svg"),
  title: [Comparison],
  caption-left: [Before],
  caption-right: [After],
)

Equation Slide

Centered equation with definition box and optional citation:

#equation-slide(
  $E = m c^2$,
  title: [Mass-Energy Equivalence],
  subtitle: [Einstein's famous equation],
  definitions: [
    $E$ — Energy \
    $m$ — Mass \
    $c$ — Speed of light
  ],
  citation: (bib-key: "einstein1905", label: "Einstein 1905"),
)

Bibliography Slide

#bibliography-slide(bib-content: bibliography("refs.bib", title: none, style: "apa"))

Acknowledgement Slide

#acknowledgement-slide(
  subtitle: [We thank the following],
  people: (
    (name: "Prof. Smith", role: "Supervisor"),
    (name: "Dr. Jones", role: "Advisor"),
  ),
  institutions: ("University A", "Lab B"),
  extra: [Special thanks to all contributors.],
)

Ending Slide

#ending-slide(
  title: [Thank You],
  subtitle: [Questions?],
  contact: ("email@example.com", "github.com/username"),
)

Components

Box Components

// Key concepts and summaries
#highlight-box(title: "Key Point")[
  Important information here.
]

// Warnings and critical notes
#alert-box(title: "Warning")[
  Critical information.
]

// Examples and demonstrations
#example-box(title: "Example")[
  Illustrative content.
]

// Generic themed container
#themed-block(title: "Block Title")[
  General content.
]
#themed-block(title: "Filled", fill-mode: "fill")[Filled background.]

Algorithm Box

#algorithm-box(title: "Algorithm 1: Example")[
  *Input:* Data $X$ \
  *Output:* Result $Y$ \
  1: Process data \
  2: Return result
]

Text Helpers

This is #alert[important] information.     // Accent colored
This is #muted[secondary] information.     // Muted grey
This is #subtle[tertiary] information.     // Light subtle

Citations

Inline Citations (grey-boxed):

Recent work has shown improvements @smith2023.

Renders with a subtle grey background pill.

Citation Box (positioned in corners):

#cite-box("key", display-label: "Author 2023", position: "bottom-right")

// Multiple citations
#cite-box(
  ("key1", "key2"),
  display-label: "Author1; Author2",
  position: "top-right"
)

Positions: "top-right", "bottom-left", "bottom-right"

Multi-Column Layouts

#two-col(
  [Left column content],
  [Right column content],
)

#three-col([A], [B], [C])

Progressive Reveals

Using #only(n)[...]

Show content only on specific sub-slides:

== Building Concepts

#only(1)[Step 1: Introduction]
#only(2)[Step 2: Details]
#only(3)[Step 3: Conclusion]

Using #pause

Reveal content progressively:

== Points

- First point
#pause
- Second point (appears after click)
#pause
- Third point

Spacing Utilities

Flexible Spacing

#v(1fr)          // Flexible vertical space
#v(spacing-md)   // Fixed spacing (16pt)

Vertical Centering

#v(1fr)
#align(center)[Centered content]
#v(1fr)

Spacing Constants

Typography Constants

Golden Ratio Utilities

Customization

Colors

Edit theme/colors.typ to customize the color palette. Each theme defines:

• Accent colors (primary, secondary, subtle)
• Background hierarchy (base, elevated, muted, surface)
• Text hierarchy (primary, secondary, muted)
• Functional colors (alert, example, focus)

Typography

Edit theme/typography.typ for font settings:

#let font-heading = ("Source Sans Pro", "Noto Sans", "sans-serif")
#let font-body = ("Source Sans Pro", "Noto Sans", "sans-serif")
#let font-mono = ("JetBrains Mono", "Fira Code", "monospace")

Recommended Fonts

For best results, install:

• Source Sans Pro
• JetBrains Mono
• STIX Two Math

The theme will gracefully fall back to system fonts if these aren’t available.

Examples

The examples/ directory contains several templates:

File Structure

calmly-touying/
├── typst.toml              # Package manifest
├── lib.typ                 # Package entrypoint
├── LICENSE                 # MIT License
├── README.md
├── thumbnail.png           # Package thumbnail (for Universe listing)
├── theme/
│   ├── theme.typ           # Main theme configuration
│   ├── colors.typ          # Color palettes (4 themes × 2 variants)
│   ├── typography.typ      # Font settings and spacing
│   ├── components.typ      # Reusable components (30+)
│   ├── slides.typ          # Slide type definitions
│   └── syntax-themes/      # .tmTheme files for code syntax highlighting
├── template/               # Starter template (for typst init)
│   └── main.typ            # Template entry point
└── examples/               # Example presentations

Building

typst compile main.typ

Or use typst watch main.typ for live preview.

License

MIT License - feel free to use and modify for your presentations.

Credits & References

• Built on Touying presentation framework by OrangeX4
• Layout inspired by Moloch (Beamer theme) by Johan Larsson, itself based on Metropolis by Matthias Vogelgesang
• Color palette based on Tailwind CSS Stone and Amber scales

Function Reference

Modified from Touying

These functions wrap or extend Touying’s base functionality:

Created for This Theme

Layout Helpers (components.typ):

Box Components (components.typ):

Text Helpers (components.typ):

Visual Elements (components.typ):

Card Components (components.typ):

Color System (colors.typ):

Golden Ratio (typography.typ):

Theme Entry (theme.typ):