← Files Tiniest CloudARCHIVED FILE
skills/tiny-design/presentation.md
6.46 KB · Nov 19, 2026 · 18:11 UTC
# Designing a presentation — slides
> If the person has design standards of their own — a design system, components, a brand guide, an app or site to match — follow those, and use this playbook only for what they leave open. If they gave none, follow it all.
First decide what the person wants:
- **A file** — a .pptx, a PDF, a Keynote to send or present from their own laptop: make it
with your own tools (your presentation or document skill), filling it from the app's data
with `summarize_app_data` and `read_app_data`. Deploy nothing.
- **A link** — a deck to share, open on any device, or keep current from an app's data: build
a web deck and deploy it. The skeleton below is a single HTML file that needs no build; put it
in its own app (or as a page of the app whose data it shows), and "Save as PDF" in the browser
still gives one slide per page.
## Slides that work
- One idea per slide, and the headline states the point ("Churn fell 18% after the redesign"),
not the topic ("Churn").
- Few words: around 25 on a slide; the detail goes in what the speaker says (notes).
- Big type: headlines around 72–110px and body at least 36–40px on a 1920×1080 slide.
- One grid and one margin for the whole deck; one accent colour, used for the thing to look at.
- A chart shows one comparison with the point highlighted, labelled directly; a number that
matters can be the whole slide.
- Images full-bleed or on the grid, never floating.
- A story: title → the problem → what we found → what we propose → proof → the ask; about one
slide per minute; a closing slide with the ask and how to reach you.
- The deck's palette and fonts follow the same brief as everything else (see the design guide).
## Web deck skeleton
Keyboard (arrows, space, Page Up/Down, Home/End), click either half, swipe on a phone; `#3`
in the address opens slide three; F for full screen; fits any window; one slide per page when
printed. Change the variables at the top for the palette and font, and add sections.
```html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Deck title</title>
<style>
:root { --bg: #f6f5f1; --ink: #1d1c1a; --muted: #6a665e; --accent: #2e6a5b; --font: system-ui, sans-serif; }
* { box-sizing: border-box; margin: 0; }
html, body { height: 100%; background: #111; overflow: hidden; }
body { font-family: var(--font); }
.deck { position: absolute; left: 50%; top: 50%; width: 1920px; height: 1080px; background: var(--bg);
transform: translate(-50%, -50%) scale(var(--scale, 1)); }
.slide { position: absolute; inset: 0; padding: 120px 150px; display: flex; flex-direction: column;
justify-content: center; gap: 40px; background: var(--bg); color: var(--ink);
opacity: 0; visibility: hidden; transition: opacity 250ms ease-out, visibility 250ms; }
.slide.current { opacity: 1; visibility: visible; }
.slide h1 { font-size: 112px; line-height: 1.04; letter-spacing: -0.02em; text-wrap: balance; }
.slide h2 { font-size: 76px; line-height: 1.08; letter-spacing: -0.01em; text-wrap: balance; }
.slide p, .slide li { font-size: 40px; line-height: 1.4; color: var(--muted); max-width: 34ch; }
.slide ul { padding-left: 1.1em; display: grid; gap: 16px; }
.slide .accent { color: var(--accent); }
.count { position: fixed; right: 20px; bottom: 14px; color: #9a9a9a; font: 14px/1 system-ui, sans-serif; }
@media (prefers-reduced-motion: reduce) { .slide { transition: none; } }
@media print {
@page { size: 1920px 1080px; margin: 0; }
html, body { height: auto; overflow: visible; background: none; }
.deck { position: static; transform: none; height: auto; }
.slide { position: relative; height: 1080px; opacity: 1; visibility: visible; break-after: page; }
.count { display: none; }
}
</style>
</head>
<body>
<main class="deck">
<section class="slide"><h1>The headline says the point, not the topic</h1><p>Speaker · Date</p></section>
<section class="slide"><h2>One idea per slide</h2><ul><li>A few words each</li><li>The detail belongs in what you say</li></ul></section>
<section class="slide"><h2><span class="accent">3×</span> faster when the number is the slide</h2></section>
</main>
<div class="count" aria-hidden="true"></div>
<script>
const deck = document.querySelector(".deck");
const slides = [...document.querySelectorAll(".slide")];
const count = document.querySelector(".count");
const clamp = (n) => Math.min(Math.max(n, 0), slides.length - 1);
let current = 0;
function fit() { deck.style.setProperty("--scale", Math.min(innerWidth / 1920, innerHeight / 1080)); }
function show(n) {
current = clamp(n);
slides.forEach((s, k) => { s.classList.toggle("current", k === current); s.inert = k !== current; });
count.textContent = `${current + 1} / ${slides.length}`;
history.replaceState(null, "", `#${current + 1}`);
}
const fromHash = () => clamp((parseInt(location.hash.slice(1), 10) || 1) - 1);
addEventListener("keydown", (e) => {
if (["ArrowRight", "ArrowDown", "PageDown", " ", "Enter"].includes(e.key)) show(current + 1);
else if (["ArrowLeft", "ArrowUp", "PageUp", "Backspace"].includes(e.key)) show(current - 1);
else if (e.key === "Home") show(0);
else if (e.key === "End") show(slides.length - 1);
else if (e.key === "f") document.documentElement.requestFullscreen?.();
else return;
e.preventDefault();
});
addEventListener("click", (e) => {
if (e.target.closest("a, button, input, select, textarea, video")) return;
show(e.clientX > innerWidth / 2 ? current + 1 : current - 1);
});
let startX = null;
addEventListener("touchstart", (e) => { startX = e.touches[0].clientX; }, { passive: true });
addEventListener("touchend", (e) => {
const dx = startX === null ? 0 : e.changedTouches[0].clientX - startX;
if (Math.abs(dx) > 40) show(dx < 0 ? current + 1 : current - 1);
startX = null;
});
addEventListener("resize", fit);
addEventListener("hashchange", () => show(fromHash()));
fit();
show(fromHash());
</script>
</body>
</html>
```
For numbers that stay current, make the deck a page of the app that holds the data and fill
the slides from `tiny.db` (`sumBy`, `countBy`) when it opens.
## Checks
- Each slide can be understood in the three seconds it is on screen.
- The headlines alone tell the story.
- It reads from the back of a room: nothing under 36px on a 1920px slide.
- Printed or saved as PDF, every slide is one page and nothing is cut off.
SHA-256: 32dcd6e705d348c8c064df6a7e1ab7de4583a0dd959d6c55c48f2f709a1d4677