π¬ 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: redesigned home screen and live recording view
Luis Ortiz72d25fa33ef9
diff --git a/entrypoints/background.ts b/entrypoints/background.tsindex b749f3a..6eebc06 100644--- a/entrypoints/background.ts+++ b/entrypoints/background.ts@@ -172,10 +172,12 @@ export default defineBackground(() => {try {await actorReady;+ const guideId = actor.getSnapshot().context.currentGuideId;+await broadcastStopCapture();actor.send({ type: 'STOP_RECORDING' });- sendResponse({ success: true });+ sendResponse({ success: true, guideId });} catch (err) {console.error('[Mimik] STOP_RECORDING failed', err);sendResponse({ error: String(err) });diff --git a/src/sidepanel/App.tsx b/src/sidepanel/App.tsxindex efaad28..4bd0bdc 100644--- a/src/sidepanel/App.tsx+++ b/src/sidepanel/App.tsx@@ -1,13 +1,17 @@import { useState, useEffect, useCallback } from 'react';+import { Video } from 'lucide-react';import LibraryView from './LibraryView';import GuideEditor from './GuideEditor';+import RecordingView from './RecordingView';-type View = { name: 'library' } | { name: 'editor'; guideId: string } | { name: 'recording' };+type View =+ | { name: 'library' }+ | { name: 'editor'; guideId: string }+ | { name: 'recording'; guideId: string };export default function App() {const [isAlive, setIsAlive] = useState(false);const [isRecording, setIsRecording] = useState(false);- const [stepCount, setStepCount] = useState(0);const [view, setView] = useState<View>({ name: 'library' });useEffect(() => {@@ -17,22 +21,23 @@ export default function App() {const interval = setInterval(() => {chrome.runtime.sendMessage({ type: 'GET_STATE' }, (response) => {+ if (chrome.runtime.lastError) return;if (response?.state === 'recording') {setIsRecording(true);- if (response.stepCount !== undefined) {- setStepCount(response.stepCount);+ if (response.currentGuideId) {+ setView(prev => {+ if (prev.name === 'recording') return prev;+ return { name: 'recording', guideId: response.currentGuideId };+ });}- setView({ name: 'recording' });} else {- if (isRecording) {- }setIsRecording(false);}});}, 1000);return () => clearInterval(interval);- }, [isRecording]);+ }, []);const handleStartRecording = useCallback(async () => {const tabs = await chrome.tabs.query({ active: true, lastFocusedWindow: true });@@ -47,8 +52,7 @@ export default function App() {}if (response?.guideId) {setIsRecording(true);- setStepCount(0);- setView({ name: 'recording' });+ setView({ name: 'recording', guideId: response.guideId });}});@@ -58,7 +62,6 @@ export default function App() {chrome.runtime.sendMessage({ type: 'STOP_RECORDING' }, (response) => {if (response?.success) {setIsRecording(false);- setStepCount(0);if (response.guideId) {setView({ name: 'editor', guideId: response.guideId });} else {@@ -68,6 +71,15 @@ export default function App() {});}, []);+ if (view.name === 'recording') {+ return (+ <RecordingView+ guideId={view.guideId}+ onStop={handleStopRecording}+ />+ );+ }+if (view.name === 'editor') {return (<GuideEditor@@ -77,47 +89,39 @@ export default function App() {);}- if (view.name === 'library' && !isRecording) {- return (- <div className="min-h-screen bg-white">- <div className="p-4 border-b border-gray-100 flex items-center justify-between">- <h1 className="text-xl font-bold text-gray-900">Mimik</h1>- <span className="text-xs text-gray-400">+ return (+ <div className="min-h-screen bg-white">+ {/* Header */}+ <div className="px-5 pt-5 pb-4">+ <div className="flex items-center justify-between mb-6">+ <h1 className="text-xl font-bold text-gray-900 tracking-tight">Mimik</h1>+ <span className={`text-xs font-medium px-2 py-0.5 rounded-full ${isAlive ? 'bg-green-50 text-green-600' : 'bg-gray-100 text-gray-400'}`}>{isAlive ? 'Connected' : 'Connecting...'}</span></div>- <LibraryView- onOpen={(guideId) => setView({ name: 'editor', guideId })}- onStartRecording={handleStartRecording}- isAlive={isAlive}- />- </div>- );- }- return (- <div className="p-4 min-h-screen bg-white">- <h1 className="text-xl font-bold text-gray-900 mb-4">Mimik</h1>- <p className="text-sm text-gray-600 mb-2">- Auto-capture browser workflows into step-by-step guides.- </p>- <div className="mt-4 p-3 rounded-lg bg-gray-50 border border-gray-200">- <p className="text-xs text-gray-500">- Service Worker: {isAlive ? 'Connected' : '... Connecting'}- </p>- {isRecording && (- <p className="text-xs text-red-600 mt-1 font-medium">- Recording... {stepCount} step{stepCount !== 1 ? 's' : ''} captured- </p>- )}+ {/* Start Capture button */}+ <button+ onClick={handleStartRecording}+ disabled={!isAlive}+ className="w-full py-3.5 px-4 bg-blue-600 text-white rounded-xl font-semibold text-base hover:bg-blue-700 active:bg-blue-800 transition-all disabled:opacity-40 disabled:cursor-not-allowed shadow-sm flex items-center justify-center gap-2"+ >+ <Video size={20} />+ Start Capture+ </button></div>- <button- onClick={handleStopRecording}- className="mt-4 w-full py-2 px-4 bg-gray-600 text-white rounded-lg font-medium hover:bg-gray-700 transition-colors"- >- Stop Recording- </button>+ {/* Divider */}+ <div className="h-px bg-gray-100" />++ {/* Recent guides */}+ <div className="px-5 pt-3 pb-1">+ <p className="text-xs font-medium text-gray-400 uppercase tracking-wider">Recent</p>+ </div>+ <LibraryView+ onOpen={(guideId) => setView({ name: 'editor', guideId })}+ isAlive={isAlive}+ /></div>);}diff --git a/src/sidepanel/LibraryView.tsx b/src/sidepanel/LibraryView.tsxindex c09d66c..73a5868 100644--- a/src/sidepanel/LibraryView.tsx+++ b/src/sidepanel/LibraryView.tsx@@ -1,5 +1,5 @@import { useState, useEffect, useCallback } from 'react';-import { Trash2 } from 'lucide-react';+import { Trash2, FileText } from 'lucide-react';import { getGuides, deleteGuide } from '../shared/guide-service';import type { Guide } from '../shared/types';@@ -49,64 +49,46 @@ export default function LibraryView({ onOpen, onStartRecording, isAlive }: Libra}, [loadGuides]);if (loading) {- return <p className="text-sm text-gray-500 p-4">Loading...</p>;+ return <p className="text-sm text-gray-400 px-5 py-4">Loading...</p>;+ }++ if (guides.length === 0) {+ return (+ <div className="px-5 py-8 text-center">+ <div className="w-12 h-12 rounded-full bg-gray-100 flex items-center justify-center mx-auto mb-3">+ <FileText size={20} className="text-gray-400" />+ </div>+ <p className="text-sm text-gray-500">No guides yet</p>+ <p className="text-xs text-gray-400 mt-1">Start a capture to create your first guide</p>+ </div>+ );}return (<div className="flex flex-col">- {guides.length === 0 ? (- <div className="p-4">- <p className="text-sm text-gray-500 mb-4">- No guides yet. Start recording to create your first guide.- </p>- {onStartRecording && (+ <div className="divide-y divide-gray-50">+ {guides.map((guide) => (+ <div+ key={guide.id}+ className="px-5 py-3 hover:bg-gray-50 cursor-pointer flex items-center justify-between group transition-colors"+ onClick={() => onOpen(guide.id)}+ >+ <div className="flex-1 min-w-0">+ <p className="text-sm font-medium text-gray-900 truncate">{guide.title}</p>+ <p className="text-xs text-gray-400 mt-0.5">+ {guide.stepIds.length} step{guide.stepIds.length !== 1 ? 's' : ''} · {formatRelativeTime(guide.updatedAt)}+ </p>+ </div><button- onClick={onStartRecording}- className="w-full py-2 px-4 bg-red-600 text-white rounded-lg font-medium hover:bg-red-700 transition-colors"- disabled={!isAlive}+ onClick={(e) => handleDelete(e, guide.id)}+ className="ml-2 p-1.5 rounded-lg text-gray-300 opacity-0 group-hover:opacity-100 hover:text-red-500 hover:bg-red-50 transition-all flex-shrink-0"+ title="Delete guide">- Start Recording+ <Trash2 size={14} /></button>- )}- </div>- ) : (- <>- <div className="divide-y divide-gray-100">- {guides.map((guide) => (- <div- key={guide.id}- className="p-3 hover:bg-gray-50 cursor-pointer flex items-center justify-between"- onClick={() => onOpen(guide.id)}- >- <div className="flex-1 min-w-0">- <p className="text-sm font-medium text-gray-900 truncate">{guide.title}</p>- <p className="text-xs text-gray-500 mt-0.5">- {guide.stepIds.length} step{guide.stepIds.length !== 1 ? 's' : ''} · {formatRelativeTime(guide.updatedAt)}- </p>- </div>- <button- onClick={(e) => handleDelete(e, guide.id)}- className="ml-2 p-1 rounded text-gray-400 hover:text-red-500 flex-shrink-0"- title="Delete guide"- >- <Trash2 size={16} />- </button>- </div>- ))}</div>- {onStartRecording && (- <div className="p-3 border-t border-gray-100">- <button- onClick={onStartRecording}- className="w-full py-2 px-4 bg-red-600 text-white rounded-lg font-medium hover:bg-red-700 transition-colors"- disabled={!isAlive}- >- New Recording- </button>- </div>- )}- </>- )}+ ))}+ </div></div>);}diff --git a/src/sidepanel/RecordingView.tsx b/src/sidepanel/RecordingView.tsxnew file mode 100644index 0000000..e0c683f--- /dev/null+++ b/src/sidepanel/RecordingView.tsx@@ -0,0 +1,209 @@+import { useState, useEffect, useCallback, useRef } from 'react';+import { Check, Trash2, Square } from 'lucide-react';+import { db } from '../shared/db-schema';+import type { Step, Screenshot } from '../shared/types';+import ZoomScreenshot from './ZoomScreenshot';++interface RecordingViewProps {+ guideId: string;+ onStop: () => void;+}++function extractDomain(url: string): string {+ try {+ const u = new URL(url);+ return u.hostname.replace(/^www\./, '');+ } catch {+ return '';+ }+}++function getFaviconUrl(url: string): string {+ try {+ const u = new URL(url);+ return `https://www.google.com/s2/favicons?domain=${u.hostname}&sz=32`;+ } catch {+ return '';+ }+}++interface LiveStep {+ step: Step;+ screenshot?: Screenshot;+ objectUrl?: string;+}++export default function RecordingView({ guideId, onStop }: RecordingViewProps) {+ const [steps, setSteps] = useState<LiveStep[]>([]);+ const [siteUrl, setSiteUrl] = useState('');+ const bottomRef = useRef<HTMLDivElement>(null);++ const loadSteps = useCallback(async () => {+ const allSteps = await db.steps.where('guideId').equals(guideId).sortBy('index');+ const screenshotIds = allSteps.map(s => s.screenshotId).filter(Boolean) as string[];+ const screenshots = await db.screenshots.where('id').anyOf(screenshotIds).toArray();+ const screenshotMap = new Map(screenshots.map(s => [s.stepId, s]));++ setSteps(prev => {+ const oldUrls = new Map(prev.map(p => [p.step.id, p.objectUrl]));+ const newSteps = allSteps.map(step => {+ const screenshot = screenshotMap.get(step.id);+ const existing = oldUrls.get(step.id);+ if (existing && prev.find(p => p.step.id === step.id)?.screenshot?.id === screenshot?.id) {+ return { step, screenshot, objectUrl: existing };+ }+ if (existing) URL.revokeObjectURL(existing);+ const objectUrl = screenshot?.blob ? URL.createObjectURL(screenshot.blob) : undefined;+ return { step, screenshot, objectUrl };+ });+ return newSteps;+ });++ if (allSteps.length > 0 && !siteUrl) {+ setSiteUrl(allSteps[0].url || '');+ }+ }, [guideId, siteUrl]);++ useEffect(() => {+ loadSteps();+ const interval = setInterval(loadSteps, 800);+ return () => {+ clearInterval(interval);+ };+ }, [loadSteps]);++ useEffect(() => {+ return () => {+ steps.forEach(s => {+ if (s.objectUrl) URL.revokeObjectURL(s.objectUrl);+ });+ };+ // eslint-disable-next-line react-hooks/exhaustive-deps+ }, []);++ useEffect(() => {+ bottomRef.current?.scrollIntoView({ behavior: 'smooth' });+ }, [steps.length]);++ useEffect(() => {+ chrome.tabs.query({ active: true, lastFocusedWindow: true }, (tabs) => {+ if (tabs[0]?.url) setSiteUrl(tabs[0].url);+ });+ }, []);++ const handleDeleteStep = useCallback(async (stepId: string) => {+ const step = await db.steps.get(stepId);+ if (step?.screenshotId) {+ await db.screenshots.delete(step.screenshotId);+ }+ await db.steps.delete(stepId);+ const guide = await db.guides.get(guideId);+ if (guide) {+ const newStepIds = guide.stepIds.filter(id => id !== stepId);+ await db.guides.update(guideId, { stepIds: newStepIds, updatedAt: Date.now() });+ const remaining = await db.steps.where('guideId').equals(guideId).sortBy('index');+ for (let i = 0; i < remaining.length; i++) {+ if (remaining[i].index !== i) {+ await db.steps.update(remaining[i].id, { index: i });+ }+ }+ }+ await loadSteps();+ }, [guideId, loadSteps]);++ const domain = extractDomain(siteUrl);+ const favicon = getFaviconUrl(siteUrl);++ return (+ <div className="flex flex-col h-screen bg-white">+ {/* Content area */}+ <div className="flex-1 overflow-y-auto">+ <div className="p-5">+ {/* Site header */}+ <div className="flex items-center gap-3 mb-5">+ {favicon && (+ <img+ src={favicon}+ alt=""+ className="w-8 h-8 rounded"+ onError={(e) => { (e.target as HTMLImageElement).style.display = 'none'; }}+ />+ )}+ <span className="text-base font-semibold text-gray-900">{domain || 'Recording...'}</span>+ </div>++ {steps.length === 0 ? (+ <p className="text-sm text-gray-400">Ready to capture!</p>+ ) : (+ <div className="space-y-1">+ {steps.map((liveStep, idx) => {+ const isLast = idx === steps.length - 1;+ return (+ <div key={liveStep.step.id}>+ {/* Step row */}+ <div className="flex items-start gap-3 group py-1.5">+ <span className="flex items-center justify-center w-6 h-6 rounded-full border-2 border-gray-300 text-gray-500 text-xs font-medium flex-shrink-0 mt-0.5">+ {liveStep.step.index + 1}+ </span>+ <p className="text-sm text-gray-800 flex-1 pt-0.5 leading-snug">+ {liveStep.step.description}+ </p>+ <button+ onClick={() => handleDeleteStep(liveStep.step.id)}+ className="opacity-0 group-hover:opacity-100 transition-opacity text-gray-300 hover:text-red-500 p-0.5 flex-shrink-0"+ title="Delete step"+ >+ <Trash2 size={14} />+ </button>+ </div>+ {/* Show screenshot only for the last step */}+ {isLast && liveStep.screenshot && (+ <div className="ml-9 mt-2 mb-2">+ <ZoomScreenshot+ screenshot={liveStep.screenshot}+ alt={`Step ${liveStep.step.index + 1}`}+ className="shadow-sm"+ />+ </div>+ )}+ </div>+ );+ })}+ </div>+ )}+ <div ref={bottomRef} />+ </div>+ </div>++ {/* Bottom toolbar */}+ <div className="flex-shrink-0 border-t border-gray-100 bg-white">+ <div className="flex items-center justify-center gap-4 py-3 px-4">+ <button+ onClick={onStop}+ className="flex items-center justify-center w-10 h-10 rounded-full bg-green-600 text-white hover:bg-green-700 transition-colors shadow-sm"+ title="Finish recording"+ >+ <Check size={20} strokeWidth={3} />+ </button>+ <button+ onClick={onStop}+ className="flex items-center justify-center w-10 h-10 rounded-full border-2 border-gray-200 text-gray-400 hover:text-red-500 hover:border-red-300 transition-colors"+ title="Discard recording"+ >+ <Square size={16} />+ </button>+ <button+ onClick={() => {+ const last = steps[steps.length - 1];+ if (last) handleDeleteStep(last.step.id);+ }}+ className="flex items-center justify-center w-10 h-10 rounded-full border-2 border-gray-200 text-gray-400 hover:text-gray-600 hover:border-gray-300 transition-colors"+ title="Delete last step"+ >+ <Trash2 size={16} />+ </button>+ </div>+ </div>+ </div>+ );+}