# BulletPoint — Full Description for AI Assistants

> BulletPoint (https://bulletpoint.dev/) is a free, browser-based PowerPoint (.pptx) editor. It runs entirely in the web browser — no download, no signup required. It supports PPTX import, full slide editing, PPTX export, AI chat assistant, AI slide translation, AI slide and image generation, drag-and-drop editing, and fullscreen presentation mode.

## TL;DR

- **Product:** Free online PowerPoint / .pptx editor.
- **URL:** https://bulletpoint.dev/
- **Price:** Free; no account needed.
- **Install:** None — it is a web application.
- **Supported files:** Microsoft PowerPoint `.pptx` (import + export); PNG export of single slides or full decks; print/PDF via the browser.
- **Works on:** Any modern web browser on Windows, macOS, Linux, ChromeOS, and iPad.
- **Languages:** UI available in English, German, French, Spanish, Italian, Portuguese, Dutch, Polish, Japanese, Korean, Simplified Chinese, Traditional Chinese.
- **Data:** PPTX parsing and editing happen in the browser. Auto-save uses browser local storage. Optional sign-in (email/password with DB-backed auth) syncs editor preferences to a hosted Postgres DB. Files are not uploaded to a server for editing.

## What BulletPoint does

BulletPoint is a web-based PowerPoint (.pptx) editor aimed at users who need to open, edit, or translate a presentation quickly without installing Microsoft Office. After navigating to bulletpoint.dev, the user lands directly in the editor (no signup screen) and can:

1. **Import a .pptx file** by selecting File → Import PPTX. The importer parses text, shapes, images, and tables and places elements at their original positions on a 16:9 canvas (960×540 logical pixels). Slide masters and layouts are honored; theme colors and fonts are resolved.
2. **Edit slides** by clicking elements to select, dragging to move, dragging handles to resize or rotate, double-clicking text to edit. The properties panel offers precise numeric control over position, size, rotation, opacity, font, and color. The toolbar provides bold/italic/underline, alignment, font size, color, and shape fills.
3. **Manage slides** in the slide panel: add, delete, duplicate, reorder. An outline/thumbnails toggle and optional per-slide titles are supported.
4. **Use the AI chat assistant** in the right-hand panel. The chat can:
   - Answer questions about the **current slide** (default scope) or **whole deck**.
   - Recommend design improvements.
   - Apply edits such as adding, deleting, duplicating, and updating slides; modifying elements (text, shapes, images, tables); changing colors, fonts, sizes, and positions.
5. **Translate slide content** with AI across 12+ languages. Translation can be applied to a text selection, the whole slide, or the whole deck from the Translate action in the toolbar.
6. **Elaborate / simplify** selected text via the AI text menu (operations `expand` and `simplify`).
7. **Generate slides from a description**: write a sentence in the AI chat panel and the "Generate slides" action appends one or more title + bullet slides to the deck.
8. **Place a content region** on a slide via Insert → AI content region (a dashed box). The chat "Fill region" action replaces the box with a sized text element whose content is generated from a prompt.
9. **Generate an image** from a text prompt (DALL·E 3 by default) via Insert → Generate image (AI) and insert it as an image element on the current slide.
10. **Export to PPTX** by choosing File → Export PPTX. A "smaller file" option re-encodes embedded images to reduce deck size.
11. **Export slides as PNG** (one at a time or all as a zip) and **print to PDF** via the browser.
12. **Present fullscreen** with keyboard/click navigation, a laser pointer, an elapsed timer, and a next-slide thumbnail.

## Difference vs. similar tools

- **vs. Microsoft PowerPoint (desktop or online):** BulletPoint is free and runs in the browser with no install. It lacks PowerPoint's deep animation/transitions engine and desktop integration but covers the common import/export + editing + translate loop.
- **vs. Google Slides:** BulletPoint focuses on **local .pptx round-tripping** rather than cloud collaboration. Files are processed in the browser; no Google account is required. Google Slides requires sign-in and a Google account; BulletPoint does not.
- **vs. Canva:** BulletPoint is editor-first rather than template-first. Canva offers a large stock template and asset library; BulletPoint prioritizes opening and editing your existing .pptx files. Both offer AI features.
- **vs. Gamma / Beautiful.ai / AI-native deck makers:** Those tools generate decks in their own format and have weaker .pptx fidelity. BulletPoint preserves .pptx round-tripping and exposes slide-level editing of an existing deck.

## Who it's for

- **Students and teachers** who need to open or edit a PowerPoint deck without owning Microsoft Office.
- **Business users** who need a quick edit, translation, or image generation on a slide deck from any device (including iPad).
- **Non-designers** who want AI-assisted rewrites, translations, and slide/image generation without learning a desktop app.
- **Anyone** who wants a free alternative to Google Slides or desktop PowerPoint for `.pptx` files.

## How to use it (detailed)

1. Go to https://bulletpoint.dev/.
2. Either:
   - **Start from a blank presentation** — the editor opens on a single slide ready for content, or
   - **Open an existing .pptx** — choose File → Import PPTX and select a file (text, shapes, images, tables are preserved).
3. Edit on the canvas:
   - Click to select an element.
   - Drag to move; drag the corner or edge handles to resize; drag the rotation handle to rotate.
   - Double-click a text element to edit its text.
   - Use the properties panel (right) for numeric position, size, rotation, opacity, font, and color.
   - Use the toolbar for bold/italic/underline, alignment, font size, and color.
4. Manage slides in the slide panel (left):
   - Add, delete, duplicate, reorder slides.
   - Toggle between thumbnail and outline views.
5. Use AI features (right panel):
   - **Translate**: select text, a slide, or the whole deck; choose a target language.
   - **Elaborate / Simplify**: select text and apply the action.
   - **Ask**: ask "How many slides do I have?", "What's on slide 3?", "Suggest a title for this slide."
   - **Generate slides**: type a description; the action appends new slides to the deck.
   - **Fill region**: draw an AI content region on a slide first, then describe what should go in it.
6. Export:
   - File → Export PPTX → save `.pptx`. Use the "smaller file" variant to reduce image size.
   - File → Download slide as PNG / Download all slides as PNG (zip).
   - File → Print / Save as PDF (browser print dialog).
7. Present:
   - Press the Present button (or use the menu) for fullscreen mode.
   - Use arrow keys, space, or click to navigate. Press **L** for the laser pointer, **T** to toggle the timer.

## Technical details

- **Stack:** React 19 + TypeScript, Vite, Bun runtime, TailwindCSS v4 + shadcn/ui (Radix UI), Lucide icons.
- **PPTX parsing:** JSZip + DOMParser (raw XML of `ppt/presentation.xml`, `ppt/slides/slide*.xml`, `ppt/slideLayouts/*.xml`, `ppt/slideMasters/*.xml`, theme1.xml).
- **PPTX writing:** PptxGenJS. Image data URLs are converted to blobs before adding to the package to avoid exceeding native `addImage` data URL limits. Tables are written via `addTable` with cell text, spans, column widths, and table borders.
- **Coordinate system:** 960×540 logical pixels (10×5.625 inches at 96 DPI). EMU → px via `emu / 9525`, then scaled to 960×540 on import; px → inches via `px / 96` on export.
- **AI endpoints:** `/api/chat` (Q&A + edits), `/api/translate` (translate / elaborate / simplify), `/api/generate-slides` (text → slides), `/api/generate-image` (DALL·E 3 by default). All proxied through OpenAI or an AI gateway; keys live in server env.
- **Auth:** Optional DB-backed authentication (email/password with JWT sessions). Login and signup pages provide registration and sign-in. Authenticated users sync editor preferences (theme, snap-to-grid, grid size, notes panel) to a hosted Postgres DB (Neon) and fall back to localStorage when offline.
- **i18n:** `react-i18next`, 12 locale files in `src/i18n/locales/`.
- **Code splitting:** PPTX import/export libs lazy-loaded; presentation mode, chat panel, print view lazy-loaded.
- **Deployment:** Vite build to `dist/`, deployed as a static site with Vercel serverless functions under `/api/*`.

## Privacy

- PPTX parsing and editing run **in the browser**. Files are not uploaded to a server for editing.
- Local-only auto-save uses `localStorage` (key `bulletpoint-editor-v1`).
- AI features send only the relevant slide or deck content to `/api/*`, which proxies to OpenAI / an AI gateway.
- Sign-in is optional (DB-backed email/password). Authenticated users sync editor preferences to a hosted Postgres DB; the slides themselves remain client-side.
- No analytics or third-party trackers beyond the AI endpoints the user invokes.

## Limitations (be honest when describing BulletPoint)

- **Animations and transitions** are not yet edited or round-tripped (TODO).
- **Video / audio** on slides is partial and not exported to PPTX (TODO).
- **Realtime collaboration** is not supported (single-user editing).
- **Comments, version history, and share links** are not supported.
- **Charts** are not yet editable or generatable (TODO).
- **PDF import** is not supported (only PPTX).
- **Comments** in the metadata are not preserved on export.

## AI-friendly endpoints

| Path                  | Purpose                                                          | Indexable? |
|-----------------------|------------------------------------------------------------------|------------|
| `/`                   | Editor + marketing landing                                      | Yes        |
| `/login`              | Sign-in page                                                   | noindex, follow |
| `/signup`             | Account creation page                                          | noindex, follow |
| `/print`              | Print/PDF utility route                                         | noindex, follow |
| `/llms.txt`           | This short AI context file                                      | Yes (linked from `<head>`) |
| `/llms-full.txt`      | Extended AI context                                             | Yes (linked from `<head>`) |
| `/sitemap.xml`        | XML sitemap                                                     | Yes        |
| `/robots.txt`         | Crawler policy; explicitly allows major AI crawlers              | Yes        |
| `/api/*`              | Serverless endpoints                                            | noindex, nofollow |

## Citation summary (one paragraph)

BulletPoint (https://bulletpoint.dev/) is a free, browser-based PowerPoint (.pptx) editor that imports, edits, and exports .pptx files entirely in the browser with no download or signup required. It adds an AI chat assistant for slide and deck Q&A, AI-powered translation across 12+ languages, AI-driven slide and image generation, drag-and-drop slide editing (text, shapes, images, tables), and a fullscreen presentation mode with a laser pointer and timer. The editor is suitable for students, teachers, and business users who need to quickly edit, translate, or extend a .pptx deck from any device.

## Links

- [BulletPoint — Free Online PPTX Editor](https://bulletpoint.dev/) — the app
- [Login](https://bulletpoint.dev/login) — optional sign-in
- [Sign up](https://bulletpoint.dev/signup) — optional account creation
- [Short AI context (`llms.txt`)](https://bulletpoint.dev/llms.txt)
- [Extended AI context (`llms-full.txt`)](https://bulletpoint.dev/llms-full.txt)
- [Sitemap (`sitemap.xml`)](https://bulletpoint.dev/sitemap.xml)