From 4541cf1cdcd818ef62c661707dd02af525bda9ba Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Sat, 4 Jul 2026 18:06:45 +0200
Subject: [PATCH] Update from code changes: refresh builder guides for v5.2.0
(#3208)
* docs: refresh builder guides for v5.2.0 (undo/redo, version history, embedded AI, header downloads)
* docs: tighten SEO descriptions on v5.2.0 builder guides
---------
Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
---
docs/docs.json | 1 +
docs/guides/deleting-your-account.mdx | 25 ++++-
docs/guides/exporting-your-resume.mdx | 37 +++++---
docs/guides/importing-resumes.mdx | 20 ++--
.../managing-resumes-from-the-dashboard.mdx | 13 ++-
docs/guides/sharing-your-resume-publicly.mdx | 10 +-
.../undoing-changes-and-version-history.mdx | 94 +++++++++++++++++++
docs/guides/using-ai-in-the-builder.mdx | 20 ++--
docs/guides/using-ai.mdx | 10 +-
docs/guides/using-the-builder-dock.mdx | 68 ++++++++------
10 files changed, 229 insertions(+), 69 deletions(-)
create mode 100644 docs/guides/undoing-changes-and-version-history.mdx
diff --git a/docs/docs.json b/docs/docs.json
index 33ef7f614..659926d22 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -60,6 +60,7 @@
"guides/fitting-content-on-a-page",
"guides/adding-a-cover-letter",
"guides/using-the-builder-dock",
+ "guides/undoing-changes-and-version-history",
"guides/using-custom-styles",
"guides/using-ai-in-the-builder",
"guides/using-ai-agent",
diff --git a/docs/guides/deleting-your-account.mdx b/docs/guides/deleting-your-account.mdx
index 31afb5dee..2305fcfcc 100644
--- a/docs/guides/deleting-your-account.mdx
+++ b/docs/guides/deleting-your-account.mdx
@@ -1,8 +1,31 @@
---
title: "Deleting your account"
-description: "Learn how to permanently delete your Reactive Resume account and all associated data"
+description: "Export a full archive of your Reactive Resume data from the Danger Zone, then permanently delete your account, resumes, and settings."
---
+## Export all of your data
+
+Before you delete your account, you can download a copy of everything Reactive Resume stores for you.
+
+
+
+ In the dashboard sidebar, under **Settings**, click **Danger Zone**.
+
+
+
+ Reactive Resume gathers your account profile, resumes, and settings into a single archive and downloads it to your
+ browser.
+
+
+
+Keep this archive in a safe place — it's the easiest way to restore your resumes if you delete your account and later change your mind.
+
+## Delete your account
+
+
+ Deleting your account is permanent. Export a copy of your data first if you might need it later.
+
+
Head over to [https://rxresu.me](https://rxresu.me) and sign in with your account credentials.
diff --git a/docs/guides/exporting-your-resume.mdx b/docs/guides/exporting-your-resume.mdx
index c2ab28500..b74053e46 100644
--- a/docs/guides/exporting-your-resume.mdx
+++ b/docs/guides/exporting-your-resume.mdx
@@ -1,50 +1,55 @@
---
title: "Exporting your resume"
-description: "Learn how to export your resume as PDF, DOCX, or JSON from the builder."
+description: "Download your resume as a PDF, DOCX, or JSON file, or print it directly from the builder header, and learn when to pick each format."
---
-Reactive Resume can export your resume in three formats:
+Reactive Resume can export your resume in three formats and print it directly.
| Format | Best for |
| --- | --- |
| **PDF** | Job applications, recruiter emails, printing, and public resume downloads. |
| **DOCX** | Further editing in Microsoft Word, Google Docs, or another word processor. |
| **JSON** | Backups, restoring a resume later, importing into another Reactive Resume account, or sharing structured data with an AI assistant. |
+| **Print** | Sending directly to a printer or saving through the browser's print dialog. |
-## Export from the right sidebar
+## Download from the builder header
+
+The primary way to export is the **Download PDF** button in the builder header.
Go to the dashboard and open the resume you want to export.
-
- In the right sidebar, select **Export**.
+
+ The **Download PDF** button is in the top-right of the builder header, next to the sidebar toggle.
-
+
-
- Click **JSON**, **DOCX**, or **PDF**.
+
+ Open the dropdown next to **Download PDF** and pick **Download DOCX**, **Download JSON**, or **Print**.
- Your browser downloads the exported file using the resume name as the filename.
+ Your browser downloads the exported file using the resume name as the filename. **Print** opens your browser's print dialog instead.
-## Export from the builder dock
+
+ While an export is running, the button shows a spinner and is disabled until the file is ready.
+
-The floating dock at the bottom of the builder also includes quick download buttons for **JSON**, **DOCX**, and **PDF**.
+## Export from the right sidebar
-Use the dock when you already know which format you need. Use the right sidebar's **Export** section when you want the format descriptions next to each button.
+You can also export from the right sidebar's **Export** section, which lists each format with a short description.
-For more dock controls, see [Using the builder dock](/guides/using-the-builder-dock).
+Use the sidebar when you want the format descriptions next to each button. Use the header button when you already know which file you need.
## Export as PDF
@@ -89,6 +94,10 @@ JSON is also useful when working with AI assistants. You can export JSON, ask an
reflect your experience.
+## Print
+
+Choose **Print** to open your browser's print dialog with the current resume. Use this to print directly, or to save a copy through your browser's "Save as PDF" option when you need to bypass the built-in PDF export.
+
## Public resume downloads
If your resume is public, visitors can download a PDF from the public resume page. You can enable public access in the builder's **Sharing** section.
diff --git a/docs/guides/importing-resumes.mdx b/docs/guides/importing-resumes.mdx
index 5e58f25d7..0b3ce9f95 100644
--- a/docs/guides/importing-resumes.mdx
+++ b/docs/guides/importing-resumes.mdx
@@ -1,6 +1,6 @@
---
title: "Importing resumes"
-description: "Learn which file formats Reactive Resume can import and how to import an existing resume from the dashboard."
+description: "Import a resume from JSON, JSON Resume, PDF, or Microsoft Word files with automatic format detection from the Reactive Resume dashboard."
---
Reactive Resume can create a new resume from several existing file formats. Use import when you are moving from another tool, restoring a backup, or converting an older Reactive Resume file.
@@ -27,27 +27,29 @@ Reactive Resume can create a new resume from several existing file formats. Use
Sign in and go to **Dashboard -> Resumes**.
-
- Select the **Import an existing resume** card.
+
+ Click the **Import** card (or the header button if you already have resumes).
-
- Pick the format that matches your file.
-
+
+ Select the resume file from your computer. Reactive Resume detects the format automatically from the file's contents
+ and shows the matching import type.
-
- Click the file selector and choose the resume file from your computer.
+ If auto-detection is uncertain, or you want to force a specific format, adjust the import type manually before continuing.
Click **Import**. Reactive Resume creates a new resume and opens it in the builder when the import succeeds.
+
+ For PDF and Microsoft Word files, the dialog checks that you have a working AI provider configured before it starts.
+ If none is available, you'll get a link to **Integrations** to set one up.
diff --git a/docs/guides/managing-resumes-from-the-dashboard.mdx b/docs/guides/managing-resumes-from-the-dashboard.mdx
index e393c23dd..c404c3023 100644
--- a/docs/guides/managing-resumes-from-the-dashboard.mdx
+++ b/docs/guides/managing-resumes-from-the-dashboard.mdx
@@ -1,6 +1,6 @@
---
title: "Managing resumes from the dashboard"
-description: "Learn how to sort, filter, open, duplicate, lock, update, and delete resumes from the Resumes dashboard."
+description: "Search, sort, filter, open, duplicate, lock, update, and delete resumes from the Reactive Resume Resumes dashboard in grid or list view."
---
The **Resumes** dashboard is where you manage every resume in your account. Use it to keep separate versions for different roles, clients, locations, or application stages.
@@ -12,6 +12,12 @@ The **Resumes** dashboard is where you manage every resume in your account. Use
/>
+## Search your resumes
+
+Once you have more than a few resumes, a **Search** field appears above the list. Type any part of a resume name to filter the dashboard in place.
+
+You can also open the command palette from anywhere in the app with `Cmd/Ctrl+K`, or by clicking **Search** in the dashboard sidebar, to jump to a resume by name.
+
## Choose a view
The dashboard supports two views:
@@ -58,6 +64,11 @@ Click a resume card or row to open it in the builder.
You can also open the resume menu and choose **Open**.
+
+ After you create or import a resume, Reactive Resume opens it directly in the builder instead of returning you to the
+ dashboard.
+
+
## Update name, slug, and tags
Use **Update** when you want to change a resume's metadata.
diff --git a/docs/guides/sharing-your-resume-publicly.mdx b/docs/guides/sharing-your-resume-publicly.mdx
index 02a627d21..8edab806d 100644
--- a/docs/guides/sharing-your-resume-publicly.mdx
+++ b/docs/guides/sharing-your-resume-publicly.mdx
@@ -1,6 +1,6 @@
---
title: "Sharing your resume publicly"
-description: "Learn how to share your resume via a public URL, track public engagement, and optionally protect your resume with a password."
+description: "Publish your resume at a public URL, share it with recruiters, track views and downloads, and optionally protect it with a password."
---
Reactive Resume lets you share your resume via a **public URL** that anyone can access. When you make your resume public, it becomes available at a unique link that you can share with human recipients such as recruiters, collaborators, or portfolio visitors. Public resume URLs are not search-indexed by default.
@@ -65,8 +65,9 @@ When someone visits your public resume URL:
1. **They see the live version** - The page renders your current resume data with all your latest changes
2. **No account required** - Visitors don't need a Reactive Resume account to view or download your resume
-3. **They can download a PDF** - Visitors can use the download button on the public page
-4. **Views are tracked** - Visits are counted in your resume statistics (see below)
+3. **They can download a PDF** - The public page shows an identity header with your name, headline, and picture, and a prominent **Download PDF** action
+4. **Link previews look right** - Reactive Resume generates per-resume Open Graph and Twitter card previews, so links you paste into LinkedIn, Slack, iMessage, and similar apps show your name and headline instead of a generic placeholder
+5. **Views are tracked** - Visits are counted in your resume statistics (see below)
Changes you make in the builder are reflected immediately on the public URL. There's no separate "publish" step—your
@@ -86,8 +87,11 @@ You'll see public view information such as:
| Metric | Description |
| ------------------- | ---------------------------------------------------------------- |
| **Views** | Number of times your public resume page was visited |
+| **Downloads** | Number of times a visitor downloaded your resume as a PDF |
| **Last viewed** | The date when your resume was last viewed |
+Each metric also shows a 30-day sparkline and the change compared to the previous period, so you can spot whether interest is rising or falling after you share the link.
+
Statistics are only shown after public sharing is enabled. If you turn off public access, existing stats are
preserved.
diff --git a/docs/guides/undoing-changes-and-version-history.mdx b/docs/guides/undoing-changes-and-version-history.mdx
new file mode 100644
index 000000000..874565a41
--- /dev/null
+++ b/docs/guides/undoing-changes-and-version-history.mdx
@@ -0,0 +1,94 @@
+---
+title: "Undoing changes and version history"
+description: "Undo and redo edits with keyboard shortcuts in the Reactive Resume builder, and restore an earlier snapshot from the version history menu."
+---
+
+Reactive Resume keeps two layers of change history for every resume:
+
+- **Undo and redo** — a live timeline of the changes you've made in the current builder session.
+- **Version history** — server-side snapshots taken at meaningful moments, kept even after you close the builder.
+
+Use undo for a quick correction. Use version history to jump back to a template switch, an import, or an AI edit you made earlier.
+
+## Undo and redo
+
+Every change in the builder is undoable — typing, drag-and-drop reordering, template and layout switches, and edits applied by the AI assistant.
+
+
+
+ Undo history is scoped to the resume you have open.
+
+
+
+ Use either the toolbar buttons on the floating dock or a keyboard shortcut:
+
+ | Shortcut | Action |
+ | --- | --- |
+ | `Cmd/Ctrl+Z` | Undo the last change |
+ | `Cmd/Ctrl+Shift+Z` | Redo the last undone change |
+
+ Rapid typing collapses into a single step, so undo feels natural.
+
+
+
+
+ When your cursor is inside a text field, `Cmd/Ctrl+Z` falls back to your browser's native input undo, so you can undo
+ just the characters you typed. Click outside the field, or use the dock buttons, to undo builder-wide changes such as
+ a template switch.
+
+
+Undo history lives in your browser for the current session. Reloading the builder clears it — use version history for longer-range recovery.
+
+## Version history
+
+Reactive Resume automatically snapshots your resume at key moments:
+
+- when you import a resume;
+- when you switch templates;
+- when the AI assistant applies edits;
+- on periodic saves during editing.
+
+Snapshots are stored on the server, per resume, and are kept across sessions.
+
+### Open version history
+
+Click the **clock** icon in the builder header, next to the resume name, to open the version history menu.
+
+The menu lists recent snapshots newest first, each with a label describing what triggered it and a relative timestamp such as *2 hours ago*.
+
+### Restore a version
+
+
+
+ Click the clock icon in the builder header.
+
+
+
+ Select the entry you want to restore. Reactive Resume asks you to confirm before replacing the current data.
+
+
+
+ The resume is updated to the snapshot's contents and reloads in the preview.
+
+
+
+Restoring is **non-destructive**: it writes the older snapshot back through the normal update path, so:
+
+- your previous versions are still listed in the menu;
+- the restore itself becomes a new snapshot;
+- if you change your mind, you can restore the pre-restore version, or press `Cmd/Ctrl+Z` to undo the restore.
+
+
+ Only the resume owner can list or restore versions. A locked resume cannot be edited or restored until you unlock it
+ from the dashboard.
+
+
+## Which to use when
+
+| Situation | Use |
+| --- | --- |
+| You typed a wrong word or moved an item you didn't mean to. | Undo (`Cmd/Ctrl+Z`) |
+| You just switched templates and want the old one back. | Undo, or version history if you've kept editing since. |
+| You imported a resume and want to compare with what you had before. | Version history |
+| The AI assistant applied edits you no longer want. | Undo the batch, or restore the pre-AI snapshot. |
+| You closed the browser and want to roll back yesterday's changes. | Version history |
diff --git a/docs/guides/using-ai-in-the-builder.mdx b/docs/guides/using-ai-in-the-builder.mdx
index 2320a3309..8602aedfe 100644
--- a/docs/guides/using-ai-in-the-builder.mdx
+++ b/docs/guides/using-ai-in-the-builder.mdx
@@ -1,12 +1,12 @@
---
title: "Using AI in the builder"
-description: "Learn how to run resume analysis and use the AI Resume Assistant to review proposed resume changes before applying them."
+description: "Run AI-powered resume analysis and chat with the built-in AI assistant in the builder to review proposed resume changes before applying them."
---
Reactive Resume includes two AI-assisted builder workflows:
- **Resume Analysis** gives you a score, strengths, and prioritized suggestions.
-- **AI Resume Assistant** proposes specific edits that you can accept or reject.
+- The **AI assistant** opens as a side panel in the builder, scoped to the open resume, so you can chat and apply edits inline.
These features require a tested and enabled AI provider in **Dashboard -> Settings -> Integrations**. For setup, see
@@ -44,13 +44,19 @@ Use resume analysis when you want a broad review before making changes.
Use the analysis as guidance, not as a final verdict. The best resume still depends on the job, industry, and audience.
-## Open the AI Resume Assistant
+## Open the AI assistant
-Click the assistant button in the builder dock to open the assistant.
+Click the **Sparkle** button in the builder header, next to the resume name, to open the assistant.
-On desktop, the assistant opens as a movable, resizable panel. On smaller screens, it opens as a full-height sheet.
+The assistant opens as a side panel next to your resume. It uses the same chat interface as the AI Agent workspace, but stays scoped to the resume you are editing — its edits land in the builder immediately, appear in the preview, and are captured in undo history and version history.
-If AI is unavailable, the builder shows a link to **Integrations** so you can configure it.
+If AI is unavailable, the panel shows a link to **Integrations** so you can configure a provider.
+
+
+ The Sparkle button is the in-builder assistant. The chat-bubble icon on the floating dock opens the full **AI Agent**
+ workspace in a new page — useful for longer, standalone conversations that create their own draft. See [Using the AI
+ Agent Workspace](/guides/using-ai-agent).
+
## Ask for targeted changes
@@ -81,6 +87,8 @@ You can:
- move between proposals with **Prev** and **Next**;
- **Accept all** or **Reject all** from the split-button menu.
+Accepted edits are saved through the normal update path, so they show up in the preview, in undo history, and in version history. If you change your mind, use `Cmd/Ctrl+Z` or restore an earlier snapshot from the clock menu — see [Undoing changes and version history](/guides/undoing-changes-and-version-history).
+
Review AI proposals before accepting them. AI can introduce wording that is inaccurate, too generic, or not aligned
with your actual experience.
diff --git a/docs/guides/using-ai.mdx b/docs/guides/using-ai.mdx
index fd02ad3d7..eff42d11b 100644
--- a/docs/guides/using-ai.mdx
+++ b/docs/guides/using-ai.mdx
@@ -1,6 +1,6 @@
---
title: "Using Artificial Intelligence"
-description: "Learn how to configure an AI provider for AI-assisted features in Reactive Resume."
+description: "Configure an OpenAI, Anthropic, Gemini, OpenRouter, or Ollama provider to power resume analysis, AI edits, agent drafts, and PDF imports."
---
Reactive Resume uses AI providers for features such as resume analysis, AI-assisted resume changes, AI agent drafts, and PDF or Word imports.
@@ -26,17 +26,17 @@ Reactive Resume uses AI providers for features such as resume analysis, AI-assis
## Add a provider
-In the **AI Providers** section, fill out the **Add Provider** form.
+In the **AI Providers** section, fill out the **Add Provider** form. The form is staged: pick a **Provider** and paste an **API Key** first — advanced options like **Model** and **Base URL** are collapsed behind an **Advanced settings** toggle and only need changing for gateways, proxies, local providers, or OpenAI-compatible endpoints.
| Field | Description |
| --- | --- |
| **Label** | A name that helps you recognize the provider, such as `Work OpenAI` or `Personal OpenRouter`. |
| **Provider** | The provider type, such as OpenAI, Anthropic Claude, Google Gemini, Vercel AI Gateway, OpenRouter, Ollama, or OpenAI-compatible. |
-| **Model** | The exact model name expected by that provider. |
-| **Base URL** | The provider endpoint. Leave the default unless you use a gateway, proxy, local provider, or OpenAI-compatible endpoint. |
| **API Key** | The key Reactive Resume should use when sending AI requests to that provider. |
+| **Model** *(advanced)* | The exact model name expected by that provider. |
+| **Base URL** *(advanced)* | The provider endpoint. Leave the default unless you use a gateway, proxy, local provider, or OpenAI-compatible endpoint. |
-Click **Save Provider** when the form is complete.
+Click **Save Provider** when the form is complete. Reactive Resume tests the connection automatically as part of the save, so you'll see a success or failure status immediately without a separate click.
![]()
-## Preview controls
+## Undo and redo
-Use the left side of the dock to control the preview.
+The dock starts with **Undo** and **Redo** buttons. They apply to every change in the builder — typing, drag-and-drop, template switches, layout changes, and AI edits.
+
+You can also use keyboard shortcuts:
+
+| Shortcut | Action |
+| --- | --- |
+| `Cmd/Ctrl+Z` | Undo the last change |
+| `Cmd/Ctrl+Shift+Z` | Redo the last undone change |
+
+Rapid typing collapses into a single undo step, so undo feels natural.
+
+
+ When your cursor is inside a text field, the shortcut falls back to your browser's native input undo. Click outside the
+ field, or use the dock buttons, to undo builder-wide changes.
+
+
+For longer-range recovery — such as jumping back to a template switch, an import, or an AI edit — see [Undoing changes and version history](/guides/undoing-changes-and-version-history).
+
+## Zoom controls
+
+Use the zoom controls to adjust the preview.
| Control | What it does |
| --- | --- |
-| **Zoom in** | Increases the preview zoom. |
| **Zoom out** | Decreases the preview zoom. |
-| **Center view** | Re-centers the resume preview in the canvas. |
-| **Toggle page stacking** | Switches between stacked pages and side-by-side pages. |
+| **Zoom level (%)** | Shows the current zoom. Opens a menu with **Actual size (100%)** and **Fit to view**. |
+| **Zoom in** | Increases the preview zoom. |
-These controls only affect the editor preview. They do not change the exported PDF, DOCX, or JSON file.
+Press `Cmd/Ctrl+0` to reset the zoom to fit.
-## Open the AI assistant
+Zoom only affects the editor preview. It does not change the exported PDF, DOCX, or JSON file.
-Click the assistant button to open or close the **AI Resume Assistant**.
+## Toggle page stacking
-The assistant can propose targeted resume changes, such as rewriting a summary, tightening bullet points, adding metrics, or tailoring the resume to a job description. You review proposed changes before they are applied.
+Use the page-stacking button to switch between stacked pages (vertical) and side-by-side pages (horizontal). This only affects the editor preview.
-
- The assistant requires a tested and enabled AI provider. See
- [Using Artificial Intelligence](/guides/using-ai) for setup and [Using AI in the builder](/guides/using-ai-in-the-builder)
- for the builder workflow.
-
+## Open the AI Agent
+
+Click the chat button to open the **AI Agent** workspace in a new page, pre-scoped to the current resume. Use the agent for larger, standalone conversations that create their own draft.
+
+For chatting about the open resume without leaving the builder, use the AI assistant in the builder header instead. See [Using AI in the builder](/guides/using-ai-in-the-builder).
## Copy the public URL
@@ -52,17 +71,6 @@ https://rxresu.me/{username}/{slug}
the **Sharing** section of the right sidebar.
-## Download files from the dock
+## Downloading your resume
-The dock includes quick download buttons for:
-
-- **JSON** for backups, imports, and structured data workflows;
-- **DOCX** for editing in Microsoft Word or Google Docs;
-- **PDF** for sharing, uploading, and printing.
-
-These are the same export formats available in the right sidebar's **Export** section.
-
-
- Use the dock when you already know which file you need. Use the right sidebar's **Export** section when you want the
- format descriptions next to each button.
-
+Downloads are no longer on the dock. Use the primary **Download PDF** button in the builder header, or open the dropdown next to it for **DOCX**, **JSON**, and **Print**. See [Exporting your resume](/guides/exporting-your-resume).