mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
Every page now loads /webmcp.js, scripts/webmcp.ts with its types stripped (npm run webmcp). Where the browser has document.modelContext it registers two read-only tools: search_skills over the published skills index, and get_skill, which returns a skill's markdown checked against the index digest. The markdown alternate link moves from build.py to site.py, so CI holds every page to it. The API catalog gains the site itself (llms.txt and the skills index) and hanzo.ai/agents; the live discovery check now fetches every catalog link. tests/site.mjs drives the tools through a recording modelContext, and checks a browser without one loads clean.
508 lines
21 KiB
HTML
508 lines
21 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>streaming-and-loading</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/streaming-and-loading">
|
|
<link rel="alternate" type="text/markdown" href="/streaming-and-loading.md">
|
|
<script type="module" src="/webmcp.js"></script>
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/streaming-and-loading.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>streaming-and-loading</h1><p class="lede">Content that appears instantly feels fast.</p><h1>Streaming and Progressive Loading</h1>
|
|
<p>Content that appears instantly feels fast. Stream when possible, load progressively.</p>
|
|
<h2>Streaming Text</h2>
|
|
<p>For real-time text streaming (like ChatGPT):</p>
|
|
<pre><code class="lang-typescript">function StreamingText({ stream }: { stream: ReadableStream<Uint8Array> }) {
|
|
const [content, setContent] = useState('');
|
|
const [isComplete, setIsComplete] = useState(false);
|
|
|
|
useEffect(() => {
|
|
const reader = stream.getReader();
|
|
const decoder = new TextDecoder();
|
|
|
|
async function read() {
|
|
try {
|
|
while (true) {
|
|
const { done, value } = await reader.read();
|
|
if (done) {
|
|
setIsComplete(true);
|
|
break;
|
|
}
|
|
|
|
const text = decoder.decode(value, { stream: true });
|
|
setContent(prev => prev + text);
|
|
}
|
|
} catch (error) {
|
|
console.error('Stream error:', error);
|
|
setIsComplete(true);
|
|
}
|
|
}
|
|
|
|
read();
|
|
|
|
return () => {
|
|
reader.cancel();
|
|
};
|
|
}, [stream]);
|
|
|
|
return (
|
|
<div className="streaming-content">
|
|
{content}
|
|
{!isComplete && <span className="cursor-blink">▊</span>}
|
|
</div>
|
|
);
|
|
}</code></pre>
|
|
<h3>Cursor Animation</h3>
|
|
<pre><code class="lang-css">.cursor-blink {
|
|
animation: blink 1s ease-in-out infinite;
|
|
font-family: 'Zen Mono', monospace;
|
|
}
|
|
|
|
@keyframes blink {
|
|
0%, 49% { opacity: 1; }
|
|
50%, 100% { opacity: 0; }
|
|
}</code></pre>
|
|
<h2>Progressive Loading Patterns</h2>
|
|
<h3>1. Skeleton Screens (Preferred)</h3>
|
|
<p>Skeleton screens are better than spinners for predictable layouts.</p>
|
|
<pre><code class="lang-css">.skeleton {
|
|
background: linear-gradient(
|
|
90deg,
|
|
#f0f0f0 25%,
|
|
#e0e0e0 50%,
|
|
#f0f0f0 75%
|
|
);
|
|
background-size: 200% 100%;
|
|
animation: shimmer 1.5s ease-in-out infinite;
|
|
border-radius: 4px;
|
|
}
|
|
|
|
@keyframes shimmer {
|
|
0% { background-position: 200% 0; }
|
|
100% { background-position: -200% 0; }
|
|
}
|
|
|
|
/* Dark mode */
|
|
@media (prefers-color-scheme: dark) {
|
|
.skeleton {
|
|
background: linear-gradient(
|
|
90deg,
|
|
#1a1a1a 25%,
|
|
#2a2a2a 50%,
|
|
#1a1a1a 75%
|
|
);
|
|
}
|
|
}</code></pre>
|
|
<p><strong>Usage:</strong></p>
|
|
<pre><code class="lang-tsx">function CardSkeleton() {
|
|
return (
|
|
<div className="card">
|
|
<div className="skeleton" style={{ height: '200px', marginBottom: '1rem' }} />
|
|
<div className="skeleton" style={{ height: '1.5rem', width: '60%', marginBottom: '0.5rem' }} />
|
|
<div className="skeleton" style={{ height: '1rem', width: '100%' }} />
|
|
<div className="skeleton" style={{ height: '1rem', width: '80%' }} />
|
|
</div>
|
|
);
|
|
}</code></pre>
|
|
<h3>2. Incremental Rendering</h3>
|
|
<p>Load critical content first, defer below-the-fold:</p>
|
|
<pre><code class="lang-typescript">function Page() {
|
|
const [aboveFold, setAboveFold] = useState(null);
|
|
const [belowFold, setBelowFold] = useState(null);
|
|
|
|
useEffect(() => {
|
|
// Load critical content immediately
|
|
fetchAboveFold().then(setAboveFold);
|
|
|
|
// Delay below-fold content
|
|
setTimeout(() => {
|
|
fetchBelowFold().then(setBelowFold);
|
|
}, 100);
|
|
}, []);
|
|
|
|
return (
|
|
<>
|
|
{aboveFold ? <AboveFold data={aboveFold} /> : <Skeleton />}
|
|
{belowFold ? <BelowFold data={belowFold} /> : null}
|
|
</>
|
|
);
|
|
}</code></pre>
|
|
<h3>3. Optimistic Updates</h3>
|
|
<p>Assume success, rollback on error:</p>
|
|
<pre><code class="lang-typescript">function TodoList() {
|
|
const [items, setItems] = useState<Todo[]>([]);
|
|
|
|
const addItem = async (newItem: Omit<Todo, 'id'>) => {
|
|
// Create temporary item
|
|
const tempItem = { ...newItem, id: 'temp', pending: true };
|
|
|
|
// Add immediately (optimistic)
|
|
setItems(prev => [...prev, tempItem]);
|
|
|
|
try {
|
|
// Save to server
|
|
const saved = await api.saveTodo(newItem);
|
|
|
|
// Replace temp with real
|
|
setItems(prev => prev.map(item =>
|
|
item.id === 'temp' ? saved : item
|
|
));
|
|
} catch (error) {
|
|
// Rollback on error
|
|
setItems(prev => prev.filter(item => item.id !== 'temp'));
|
|
toast.error('Failed to add item');
|
|
}
|
|
};
|
|
|
|
return (
|
|
<div>
|
|
{items.map(item => (
|
|
<TodoItem
|
|
key={item.id}
|
|
item={item}
|
|
isPending={item.pending}
|
|
/>
|
|
))}
|
|
</div>
|
|
);
|
|
}</code></pre>
|
|
<h2>Loading Indicators</h2>
|
|
<h3>Spinners</h3>
|
|
<pre><code class="lang-css">/* Elegant spinner */
|
|
.spinner {
|
|
width: 24px;
|
|
height: 24px;
|
|
border: 2px solid rgba(0, 0, 0, 0.1);
|
|
border-top-color: var(--color-primary);
|
|
border-radius: 50%;
|
|
animation: spin 0.8s cubic-bezier(0.4, 0, 0.2, 1) infinite;
|
|
}
|
|
|
|
@keyframes spin {
|
|
to { transform: rotate(360deg); }
|
|
}
|
|
|
|
/* Dots loader (more subtle) */
|
|
.dots-loader {
|
|
display: flex;
|
|
gap: 4px;
|
|
}
|
|
|
|
.dot {
|
|
width: 6px;
|
|
height: 6px;
|
|
background: var(--color-primary);
|
|
border-radius: 50%;
|
|
animation: bounce 1.4s ease-in-out infinite;
|
|
}
|
|
|
|
.dot:nth-child(1) { animation-delay: 0s; }
|
|
.dot:nth-child(2) { animation-delay: 0.2s; }
|
|
.dot:nth-child(3) { animation-delay: 0.4s; }
|
|
|
|
@keyframes bounce {
|
|
0%, 80%, 100% { transform: scale(0); opacity: 0.5; }
|
|
40% { transform: scale(1); opacity: 1; }
|
|
}</code></pre>
|
|
<h3>Progress Bars</h3>
|
|
<pre><code class="lang-css">.progress-bar {
|
|
width: 100%;
|
|
height: 4px;
|
|
background: rgba(0, 0, 0, 0.1);
|
|
border-radius: 2px;
|
|
overflow: hidden;
|
|
}
|
|
|
|
.progress-fill {
|
|
height: 100%;
|
|
background: var(--color-primary);
|
|
transition: width 0.3s ease;
|
|
}
|
|
|
|
/* Indeterminate state */
|
|
.progress-fill.indeterminate {
|
|
width: 30%;
|
|
animation: indeterminate 1.5s ease-in-out infinite;
|
|
}
|
|
|
|
@keyframes indeterminate {
|
|
0% { transform: translateX(-100%); }
|
|
100% { transform: translateX(400%); }
|
|
}</code></pre>
|
|
<h3>Loading State Hierarchy</h3>
|
|
<p>Choose based on operation duration:</p>
|
|
<ol><li><strong>< 100ms</strong>: No indicator (feels instant)</li><li><strong>100ms - 1s</strong>: Spinner or indeterminate progress bar</li><li><strong>1s - 5s</strong>: Skeleton screen + percentage if available</li><li><strong>5s+</strong>: Progress bar + time estimate + cancel button</li></ol>
|
|
<pre><code class="lang-typescript">function useLoadingIndicator(duration: number) {
|
|
if (duration < 100) return null;
|
|
if (duration < 1000) return <Spinner />;
|
|
if (duration < 5000) return <Skeleton />;
|
|
return <ProgressBar withCancel />;
|
|
}</code></pre>
|
|
<h2>Best Practices</h2>
|
|
<h3>Do:</h3>
|
|
<ul><li>✅ Use skeleton screens for predictable layouts</li><li>✅ Stream content when possible</li><li>✅ Load critical content first (above the fold)</li><li>✅ Show progress for operations > 1 second</li><li>✅ Provide cancel buttons for long operations</li><li>✅ Use optimistic updates for better perceived performance</li><li>✅ Respect reduced-motion preferences</li></ul>
|
|
<h3>Don't:</h3>
|
|
<ul><li>❌ Show spinners for instant operations (< 100ms)</li><li>❌ Block entire UI during loading</li><li>❌ Use spinners when skeleton screens would be better</li><li>❌ Forget to handle loading errors</li><li>❌ Make users wait without feedback</li><li>❌ Ignore cancel requests during long operations</li></ul>
|
|
<h2>Server-Sent Events (SSE)</h2>
|
|
<p>For server-to-client streaming:</p>
|
|
<pre><code class="lang-typescript">function useSSE(url: string) {
|
|
const [data, setData] = useState<string[]>([]);
|
|
const [error, setError] = useState<Error | null>(null);
|
|
|
|
useEffect(() => {
|
|
const eventSource = new EventSource(url);
|
|
|
|
eventSource.onmessage = (event) => {
|
|
setData(prev => [...prev, event.data]);
|
|
};
|
|
|
|
eventSource.onerror = (err) => {
|
|
setError(new Error('SSE connection error'));
|
|
eventSource.close();
|
|
};
|
|
|
|
return () => {
|
|
eventSource.close();
|
|
};
|
|
}, [url]);
|
|
|
|
return { data, error };
|
|
}</code></pre>
|
|
<h2>WebSockets</h2>
|
|
<p>For bidirectional real-time communication:</p>
|
|
<pre><code class="lang-typescript">function useWebSocket(url: string) {
|
|
const [messages, setMessages] = useState<string[]>([]);
|
|
const [isConnected, setIsConnected] = useState(false);
|
|
const wsRef = useRef<WebSocket | null>(null);
|
|
|
|
useEffect(() => {
|
|
const ws = new WebSocket(url);
|
|
wsRef.current = ws;
|
|
|
|
ws.onopen = () => setIsConnected(true);
|
|
ws.onclose = () => setIsConnected(false);
|
|
ws.onmessage = (event) => {
|
|
setMessages(prev => [...prev, event.data]);
|
|
};
|
|
|
|
return () => {
|
|
ws.close();
|
|
};
|
|
}, [url]);
|
|
|
|
const send = (message: string) => {
|
|
if (wsRef.current?.readyState === WebSocket.OPEN) {
|
|
wsRef.current.send(message);
|
|
}
|
|
};
|
|
|
|
return { messages, isConnected, send };
|
|
}</code></pre>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/streaming-and-loading.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |