<p align="center"> <img src='/public/logo.png' /> </p>

简体中文 | English

🎨 PPTist

PowerPoint-ist（/'pauəpɔintist/）, A web-based presentation (slideshow) application. This application replicates most of the commonly used features of Microsoft Office PowerPoint. It supports various essential element types such as text, images, shapes, lines, charts, tables, videos, audio, and formulas. You can edit and present slides directly in a web browser.

Try it online👉：https://pipipi-pikachu.github.io/PPTist/

China Mirrors (Synchronized Regularly): Gitee、GitCode

✨ Highlights

1. Easy Development: Built with Vue 3.x and TypeScript, it does not rely on UI component libraries, making styling customization easier and functionality extension more convenient.
2. User Friendly: It offers context menus everywhere, dozens of shortcut operations, and continuously refined editing details, striving to replicate a desktop application-level experience.
3. Feature Rich: Supports most commonly used Office PPT elements and features, supports template-based AIPPT, supports exporting in various formats, and offers basic editing and previewing on mobile devices.
4. Controllable Code: Not a temporary product of vibe coding. The code is robust, controllable, easy to maintain, and leaves no technical debt.

👀 Front-Row Reminder

1. The target audience for this project is developers with web slide development needs and basic web development experience. The provided link is for demonstration purposes only and does not offer any online services. This project should not be used directly as a tool, nor does it support out-of-the-box use. If you simply need a ready-made service or tool, please consider other products.
2. Here are some summarized Frequently Asked Questions. When raising Issues or submitting PRs for the first time, be sure to read this document in advance.
3. For commercial use, please refer to 商业用途

🧩 Project Positioning

The core positioning of this project is a Web Slide Editing/Presentation Application. The following are the recommendation levels for common use cases:

• Low-code Platforms / H5 Editors / Image Editors / Whiteboards (Recommendation: Not Recommended): We suggest choosing open-source projects that better match those scenarios.
• AI PPT Generation Tool (Recommendation: ⭐⭐): This project supports a template-based AIPPT generation approach, and also provides a data structure definition for AI to directly generate page data. See AI_PPT_SCHEMA.md. In theory, it supports non-template PPT generation, where AI directly generates PPTist data. Note that the final result of AIPPT depends heavily on model capabilities, prompt design, asset generation/retrieval, and other factors. PPTist is better suited as a foundation for carrying, editing, and further processing structured generation results, rather than an out-of-the-box complete AIPPT commercial solution.
• PPT File Preview Tool (Recommendation: ⭐⭐): This project supports importing PPTX files and can cover many common page contents and styles (roughly 85%+ fidelity overall), making it suitable for online preview, lightweight review, and content browsing. However, because the PPTX ecosystem is complex, animations, special charts, deeply nested structures, non-standard elements, and some advanced styles may inevitably have fidelity differences. If your business requires pixel-perfect fidelity, evaluate with your actual sample files.
• Office PPT Authoring Tool (Recommendation: ⭐⭐): This project supports many common Office PPT features and can import/export local PPTX files, making it usable as a foundation for online authoring and editing. Note that full Office PPT compatibility involves many details, including complex layouts, animations, charts, themes, and masters. Some details will inevitably be lost during file import/export, so 100% fidelity cannot be guaranteed. If your core goal is to fully replace Microsoft PowerPoint, evaluate and make trade-offs with your actual business documents.
• Web Slide Editing/Presentation App (Recommendation: ⭐⭐⭐⭐⭐): This is the most recommended scenario. The core strengths of PPTist are its editing capabilities and editing experience. You can build upon this project to customize or add unique nodes and features according to your needs, without using import/export as the ultimate goal. After all, those customized things do not exist in Office PPT. Summary: I hope you use PPTist to build a presentation product different from Office PPT, rather than just an editing relay station for Office PPT.

🚀 Installation

node.js version >= 20

npm install

npm run dev

Browser access: http://127.0.0.1:5173/

📚 Features

Basic Features

