Universe

License: MIT Typst version: >= 0.14 touying version: 0.7.3 Built-in themes: sky and sunset AI Theme Generator

中文 | English

Academic presentation and note-taking theme built on touying. Suitable for research talks, thesis defenses, academic sharing, and literature notes. Derived from Carlos-Mero/may (MIT).

✨ Features

  • Built-in sky / sunset color schemes with one-parameter switching, plus AI custom themes
  • 7 slide layouts + academic note mode, covering title, outline, section transition, focus, and more
  • textbox multi-column boxes, red / yellow highlight macros, CJK synthetic italics, and other academic typesetting components
  • #pause progressive reveal animations with built-in frozen-counters to prevent numbering issues
  • Optional extension xwysyy-extras.typ: cetz drawing / fletcher diagrams + theorion theorem environments
  • Compatible with all touying 0.7.x advanced features

👀 Preview

Example decks are in the examples/ directory:

typst compile examples/slides-sky.typ           # sky theme slides
typst compile examples/slides-sunset.typ        # sunset theme slides
typst compile examples/note.typ                  # academic notes

🌤️ Sky Theme

Cover Lists & Highlights
Sky theme cover slide Sky theme lists and highlights
Textbox Components Code & Equations
Sky theme textbox components Sky theme code and equations

🌅 Sunset Theme

Cover Lists & Highlights
Sunset theme cover slide Sunset theme lists and highlights
Textbox Components Code & Equations
Sunset theme textbox components Sunset theme code and equations

📝 Note Mode

Title & TOC Lists & Code Tables & Quotes
Note mode title and TOC Note mode lists and code Note mode tables and quotes

🚀 Quick Start

Copy xwysyy.typ to your project directory, then:

#import "@preview/xwysyy:0.1.0": *

#show: xwysyy-pre.with(
  theme: "sunset",
  config-info(
    title: [My Presentation Title],
    subtitle: [Subtitle],
    author: " ",
    date: datetime.today(),
    institution: " ",
  ),
)

#title-slide()

= Section Title

== Slide Title

Body text with *bold* and #red[red highlight].

#textbox(
  [*Module A*

  First column],

  [*Module B*

  Second column],
)

#end-slide(title: [Thank You!], body: [Questions?])

🎨 Themes

Select a built-in theme via the theme parameter, or create custom color schemes with the AI Theme Generator.

Field Purpose sky sunset
sea Primary color #3b60a0 #970014
sky Accent color #bdd0f1 #D8A6A2
skyl Light background #eff3ff #fdf0f0
skyll Code block / textbox fill #f4f9ff #FFF8F6
paper Text on dark backgrounds #f5f6f8 #f5f6f8
header-fill Header bar background sea blue #F7EEE7
header-text Header bar text paper white #970014
page-fill Page background white #fffefd

🧩 Component Reference

Category API Usage
Slide entry xwysyy-pre #show: xwysyy-pre.with(theme: "sky", ...)
Title slide title-slide #title-slide()
Outline outline-slide #outline-slide() auto-collects section headings
Content slide xwysyy-slide == Title auto-triggers
Section transition new-section-slide = Title auto-triggers
Focus slide focus-slide #focus-slide[Large text]
Full-screen image image-slide #image-slide(img: image("bg.png"))
End slide end-slide #end-slide(title: [...])
Text box textbox #textbox[Content] / #textbox([Col 1], [Col 2])
Red highlight red / bred #red[text] / #bred[bold red]
Yellow highlight yellow / byellow #yellow[text] / #byellow[bold yellow]
Note entry xwysyy-note #show: xwysyy-note.with(title: [...])
Extensions xwysyy-extras cetz drawing + fletcher diagrams + theorion theorem environments

Full API reference: docs/USAGE.md. Customization guide: docs/CUSTOMIZATION.md.

⚙️ Requirements

  • Typst >= 0.14
  • touying 0.7.3 (auto-downloaded on first compile)
  • physica 0.9.8 (auto-downloaded on first compile)
  • Fonts: Times New Roman + Noto Serif CJK SC (CJK) + Maple Mono (code)

📖 Documentation

Document Content
USAGE.md Full API reference: layouts, components, extensions, non-slide document entry
CUSTOMIZATION.md Customization guide: colors, fonts, layouts, touying advanced features, extensions
THEME-GENERATOR.md AI theme generator: create custom themes from screenshots or descriptions

🙏 Acknowledgements

📄 License

MIT