# Amaroad

> Amaroad is an open-source, AI-first slide authoring and refinement tool for developers. Create, revise, and share presentation decks from the terminal using AI coding agents like Claude Code, Codex CLI, Gemini CLI, or Cursor.

## Key Facts

- License: MIT (free and open source)
- Author: CORe Inc.
- Repository: https://github.com/co-r-e/amaroad
- Website: https://amaroad.com/
- Documentation: https://amaroad.com/docs/getting-started/introduction

## What Amaroad Does

Amaroad lets developers create slide presentations without leaving the terminal. Slides are written as MDX files (Markdown + React components) and rendered in real-time with hot module replacement. AI agents generate and edit slides, and multiple slides can be revised in parallel by spawning subagents.

## Core Features

- AI-first workflow: prompt your coding agent to generate entire decks
- Per-slide parallel editing: spawn one agent per slide for concurrent revisions
- 30+ built-in MDX components: charts, layouts, timelines, cards, icons, shapes
- 12 slide types: cover, section, content, comparison, stats, timeline, image-left, image-right, image-full, quote, agenda, ending
- 20+ showcase templates for common presentation patterns
- Live reload via Next.js HMR
- PDF and PPTX export from the browser
- Cloudflare Tunnel sharing for real-time collaboration
- 14 built-in Claude Code agent skills (deck design, image generation, SVG diagrams, video export, localization, QA audits)

## Tech Stack

- Next.js 16 (App Router)
- React 19
- MDX for slide content
- Recharts for data visualization
- Tailwind CSS for styling
- jsPDF + pptxgenjs for export
- Cloudflare Tunnel for sharing
- Gemini API for image generation

## Documentation

- [Getting Started](https://amaroad.com/docs/getting-started/introduction)
- [Installation](https://amaroad.com/docs/getting-started/installation)
- [Quick Start](https://amaroad.com/docs/getting-started/quick-start)
- [Creating Decks](https://amaroad.com/docs/guides/creating-decks)
- [Parallel Editing](https://amaroad.com/docs/guides/parallel-editing)
- [Agent Skills](https://amaroad.com/docs/guides/agent-skills)
- [Sharing & Presenting](https://amaroad.com/docs/guides/sharing)
- [Theme Customization](https://amaroad.com/docs/guides/theme-customization)
- [Components](https://amaroad.com/docs/components/overview)
- [Configuration](https://amaroad.com/docs/reference/configuration)
- [CLI Commands](https://amaroad.com/docs/reference/cli-commands)
- [Export Options](https://amaroad.com/docs/reference/export)
- [Keyboard Shortcuts](https://amaroad.com/docs/reference/keyboard-shortcuts)