slidev-addon-audience-filter

A Slidev addon that filters slides based on the target audience. Use showFor and hideFor frontmatter properties to control which slides are visible for which audience.

Features

• Audience-based filtering: Show or hide slides based on the active audience
• Flexible configuration: Set audience via environment variable or headmatter
• Bypass mode: Disable filtering for IDE editing with AUDIENCE=bypass
• Comma-separated or array syntax: Supports both formats for audience lists

Installation

npm install slidev-addon-audience-filter

Usage

1. Wire up the preparser in your project

Important: Slidev applies the preparser from the project root on the initial load only. Addon preparsers are resolved too late to filter the first render, so the entry point must live in your project. Create setup/preparser.ts in your Slidev project:

import {createAudienceFilterPreparser} from 'slidev-addon-audience-filter'

export default createAudienceFilterPreparser()

After creating or changing setup/preparser.ts, fully stop and restart the dev server (a hot reload is not enough for preparser changes).

You do not need to add this package to the addons: list — the setup/preparser.ts stub above is what activates the filter.

2. Set the active audience

Option A: Environment variable (recommended for CLI)

AUDIENCE=live slidev

Option B: Headmatter in slides.md

---
audience: live
---

3. Mark slides with showFor or hideFor

---
showFor: live
---

# This slide is only visible for the "live" audience

---
hideFor: beginners
---

# This slide is hidden from "beginners" but visible to everyone else

---
showFor: architects,leads
---

# This slide is visible for "architects" and "leads"

How It Works

1. The addon reads the active audience from the AUDIENCE environment variable or the audience headmatter field
2. For each slide, it checks the showFor and hideFor frontmatter properties
3. If a slide has hideFor and the active audience matches, the slide is disabled
4. If a slide has showFor and the active audience does NOT match, the slide is disabled
5. Slides without showFor or hideFor are always visible

Priority

1. AUDIENCE environment variable (highest priority)
2. audience headmatter field
3. No audience set = no filtering (all slides visible)

Bypass Mode

Set AUDIENCE=bypass to disable all filtering. This is useful when editing slides in an IDE:

AUDIENCE=bypass slidev

Audience List Syntax

Both comma-separated strings and arrays are supported:

# Comma-separated
showFor: architects,leads

# Array
showFor:
  - architects
  - leads

Values are case-insensitive and trimmed automatically.

License

MIT

Author

Denis Sowa

Contributing

Contributions are welcome! Please open an issue or pull request on GitHub.