• History (undo, redo)
• Shortcuts
• Right-click menu
• Import: PPTX (overall fidelity ~80%+), JSON, pptist files
• Export: PPTX (overall fidelity ~95%+), JSON, images, PDF (print), pptist files
• Template-based AI PPT generation

Slide Page Editing

• Add/delete pages
• Copy/paste pages
• Adjust page order
• Create sections
• Background settings (solid color, gradient, image)
• Set canvas size
• Gridlines
• Rulers
• Canvas zoom and move
• Theme settings
• Extract slides style
• Speaker notes (rich text)
• Slide templates
• Transition animations
• Element animations (entrance, exit, emphasis)
• Selection panel (hide elements, layer sorting, element naming)
• Labels for Page and Node Types (usable for template-related features)
• Find/replace
• Annotations

Slide Element Editing

• Add/delete elements
• Copy/paste elements
• Drag and move elements
• Rotate elements
• Scale elements
• Multiple element selection (marquee, point selection)
• Group multiple elements
• Batch edit multiple elements
• Lock elements
• Magnetic alignment of elements (move and scale)
• Adjust element layer
• Align elements to canvas
• Align elements to other elements
• Evenly distribute multiple elements
• Drag to add text and images
• Paste external images
• Set element coordinates, size, and rotation
• Element hyperlinks (link to webpage, link to other slide pages)
• Element bubble menu (Floating toolbar)

Text

• Rich text editing (color, highlight, font, font size, bold, italic, underline, strikethrough, subscript, inline code, quote, hyperlink, alignment, numbering, bullet points, paragraph indent, clear formatting)
• Line height
• Character spacing
• Paragraph spacing
• First line indent
• Fill color
• Border
• Shadow
• Transparency
• Vertical text
• Text box margins
• Auto-fit/fixed height (vertical alignment can be selected when fixed)
• AI Rewrite/Expand/Abbreviate

Images

• Crop (custom, shape, aspect ratio)
• Rounding
• Filters
• Tint (mask)
• Flip
• Border
• Shadow
• Replace image
• Reset image
• Set as background

Shapes

• Freehand draw any polygon
• Freehand draw any line (unclosed shape simulation)
• Visual path creation method
• Replace shape
• Fill (solid color, gradient, image)
• Border
• Shadow
• Transparency
• Flip
• Shape format painter
• Edit text (supports rich text, similar to text element’s rich text editing)
• Text box margins
• Text vertical alignment

Lines

• Straight lines, polylines, curves
• Color
• Width
• Style (solid, dashed, dotted)
• Endpoint style

Charts (bar, column, line, area, scatter, pie, donut, radar)

• Chart type conversion
• Data editing
• Background fill
• Theme color
• Coordinate system and axis text color
• Grid color
• Other chart settings
• Border

Tables

• Add/delete rows and columns
• Theme settings (theme color, header, total row, first column, last column)
• Merge cells
• Cell styles (fill color, text color, bold, italic, underline, strikethrough, alignment)
• Border

Video

• Preview cover settings
• Auto play

Audio

• Icon color
• Auto play
• Loop play

Formulas

• LaTeX editing
• Color settings
• Formula line thickness settings

Slide Show

• Brush tools (pen/shape/arrow/highlighter annotation, eraser, blackboard mode)
• Preview all slides
• Bottom thumbnails navigation
• Timer tool
• Laser pointer
• Auto play
• Speaker view
• Audience view

Mobile

• Basic editing
  • Add/delete/copy/note/undo redo pages
  • Insert text, images, rectangles, circles
  • General element operations: move, scale, rotate, copy, delete, layer adjust, align
  • Element styles: text (bold, italic, underline, strikethrough, font size, color, alignment), fill color
• Basic preview
• Play preview

👀 FAQ

Some common problems: FAQ

🎯 Supplement

There is currently no complete development documentation, but the following documents may be of some help to you:

• Project Directory and Data Structure
• Fundamentals of Canvas and Elements
• How to Customize an Element
• About AIPPT

Here are some auxiliary development tools/repositories:

• Import PPTX file reference: pptxtojson
• Draw shape: [svgPathCreator](https:/