🎬 A browser extension and desktop app that turns your clicks into step-by-step guides with annotated screenshots 📖
TypeScript browser-extensionchrome-extensiondocumentationfirefox-extensionguide-generatorlocal-firstmanifest-v3privacy-firstproductivityreactscreenshotstep-by-step-guidetutorialtypescriptworkflowwxt
feat(desktop): re-zoom a recorded guide from its toolbar
Luis Ortiz2b58106ef243
diff --git a/AGENTS.md b/AGENTS.mdindex 7aaa7a7..ffb60a7 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -599,6 +599,20 @@ gives 2.25, a 1200 px window gives 1, and a small one gives 1 — the same buttoevery page of the guide, which a fixed fraction of the frame cannot do. The level is stored besidethe region in `edits.zoomLevel`, so it can be re-derived or overridden later without recapturing.+A setting only seeds new recordings, so the guide view carries its own Zoom control and `rezoomEdits`+rewrites the steps already captured. It recomputes from `clickPoint` and the frame, which every row+already holds, so nothing is re-captured and nothing is lost. A guide therefore stores no zoom of its+own — the level lives per screenshot and the control simply rewrites each one.++Which steps it may touch is `edits.zoomLevel` itself: present means the app chose the region, absent+means a person did. `AnnotationEditor` clears it whenever the crop tool writes a new viewport, so a+hand-cropped step survives every later re-zoom. `rezoomEdits` returns null for those, and for a step+already at the wanted level, so the pass writes only what changes.++`guideActions` on `TopNav` is the slot it mounts into, beside Edit and Export and under the same+`exportData` guard, so the control appears exactly when the rest of the guide toolbar does. The+extension passes nothing.+`zoomLevel` in capture settings overrides the automatic choice; `null` means derive it. Main cannotvalue-import core, so `settings.ts` carries its own three-line `snapZoom` rather than the one in`record.ts` — the same constraint that keeps `clamp` local in `capture/screenshot.ts`. The rendererdiff --git a/apps/desktop/src/renderer/App.tsx b/apps/desktop/src/renderer/App.tsxindex 4beea09..6fe83d9 100644--- a/apps/desktop/src/renderer/App.tsx+++ b/apps/desktop/src/renderer/App.tsx@@ -6,6 +6,7 @@ import SearchModal from '@mimik/ui/fullview/SearchModal';import TopNav from '@mimik/ui/fullview/TopNav';import { useEffect, useState } from 'react';import CaptureSheet from './CaptureSheet';+import GuideZoom from './GuideZoom';import SettingsPanel from './SettingsPanel';export default function App() {@@ -23,6 +24,7 @@ export default function App() {}, []);const library = route.page === 'library';+ const [guideKey, setGuideKey] = useState(0);return (<TooltipProvider>@@ -31,6 +33,11 @@ export default function App() {route={route}onSettings={library ? () => setSettingsOpen(true) : undefined}onNavigate={() => setSettingsOpen(false)}+ guideActions={+ route.page === 'guide' ? (+ <GuideZoom guideId={route.guideId} onDone={() => setGuideKey((n) => n + 1)} />+ ) : undefined+ }/>{settingsOpen ? (<main className="flex-1 min-h-0">@@ -39,7 +46,12 @@ export default function App() {) : route.page === 'guide' ? (<main className="flex-1 py-10 px-6"><div className="mx-auto max-w-[780px]">- <GuideContent guideId={route.guideId} initialStepId={route.stepId} initialTool={route.tool} />+ <GuideContent+ key={guideKey}+ guideId={route.guideId}+ initialStepId={route.stepId}+ initialTool={route.tool}+ /></div></main>) : (diff --git a/apps/desktop/src/renderer/GuideZoom.tsx b/apps/desktop/src/renderer/GuideZoom.tsxnew file mode 100644index 0000000..d981ed9--- /dev/null+++ b/apps/desktop/src/renderer/GuideZoom.tsx@@ -0,0 +1,55 @@+import { i18n } from '@mimik/core/env';+import { getGuide, updateScreenshotEdits } from '@mimik/core/guides/service';+import { MAX_ZOOM, MIN_ZOOM, rezoomEdits, ZOOM_STEP } from '@mimik/core/screenshot/record';+import { Button } from '@mimik/ui/components/ui/button';+import { Select, SelectContent, SelectItem, SelectTrigger } from '@mimik/ui/components/ui/select';+import { ZoomIn } from 'lucide-react';+import { useState } from 'react';++const LEVELS = Array.from(+ { length: Math.round((MAX_ZOOM - MIN_ZOOM) / ZOOM_STEP) + 1 },+ (_, i) => MIN_ZOOM + i * ZOOM_STEP,+);++export default function GuideZoom({ guideId, onDone }: { guideId: string; onDone: () => void }) {+ const [busy, setBusy] = useState(false);++ const apply = async (value: string) => {+ setBusy(true);+ try {+ const found = await getGuide(guideId);+ if (!found) return;+ const level = value === 'auto' ? null : Number(value);+ for (const shot of found.screenshots.values()) {+ const next = rezoomEdits(shot, level);+ if (next) await updateScreenshotEdits(shot.id, next);+ }+ onDone();+ } finally {+ setBusy(false);+ }+ };++ return (+ <Select disabled={busy} onValueChange={apply}>+ <SelectTrigger+ aria-label={i18n.t('desktop_zoomLevel')}+ className="h-8 w-auto gap-1.5 rounded-lg border-border bg-card px-3 text-[13px] font-medium hover:bg-secondary"+ asChild+ >+ <Button size="sm" variant="ghost">+ <ZoomIn size={14} />+ {i18n.t('desktop_zoomGuide')}+ </Button>+ </SelectTrigger>+ <SelectContent>+ <SelectItem value="auto">{i18n.t('desktop_zoomAuto')}</SelectItem>+ {LEVELS.map((level) => (+ <SelectItem key={level} value={String(level)}>+ {String(level)}×+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ );+}diff --git a/packages/core/src/screenshot/__tests__/record.test.ts b/packages/core/src/screenshot/__tests__/record.test.tsindex e22d41a..1dd2ad8 100644--- a/packages/core/src/screenshot/__tests__/record.test.ts+++ b/packages/core/src/screenshot/__tests__/record.test.ts@@ -1,7 +1,7 @@import { describe, expect, it } from 'vitest';import type { ElementMeta } from '@/core/guides/types';import { resolveViewport } from '@/core/screenshot/geometry';-import { autoZoom, clickZoomViewport, screenshotForElement, snapZoom } from '@/core/screenshot/record';+import { autoZoom, clickZoomViewport, rezoomEdits, screenshotForElement, snapZoom } from '@/core/screenshot/record';const meta: ElementMeta = {textContent: null,@@ -93,3 +93,27 @@ describe('clickZoomViewport', () => {expect(clickZoomViewport(2560, 1440, { x: 2550, y: 1430 }, 2)).toMatchObject({ x: 1280, y: 720 });});});++describe('rezoomEdits', () => {+ const auto = screenshotForElement({ ...bytes, width: 2560, height: 1440, zoom: 'click' }, meta);++ it('recomputes the region at a new level', () => {+ const next = rezoomEdits(auto, 3);+ expect(next?.zoomLevel).toBe(3);+ expect(next?.viewport?.width).toBeCloseTo(2560 / 3, 1);+ });++ it('re-derives the automatic level when given null', () => {+ const next = rezoomEdits({ ...auto, edits: { ...auto.edits, zoomLevel: 4 } }, null);+ expect(next?.zoomLevel).toBe(autoZoom(2560, 2));+ });++ it('leaves a step alone when nothing would change', () => {+ expect(rezoomEdits(auto, auto.edits?.zoomLevel ?? 0)).toBeNull();+ });++ it('leaves a hand-cropped step alone', () => {+ const cropped = { ...auto, edits: { ...auto.edits, zoomLevel: undefined } };+ expect(rezoomEdits(cropped, 3)).toBeNull();+ });+});diff --git a/packages/core/src/screenshot/record.ts b/packages/core/src/screenshot/record.tsindex 328304d..85ff020 100644--- a/packages/core/src/screenshot/record.ts+++ b/packages/core/src/screenshot/record.ts@@ -1,5 +1,5 @@import type { ElementMeta, ScreenshotBounds, StoredScreenshot } from '@/core/guides/types';-import { type CursorMark, DEFAULT_TARGET_COLOR } from '@/core/screenshot/types';+import { type CursorMark, DEFAULT_TARGET_COLOR, type ScreenshotEdits } from '@/core/screenshot/types';export type ZoomMode = 'element' | 'click' | 'none';@@ -82,3 +82,17 @@ export function screenshotForElement(bytes: ScreenshotBytes, meta: ElementMeta):},};}++export function rezoomEdits(screenshot: StoredScreenshot, level: number | null): ScreenshotEdits | null {+ if (screenshot.edits?.zoomLevel === undefined) return null;+ const click = screenshot.clickPoint;+ if (!click) return null;+ const ratio = screenshot.pixelRatio || 1;+ const next = level ?? autoZoom(screenshot.width, ratio);+ if (next === screenshot.edits.zoomLevel) return null;+ return {+ ...screenshot.edits,+ zoomLevel: next,+ viewport: clickZoomViewport(screenshot.width, screenshot.height, { x: click.x * ratio, y: click.y * ratio }, next),+ };+}diff --git a/packages/ui/src/fullview/TopNav.tsx b/packages/ui/src/fullview/TopNav.tsxindex e6fb641..ac2018b 100644--- a/packages/ui/src/fullview/TopNav.tsx+++ b/packages/ui/src/fullview/TopNav.tsx@@ -18,6 +18,7 @@ import {Star,Trash2,} from 'lucide-react';+import type { ReactNode } from 'react';import { useState } from 'react';import ExportPreviewModal from './ExportPreviewModal';@@ -25,6 +26,7 @@ interface TopNavProps {route: Route;onSettings?: () => void;onNavigate?: () => void;+ guideActions?: ReactNode;}const navItems = [@@ -35,7 +37,7 @@ const navItems = [const NAV_CONTROL = 'h-8 rounded-lg border border-border bg-card text-foreground hover:bg-secondary hover:text-accent';-export default function TopNav({ route, onSettings, onNavigate }: TopNavProps) {+export default function TopNav({ route, onSettings, onNavigate, guideActions }: TopNavProps) {const {counts,guideTitle,@@ -162,6 +164,7 @@ export default function TopNav({ route, onSettings, onNavigate }: TopNavProps) {)}{route.page === 'guide' && exportData && (<>+ {guideActions}<Button size="sm" variant="ghost" onClick={() => toggleEditing(exportData.guideId)} className={NAV_CONTROL}>{editing ? <Check size={14} /> : <Pencil size={14} />}{editing ? i18n.t('editor.done') : i18n.t('editor.edit')}diff --git a/packages/ui/src/shared/AnnotationEditor.tsx b/packages/ui/src/shared/AnnotationEditor.tsxindex 43e7d26..1b37f68 100644--- a/packages/ui/src/shared/AnnotationEditor.tsx+++ b/packages/ui/src/shared/AnnotationEditor.tsx@@ -880,7 +880,12 @@ export default function AnnotationEditor({ screenshot, tool, onDone, onCancel }:annotations: annotations.filter((a) => a.id !== TARGET_ID),target: nextTarget,};- if (viewport) nextEdits.viewport = viewport;+ if (viewport && viewport !== screenshot.edits?.viewport) {+ nextEdits.viewport = viewport;+ nextEdits.zoomLevel = undefined;+ } else if (viewport) {+ nextEdits.viewport = viewport;+ }await updateScreenshotEdits(screenshot.id, nextEdits);onDone(nextEdits);};diff --git a/src/locales/de.yml b/src/locales/de.ymlindex 9bdb5a9..fdc1d12 100644--- a/src/locales/de.yml+++ b/src/locales/de.yml@@ -188,6 +188,7 @@ desktop:zoomLevel: "Auf den Klick zoomen"zoomLevelHint: "Neue Aufzeichnungen starten hier. Automatisch hält alle Schritte gleich groß."zoomAuto: "Automatisch"+ zoomGuide: "Zoom"captureKeys: "Kürzel und benannte Tasten aufzeichnen"captureTyping: "Eingaben aufzeichnen"typingDebounce: "Eingabeschritt beenden nach"diff --git a/src/locales/en.yml b/src/locales/en.ymlindex 75bb0f3..97cc877 100644--- a/src/locales/en.yml+++ b/src/locales/en.yml@@ -188,6 +188,7 @@ desktop:zoomLevel: "Zoom toward the click"zoomLevelHint: "New recordings start here. Automatic keeps every step the same size."zoomAuto: "Automatic"+ zoomGuide: "Zoom"captureKeys: "Record shortcuts and named keys"captureTyping: "Record what you type"typingDebounce: "Close a typing step after"diff --git a/src/locales/es.yml b/src/locales/es.ymlindex 5f4d7b9..2546966 100644--- a/src/locales/es.yml+++ b/src/locales/es.yml@@ -188,6 +188,7 @@ desktop:zoomLevel: "Acercar hacia el clic"zoomLevelHint: "Las grabaciones nuevas empiezan aquí. Automático mantiene todos los pasos del mismo tamaño."zoomAuto: "Automático"+ zoomGuide: "Zoom"captureKeys: "Registrar atajos y teclas con nombre"captureTyping: "Registrar lo que escribes"typingDebounce: "Cerrar el paso de escritura tras"diff --git a/src/locales/fr.yml b/src/locales/fr.ymlindex 6966342..631766c 100644--- a/src/locales/fr.yml+++ b/src/locales/fr.yml@@ -188,6 +188,7 @@ desktop:zoomLevel: "Zoomer vers le clic"zoomLevelHint: "Les nouveaux enregistrements partent d’ici. Automatique garde toutes les étapes à la même taille."zoomAuto: "Automatique"+ zoomGuide: "Zoom"captureKeys: "Enregistrer les raccourcis et touches nommées"captureTyping: "Enregistrer ce que vous tapez"typingDebounce: "Clôturer l'étape de saisie après"diff --git a/src/locales/pt-BR.yml b/src/locales/pt-BR.ymlindex 455bbcd..cde682c 100644--- a/src/locales/pt-BR.yml+++ b/src/locales/pt-BR.yml@@ -188,6 +188,7 @@ desktop:zoomLevel: "Aproximar no clique"zoomLevelHint: "Novas gravações começam aqui. Automático mantém todas as etapas do mesmo tamanho."zoomAuto: "Automático"+ zoomGuide: "Zoom"captureKeys: "Registrar atalhos e teclas nomeadas"captureTyping: "Registrar o que você digita"typingDebounce: "Encerrar a etapa de digitação após"diff --git a/src/locales/zh-CN.yml b/src/locales/zh-CN.ymlindex 8aa02c2..19dc818 100644--- a/src/locales/zh-CN.yml+++ b/src/locales/zh-CN.yml@@ -188,6 +188,7 @@ desktop:zoomLevel: "向点击处缩放"zoomLevelHint: "新录制从这里开始。自动会让每一步保持相同大小。"zoomAuto: "自动"+ zoomGuide: "缩放"captureKeys: "记录快捷键和命名按键"captureTyping: "记录输入内容"typingDebounce: "输入步骤结束延迟"