Slidev and demo mode

Inalia provides generated question output for presentation integrations, including Slidev. This article describes the concepts and output available in this application; it is not a complete addon installation guide.

Question output

Use a question's output controls to choose HTML, JSON, or YAML.

Before the talk is finished, the output references the question number for live use. For example, HTML output for question 1 is:

<Inalia
  questionId="1"
/>

This component requires a compatible Inalia presentation integration; pasting it into an arbitrary slide deck is not sufficient.

Finished-talk snapshots

Once a talk is finished, generated output includes the question, type, chart where applicable, and saved result data instead of just a live reference.

Generate and copy the output again after finishing if you want the static snapshot. Previously copied snippets do not rewrite themselves.

Text snapshots include the submitted text. Review that content before publishing a deck or committing its output to a public repository.

Access tokens

Create a named token from your account's token settings.

The official Slidev add-on needs only VITE_INALIA_API_KEY and VITE_INALIA_TALK_NUMBER for a live connection. It automatically retrieves your username from the token. Self-hosted backends must support GET /api/me before updating the add-on.

• read retrieves talks and questions.
• write, alongside read, can run talks and change demo mode.

Copy a new token when it is shown and store it securely. Never put it in public slide source or browser-delivered code. Delete tokens you no longer use.

Integration requests still require an eligible, verified account and access to the requested talk.

Choose a talk for a Slidev deck

After installing the official add-on and enabling it in slides.md, run npx slidev-addon-inalia select-talk in your Slidev project (Node.js 20.12+). It lists all talks belonging to your account by title and number. Choose one to save its talk number and token in the project's .env without removing unrelated settings.

The command reuses credentials from your shell environment or .env, prompting if they are missing. A dedicated read token is sufficient. It does not read user-wide ~/.inaliarc settings. Cancelling, a failed request, or having no talks leaves the file unchanged. Restart Slidev after selecting a talk.

Keep .env out of source control. The current add-on sends its token from browser-side code, so do not publicly host a live-configured deck. See Your first Slidev integration for setup and security guidance.

Demo mode

Demo mode is a per-talk setting controlled through the integration API.

It lets participation events be demonstrated without saving new poll answers, audience questions, feedback messages, or feedback reactions.

It does not erase data already collected. It also does not bypass the talk's running state or feature requirements.

Voting and audience-question highlighting are unavailable in demo mode. Disable demo mode before a real session; otherwise participation may appear live without being saved.

A duplicated talk inherits the original's demo-mode setting, so review it before presenting.