Back to the catalog

slidev

Create and manage Slidev presentations directly from Gemini CLI.

Open source Open in the app JSON README (API)

About

Create and manage Slidev presentations directly from Gemini CLI.

Details

Kind
Plugins
Topic
AI, RAG & memory
Publisher
qiangua
Origin
gemini
Category
ferramentas
Version
0.3.1
Stars
5
Forks
1
Open pull requests
1
Last push
2025-12-26T17:58:34Z
Repository state
ativo
License
MIT
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
qiangua/gemini-slidev-extension

README

# Slidev - Gemini CLI Extension

A professional Gemini CLI extension for creating, editing, and managing [Slidev](https://sli.dev/) presentations—Markdown-based slides for developers.

## ✨ Features

- **⚡ Instant Setup**: Initialize new Slidev projects with best practices and theme selection.
- **📝 Intelligent Generation**: Create full slide decks with optimal layouts (`two-cols`, `image-right`), animations (`<v-click>`), and speaker notes.
- **🎨 Smart Editing**: Modify slides using UnoCSS utility classes and refined component usage.
- **➕ Seamless Addition**: Insert new slides intelligently into existing decks.
- **📤 Production Export**: Export to PDF/PNG with support for animation steps (`--with-clicks`).
- **▶️ Dev Server**: Integrated control for starting the local preview server.

## 📋 Prerequisites

1. **Gemini CLI** installed and configured
2. **Node.js 18+** and npm/pnpm/yarn
3. **Slidev** (will be installed automatically in new projects)

## 🚀 Installation

### 1. Install Extension

Install the extension using the `gemini extensions install` command:

```bash
gemini extensions install https://github.com/QIanGua/gemini-slidev-extension
```

### 2. Activate

Restart the Gemini CLI. The following commands will be available:

- `/init` - Initialize a new Slidev project
- `/generate` - Generate complete slide decks from topics
- `/add` - Add new slides with specific layouts
- `/edit` - Refine content and styles
- `/export` - Export presentation to PDF/PNG
- `/run` - Start the local development server
- `/slidev` - Main entry point and help

## 💡 Usage

The extension provides a suite of commands for the entire presentation lifecycle:

### 🎯 Specific Commands (Recommended)

**Initialize Project:**

```bash
/init
# "Initialize a new project with the 'seriph' theme"
```

**Generate Content:**

```bash
/generate "Deep Learning Fundamentals"
# Generates a structured deck with cover, intro, key concepts, and summary
```

**Add Slides:**

```bash
/add "Comparison of React vs Vue"
# Adds a 'two-cols' layout slide comparing the frameworks
```

**Edit & Refine:**

```bash
/edit "Make the title on slide 3 bigger and red"
# Applies 'text-4xl text-red-500' classes using UnoCSS
```

**Export:**

```bash
/export --format pdf --with-clicks
# Exports a PDF including all animation steps
```

**Run Server:**

```bash
/run
# Starts the dev server at http://localhost:3030
```

### 🌟 Natural Language Command (Flexible)

**Open-ended prompts:**

```bash
/slidev I need a presentation about Rust programming language for beginners
/slidev Add a slide with a code block showing a Hello World example in Python
/slidev Export the current deck to PNG
```

## 🔧 Technical Details

### Core Principles

This extension adheres to strict quality standards defined in `GEMINI.md`:

- **Markdown-Centric**: Treats `slides.md` as the source of truth.
- **Component-Driven**: leverages Slidev's built-in layouts and Vue components.
- **Progressive Disclosure**: Smart use of animations to control information flow.

### Configuration

The extension automatically handles:

- YAML Frontmatter validation
- Component syntax checking
- Asset path resolution

## 🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

## 📄 Legal

- **License**: [Apache License 2.0](LICENSE)

More