IKEA assembly, step by step: animated, manual-style 3D guides. Scan any paper manual with Together AI.
TypeScript
"use client";
import { useEffect, useMemo, useState } from "react";
import Link from "next/link";
import { motion } from "motion/react";
import type { Plan } from "@/lib/types";
import { totals } from "@/lib/plan/contents";
import { POPULAR } from "@/lib/search";
import { buildMinutes, getPref, setPref } from "@/lib/store";
import { Figure } from "../art/Figure";
import { IArrowLeft, IArrowRight, ICheck, ILibrary, IShare } from "../art/Icons";
import Drawing from "../Drawing";
import { fmtMin } from "./CoverPanel";
import { buildCard } from "./shareCard";
import { encodeSpec } from "@/lib/scan/share";
import { track } from "@vercel/analytics";
export default function DonePanel({ plan, slug, finish, onReview }: { plan: Plan; slug: string; finish: { ms: number; full: boolean } | null; onReview: () => void }) {
const t = totals(plan);
const s = plan.spec;
// a time only counts when the steps were followed, not tapped through in a minute
const spent = buildMinutes(finish?.ms, finish?.full, s.minutes);
const faster = spent !== null && spent < s.minutes * 0.95;
const a = s.archetype;
const recheck = a === "table" || a === "bed" || a === "seat" || a === "sofa";
const tall = plan.steps.some((x) => x.kind === "anchor");
const stat = [spent ? fmtMin(spent) : null, `${plan.steps.length} steps`, `${t.fittings} fittings`].filter(Boolean).join(" \u00b7 ");
return (
<div className="pane done">
<div className="pane-scroll">
<motion.div className="done-hero" initial={{ scale: 0.6, opacity: 0 }} animate={{ scale: 1, opacity: 1 }} transition={{ type: "spring", stiffness: 260, damping: 16, delay: 0.1 }}>
<Figure pose="cheer" size={112} bubble="check" className="bounce" />
</motion.div>
<motion.h2 className="done-title" initial={{ y: 16, opacity: 0 }} animate={{ y: 0, opacity: 1 }} transition={{ delay: 0.25, duration: 0.5, ease: [0.22, 1, 0.36, 1] }}>
You built {s.name}.
</motion.h2>
<motion.p className="sub center" initial={{ opacity: 0 }} animate={{ opacity: 1 }} transition={{ delay: 0.4 }}>
{faster ? `${s.minutes - spent!} ${s.minutes - spent! === 1 ? "minute" : "minutes"} under the typical time.` : spent ? "Built at your own pace. That's the right pace." : "Every step done. Nice work."}
</motion.p>
<motion.dl className="stats" initial={{ opacity: 0, y: 8 }} animate={{ opacity: 1, y: 0 }} transition={{ delay: 0.5 }}>
<div>
<dt>{spent ? "Your time" : "Typical time"}</dt>
<dd>{fmtMin(spent ?? s.minutes)}</dd>
</div>
<div>
<dt>Steps</dt>
<dd>{plan.steps.length}</dd>
</div>
<div>
<dt>Fittings</dt>
<dd>{t.fittings}</dd>
</div>
</motion.dl>
<ShareCard plan={plan} slug={slug} stat={stat} spent={spent} />
<Link href="/builds" className="workshop-link">
<span className="wl-ico">
<ILibrary size={18} />
</span>
<span>
<b>Saved to your workshop</b>
<span>See everything you've built, side by side and to scale.</span>
</span>
<IArrowRight size={18} />
</Link>
<NextUp plan={plan} />
<Match plan={plan} slug={slug} />
<h3 className="section-title">Before you load it up</h3>
<ul className="after">
{tall && (
<li>
<ICheck size={16} strokeWidth={2.6} /> Double check it's fixed to the wall.
</li>
)}
{recheck && (
<li>
<ICheck size={16} strokeWidth={2.6} /> Tighten every bolt again after a week. Wood settles.
</li>
)}
<li>
<ICheck size={16} strokeWidth={2.6} /> Spare fittings are normal. Tape the bag inside, with the Allen key.
</li>
<li>
<ICheck size={16} strokeWidth={2.6} /> Flatten the box for recycling.
</li>
</ul>
</div>
<div className="pane-foot">
<button className="btn round" onClick={onReview} aria-label="Back to the last step" data-tip="Last step">
<IArrowLeft />
</button>
<Link className="btn primary big" href="/">
<span>Build something else</span>
<IArrowRight />
</Link>
</div>
</div>
);
}
/** The picture people post: the finished piece, its name and their time. */
function ShareCard({ plan, slug, stat, spent }: { plan: Plan; slug: string; stat: string; spent: number | null }) {
const [card, setCard] = useState<{ blob: Blob; url: string } | null>(null);
const [copied, setCopied] = useState(false);
useEffect(() => {
let alive = true;
let url = "";
const t = setTimeout(() => {
buildCard(plan, slug, stat).then((blob) => {
if (!alive || !blob) return;
url = URL.createObjectURL(blob);
setCard({ blob, url });
});
}, 500);
return () => {
alive = false;
clearTimeout(t);
if (url) URL.revokeObjectURL(url);
};
}, [plan, slug, stat]);
const share = async () => {
// scanned guides only exist in this browser, so the link carries the guide itself
const url = `${location.origin}/build/${slug}` + (plan.spec.source === "scan" ? `#g=${await encodeSpec(plan.spec)}` : "");
const text = spent ? `I just built ${plan.spec.name} in ${fmtMin(spent)}, one step at a time.` : `I just built ${plan.spec.name}, one step at a time.`;
const file = card ? new File([card.blob], `${plan.spec.name.toLowerCase()}-built.png`, { type: "image/png" }) : null;
track("share", { product: plan.spec.name, image: !!file });
try {
if (file && navigator.canShare?.({ files: [file] })) await navigator.share({ files: [file], text: `${text} ${url}` });
else if (navigator.share) await navigator.share({ title: "Bygga", text, url });
else {
await navigator.clipboard.writeText(`${text} ${url}`);
setCopied(true);
setTimeout(() => setCopied(false), 1800);
}
} catch {
/* cancelled */
}
};
return (
<motion.div className="share-card" initial={{ opacity: 0, y: 10 }} animate={{ opacity: 1, y: 0 }} transition={{ delay: 0.6 }}>
<div className={"share-pic" + (card ? " ready" : "")}>
{/* eslint-disable-next-line @next/next/no-img-element */}
{card && <img src={card.url} alt={`${plan.spec.name}, built`} />}
</div>
<div className="share-text">
<b>Show it off</b>
<span>A picture of your build, ready to post.</span>
<div className="share-actions">
<button className="btn share-go" onClick={share}>
{copied ? <ICheck size={17} /> : <IShare size={17} />}
{copied ? "Link copied" : "Share"}
</button>
{card && (
<a className="btn link small" href={card.url} download={`${plan.spec.name.toLowerCase()}-built.png`}>
Save image
</a>
)}
</div>
</div>
</motion.div>
);
}
/** Other pieces from the same family, or popular builds when there are none. */
function NextUp({ plan }: { plan: Plan }) {
const s = plan.spec;
const picks = useMemo(() => {
const own = (s.siblings ?? []).map((x) => ({ slug: x.slug, name: s.name, label: x.label }));
const more = POPULAR.filter((p) => p.name !== s.name).map((p) => ({ slug: p.slug, name: p.name, label: p.category }));
return [...own, ...more].slice(0, own.length ? Math.min(3, own.length) : 3);
}, [s]);
if (!picks.length) return null;
return (
<>
<h3 className="section-title">{s.siblings?.length ? `Finish the ${s.name} set` : "Up next"}</h3>
<div className="next-up">
{picks.map((p) => (
<Link key={p.slug} href={`/build/${p.slug}`} className="next-card">
<Drawing name={p.slug} w={200} h={150} className="next-thumb" />
<span>
<b>{p.name}</b>
<span>{p.label}</span>
</span>
</Link>
))}
</div>
</>
);
}
/** "Did this match your box?" Wrong guides get found and fixed this way. */
function Match({ plan, slug }: { plan: Plan; slug: string }) {
const key = "match:" + slug;
const [state, setState] = useState<"ask" | "no" | "sent">(() => (getPref(key, false) ? "sent" : "ask"));
const [step, setStep] = useState<number | null>(null);
const [note, setNote] = useState("");
const send = (match: boolean) => {
setState("sent");
setPref(key, true);
fetch("/api/feedback", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ slug, name: plan.spec.name, variant: plan.spec.variant, match, step: step ?? undefined, note: note || undefined, via: plan.spec.source }),
}).catch(() => {});
};
if (state === "sent")
return (
<p className="match-thanks">
<ICheck size={16} strokeWidth={2.6} /> Thanks, that helps us fix guides.
</p>
);
return (
<div className="match">
<div className="match-q">
<b>Did the steps match your box?</b>
{state === "ask" && (
<div className="match-btns">
<button className="pill-btn" onClick={() => send(true)}>
Yes
</button>
<button className="pill-btn" onClick={() => setState("no")}>
Not quite
</button>
</div>
)}
</div>
{state === "no" && (
<motion.div className="match-more" initial={{ opacity: 0, height: 0 }} animate={{ opacity: 1, height: "auto" }}>
<span className="muted">Which step looked different?</span>
<div className="match-steps">
{plan.steps.map((_, i) => (
<button key={i} className={"step-chip" + (step === i + 1 ? " on" : "")} onClick={() => setStep(step === i + 1 ? null : i + 1)} aria-pressed={step === i + 1}>
{i + 1}
</button>
))}
</div>
<textarea value={note} onChange={(e) => setNote(e.target.value.slice(0, 400))} placeholder="What was different? (optional)" rows={2} />
<button className="btn primary small" onClick={() => send(false)}>
Send
</button>
</motion.div>
)}
</div>
);
}
const PIECES = ["dowel", "screw", "cam", "pin", "nail", "dowel", "screw"];
export function Confetti() {
const bits = Array.from({ length: 36 }, (_, i) => i);
return (
<div className="confetti" aria-hidden="true">
{bits.map((i) => {
const left = (i * 37) % 100;
const delay = (i % 9) * 0.09;
const dur = 1.8 + ((i * 13) % 10) / 10;
const rot = ((i * 71) % 360) - 180;
const kind = PIECES[i % PIECES.length];
const yellow = i % 4 === 0;
return (
<motion.span
key={i}
className="bit"
style={{ left: `${left}%` }}
initial={{ y: -40, rotate: 0, opacity: 0 }}
animate={{ y: "110vh", rotate: rot * 3, opacity: [0, 1, 1, 0] }}
transition={{ duration: dur, delay, ease: [0.25, 0.1, 0.4, 1] }}
>
<Bit kind={kind} yellow={yellow} />
</motion.span>
);
})}
</div>
);
}
function Bit({ kind, yellow }: { kind: string; yellow: boolean }) {
const f = yellow ? "var(--accent)" : "#fff";
const s = { stroke: "var(--ink)", strokeWidth: 1.6, strokeLinejoin: "round" as const };
switch (kind) {
case "dowel":
return (
<svg width="28" height="10" viewBox="0 0 28 10">
<rect x="1" y="1" width="26" height="8" rx="3" fill={yellow ? f : "#f1e2c3"} {...s} />
</svg>
);
case "screw":
return (
<svg width="26" height="12" viewBox="0 0 26 12">
<path d="M4 3.5h17l4 2.5-4 2.5H4z" fill={f} {...s} />
<rect x="1" y="1" width="3.4" height="10" rx="1.2" fill={f} {...s} />
</svg>
);
case "cam":
return (
<svg width="18" height="18" viewBox="0 0 18 18">
<circle cx="9" cy="9" r="7.5" fill={f} {...s} />
<path d="M5 7.5l8 3" {...s} strokeWidth={2} />
</svg>
);
case "pin":
return (
<svg width="18" height="10" viewBox="0 0 18 10">
<rect x="1" y="3" width="16" height="4" rx="2" fill={f} {...s} />
<rect x="7.6" y="1" width="2" height="8" fill={f} {...s} />
</svg>
);
default:
return (
<svg width="22" height="8" viewBox="0 0 22 8">
<path d="M2 3h16l3 1-3 1H2z" fill={f} {...s} />
<rect x="1" y="1" width="1.4" height="6" fill={f} {...s} />
</svg>
);
}
}