diff --git a/packages/flint-mcp/ui/src/BoardView.tsx b/packages/flint-mcp/ui/src/BoardView.tsx
index 0b7871e7..627da14b 100644
--- a/packages/flint-mcp/ui/src/BoardView.tsx
+++ b/packages/flint-mcp/ui/src/BoardView.tsx
@@ -44,6 +44,7 @@ import { boardPng } from './board-export';
import { SelectionChips, chipText, impliedParts, partText } from './selection-chips';
import { ViewSwitch, useCellViews, useChartTable, type CellView } from './chart-table-view';
import { ActionButton, ThemeControl } from './controls';
+import { usePageScroll } from './page-scroll';
import { LINK_LAYER, conditionUpdates, gestureParts, shownFields, type ChartLink, type LinkCondition, type LinkSpec } from 'flint-chart/interactive';
export interface BoardChart {
@@ -733,16 +734,8 @@ export function BoardView({ app, initial, hostContext }: { app: App; initial: Bo
document.documentElement.style.background = style.background;
document.body.style.background = style.background;
}, [style.background]);
- // Inline, the card is sized to the board, so the page never scrolls. A scrollbar would appear while the
- // host catches up with a new height, narrow the board, lay every chart out again, and change the height
- // again. In a pane the host sets the height, so a taller board scrolls, with its gutter kept so the
- // scrollbar never narrows it.
const paned = hostContext?.displayMode === 'fullscreen' || hostContext?.displayMode === 'pip';
- useEffect(() => {
- document.documentElement.style.overflow = paned ? 'hidden auto' : 'hidden';
- document.documentElement.style.scrollbarGutter = paned ? 'stable' : '';
- document.body.style.overflow = paned ? 'visible' : 'hidden';
- }, [paned]);
+ usePageScroll(hostContext, paned);
const byId = useMemo(() => new Map(charts.map((chart) => [chart.id, chart])), [charts]);
const grid = draft ?? board.grid;
diff --git a/packages/flint-mcp/ui/src/ChartView.tsx b/packages/flint-mcp/ui/src/ChartView.tsx
index 90e8da11..80107d9a 100644
--- a/packages/flint-mcp/ui/src/ChartView.tsx
+++ b/packages/flint-mcp/ui/src/ChartView.tsx
@@ -25,6 +25,7 @@ import { chartIconFor } from './chart-icons';
import { SelectionChips, chipText, impliedParts, partText, type SelectionChip } from './selection-chips';
import { VIEW_SWITCH_LABEL, ViewSwitchIcon, useChartTable, type CellView } from './chart-table-view';
import { tablePng } from './table-export';
+import { usePageScroll } from './page-scroll';
import { conditionUpdates, selectionParts, type LinkCondition } from 'flint-chart/interactive';
import { chartContext, chartView, type ChartGesture } from '../../src/chart-context';
import {
@@ -611,16 +612,9 @@ export function ChartView({ app, shown, hostContext }: { app: App; shown: Board;
}, []);
useEffect(() => () => chartBoxObserver.current?.disconnect(), []);
- // Inline, the card is sized to the chart, so the page never scrolls: a scrollbar shown while the host
- // catches up with a new height would narrow the chart and lay it out again. In a pane the host sets
- // the height and the chart is laid out for what the pane leaves it; the page scrolls only past that,
- // with its gutter kept so the scrollbar never narrows the chart.
+ // In a pane the host sets the height and the chart is laid out for what the pane leaves it.
const paned = hostContext?.displayMode === 'fullscreen' || hostContext?.displayMode === 'pip';
- useEffect(() => {
- document.documentElement.style.overflow = paned ? 'hidden auto' : 'hidden';
- document.documentElement.style.scrollbarGutter = paned ? 'stable' : '';
- document.body.style.overflow = paned ? 'visible' : 'hidden';
- }, [paned]);
+ usePageScroll(hostContext, paned);
// Re-seed when a new tool input arrives from the host.
useEffect(() => setCurrent(input), [input]);
diff --git a/packages/flint-mcp/ui/src/page-scroll.ts b/packages/flint-mcp/ui/src/page-scroll.ts
new file mode 100644
index 00000000..c46c41eb
--- /dev/null
+++ b/packages/flint-mcp/ui/src/page-scroll.ts
@@ -0,0 +1,49 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+import { useEffect, useState } from 'react';
+import type { McpUiHostContext } from '@modelcontextprotocol/ext-apps';
+
+/** The tallest the host will draw the card inline, if it says. */
+function hostMaxHeight(hostContext?: McpUiHostContext): number | undefined {
+ const dims = hostContext?.containerDimensions as { height?: number; maxHeight?: number } | undefined;
+ const cap = dims?.maxHeight ?? dims?.height;
+ return typeof cap === 'number' && Number.isFinite(cap) && cap > 0 ? cap : undefined;
+}
+
+/** How far a scrolling page must shrink below the cap before it stops scrolling, so the gutter cannot flip it back and forth. */
+const HYSTERESIS = 16;
+
+/**
+ * Whether the page scrolls. Inline, the card is sized to the page, so it never does: a scrollbar would
+ * appear while the host catches up with a new height, narrow the content, lay it out again, and change
+ * the height again. A host that stops growing the card at a height (VS Code: 75% of its window) says so
+ * in `containerDimensions.maxHeight`; a page taller than that scrolls, or its bottom is cut off. In a pane
+ * the host sets the height, so the page scrolls past it. A scrolling page keeps its gutter so the
+ * scrollbar never narrows it.
+ */
+export function usePageScroll(hostContext: McpUiHostContext | undefined, paned: boolean): void {
+ const cap = paned ? undefined : hostMaxHeight(hostContext);
+ const [over, setOver] = useState(false);
+ useEffect(() => {
+ if (cap === undefined || typeof ResizeObserver === 'undefined') {
+ setOver(false);
+ return;
+ }
+ const read = () => {
+ const height = document.body.scrollHeight;
+ setOver((prev) => (prev ? height > cap - HYSTERESIS : height > cap + 1));
+ };
+ read();
+ const observer = new ResizeObserver(read);
+ observer.observe(document.body);
+ return () => observer.disconnect();
+ }, [cap]);
+
+ const scrolls = paned || over;
+ useEffect(() => {
+ document.documentElement.style.overflow = scrolls ? 'hidden auto' : 'hidden';
+ document.documentElement.style.scrollbarGutter = scrolls ? 'stable' : '';
+ document.body.style.overflow = scrolls ? 'visible' : 'hidden';
+ }, [scrolls]);
+}
diff --git a/site/src/components/PromptBlock.tsx b/site/src/components/PromptBlock.tsx
new file mode 100644
index 00000000..270ae288
--- /dev/null
+++ b/site/src/components/PromptBlock.tsx
@@ -0,0 +1,77 @@
+import { useState, type CSSProperties } from 'react';
+import { useTranslation } from 'react-i18next';
+import { siteTheme } from '../shared/theme';
+
+const HAIRLINE = 'rgba(0, 0, 0, 0.10)';
+
+/**
+ * A monospace block of text. With `copyable`, it is a prompt the reader pastes into their agent, with a
+ * copy button over its top-right corner.
+ */
+export function PromptBlock({ children, copyable = false }: { children: string; copyable?: boolean }) {
+ const { t } = useTranslation();
+ const [copied, setCopied] = useState(false);
+
+ async function copy() {
+ await navigator.clipboard.writeText(children);
+ setCopied(true);
+ window.setTimeout(() => setCopied(false), 1600);
+ }
+
+ return (
+
+ {copyable ? (
+
+ ) : null}
+
{children}
+
+ );
+}
+
+const wrapStyle: CSSProperties = {
+ margin: '4px 0 8px',
+ border: `1px solid ${HAIRLINE}`,
+ borderRadius: 8,
+ background: 'rgba(0,0,0,0.025)',
+ overflow: 'auto',
+ position: 'relative',
+};
+
+const preStyle: CSSProperties = {
+ margin: 0,
+ padding: '14px 16px',
+ fontFamily: siteTheme.fontMono,
+ fontSize: 13,
+ lineHeight: 1.6,
+ color: siteTheme.text,
+};
+
+const preCopyableStyle: CSSProperties = {
+ paddingRight: 128,
+};
+
+const copyButtonStyle: CSSProperties = {
+ position: 'absolute',
+ top: 8,
+ right: 8,
+ display: 'inline-flex',
+ alignItems: 'center',
+ gap: 6,
+ border: `1px solid rgba(0, 102, 204, 0.24)`,
+ borderRadius: 7,
+ background: 'rgba(0, 102, 204, 0.08)',
+ color: siteTheme.accent,
+ fontFamily: siteTheme.fontSans,
+ fontSize: 12.5,
+ fontWeight: 600,
+ padding: '5px 10px',
+ cursor: 'pointer',
+};
+
+const copyIconStyle: CSSProperties = {
+ fontSize: 13,
+ lineHeight: 1,
+};
diff --git a/site/src/global.css b/site/src/global.css
index 460010ed..b42230ca 100644
--- a/site/src/global.css
+++ b/site/src/global.css
@@ -130,4 +130,18 @@ input[type='range'].site-range:focus-visible {
margin-left: auto;
flex-shrink: 0;
}
-}
\ No newline at end of file
+}
+/* A copyable prompt: the copy button floats over the block's top-right corner, beside the short first line. */
+.prompt-block-copyable pre {
+ padding: 14px 14px 12px !important;
+ font-size: 12px !important;
+ white-space: pre-wrap;
+ overflow-wrap: anywhere;
+}
+
+@media (max-width: 520px) {
+ /* Too narrow for the button beside the first line: it keeps a row of its own. */
+ .prompt-block-copyable pre {
+ padding-top: 42px !important;
+ }
+}
diff --git a/site/src/i18n/messages/en.json b/site/src/i18n/messages/en.json
index f980c8c3..5c5c1de2 100644
--- a/site/src/i18n/messages/en.json
+++ b/site/src/i18n/messages/en.json
@@ -400,6 +400,11 @@
"ctaMcp": "Get MCP Server",
"ctaGithub": "Visit GitHub",
"ctaDocs": "Read the docs",
+ "tryIt": {
+ "title": "Try it now",
+ "body": "Copy this prompt into your AI agent, such as GitHub Copilot, Claude Code, Cursor or Codex. It adds the Flint MCP server and draws your first chart.",
+ "manual": "Wondering about the experience? Check out the MCP server."
+ },
"news": {
"title": "Updates",
"video": "Video",
@@ -444,11 +449,12 @@
"howItWorksBody": "A Flint spec consists of the data, semantic types, the chart spec, and optional theme and interaction specs. Instead of relying on complex user-side logic to glue them together, the compiler does the heavy lifting: it resolves each part against the others and composes a complete backend-native spec (shown here in Vega-Lite), filling in the necessary low-level details, and renders a good-looking, interactive chart.",
"overviewAlt": "Flint workflow: an agent infers a dataSpec from a raw table, a short chartSpec is written, and Flint compiles it into a faceted line chart, then a grouped bar, waterfall, heatmap, and sunburst as the spec is edited.",
"leadBefore": "Flint is a visualization intermediate language that lets",
- "leadHighlight1": "AI agents reliably create expressive, good-looking and interactive charts from simple, human-editable chart specs",
+ "leadHighlight1": "AI agents reliably create expressive, good-looking and interactive charts from simple, human-editable specs",
"leadStop": ". ",
- "leadAvailability": "It is available as an MCP server for everyday use with your agent, and as an npm library for building interactive applications.",
- "leadHighlight2": "Flint supports {{chartTypes}} chart types across {{backends}} rendering backends through one unified interface, with {{themes}} themes and {{presets}} interaction presets",
- "leadAfter": "To create bespoke visualizations, you can design custom themes in the Theme Lab and build advanced interactions with the Flint API.",
+ "leadInsight": "The key design is to disentangle the visual, style and interaction logic that low-level chart libraries mix together: you or your agents describe each in a short semantic spec, and the compiler composes them.",
+ "leadAvailability": "Use it as an MCP server with your agent, or as an npm library for building interactive applications.",
+ "leadHighlight2": "Flint supports {{chartTypes}} chart types across {{backends}} rendering backends, {{themes}} themes and {{presets}} interaction presets",
+ "leadAfter": "For bespoke visualizations, design your own themes in the Theme Lab and build advanced interactions with the Flint API. ",
"backendRosterLabel": "Backends",
"themeRosterLabel": "Themes",
"interactionRosterLabel": "Interactions",
@@ -565,6 +571,8 @@
"leadBefore": "Install flint-chart-mcp as a",
"leadMcpLink": "Model Context Protocol",
"leadAfter": "server and your agent can create interactive charts or author reusable visual themes. By default it opens an interactive Flint chart view; it can also return static artifacts and guide agents through a formal ThemeSpec.",
+ "copyPrompt": "Copy prompt",
+ "copied": "Copied",
"quickStart": "Quick start:",
"quickStartBody": "paste this setup request into your agent and let it configure Flint for the current project. For manual setup, see",
"installConfigure": "install & configure",
diff --git a/site/src/i18n/messages/zh-CN.json b/site/src/i18n/messages/zh-CN.json
index 582589a8..ee222ca6 100644
--- a/site/src/i18n/messages/zh-CN.json
+++ b/site/src/i18n/messages/zh-CN.json
@@ -400,6 +400,11 @@
"ctaMcp": "使用 MCP 服务器",
"ctaGithub": "访问 GitHub",
"ctaDocs": "阅读文档",
+ "tryIt": {
+ "title": "立即试用",
+ "body": "把这段提示词复制到你的 AI 智能体(如 GitHub Copilot、Claude Code、Cursor 或 Codex)。它会添加 Flint MCP 服务器,并画出你的第一张图表。",
+ "manual": "想了解使用体验?请查看 MCP 服务器页面。"
+ },
"news": {
"title": "更新",
"video": "视频",
@@ -444,11 +449,12 @@
"howItWorksBody": "一份 Flint 规范由数据、语义类型、图表规范,以及可选的主题和交互规范组成。无需在使用方编写复杂逻辑把它们拼接起来,编译器会完成繁重的工作:它将各部分相互解析,组合出完整的后端原生规范(此处以 Vega-Lite 为例),补全必要的底层细节,并渲染出美观、可交互的图表。",
"overviewAlt": "Flint 工作流:智能体从原始表格推断 dataSpec,编写简短的 chartSpec,Flint 将其编译为按地区展示的折线图;随后在编辑规范时依次得到分组柱状图、瀑布图、热力图与旭日图。",
"leadBefore": "Flint 是一种可视化中间语言,帮助",
- "leadHighlight1": "AI 智能体从简洁、可人工编辑的图表规范出发,稳定生成表现力强、观感出色且可交互的图表",
+ "leadHighlight1": "AI 智能体从简洁、可人工编辑的规范出发,稳定生成表现力强、观感出色且可交互的图表",
"leadStop": "。",
- "leadAvailability": "你可以通过 MCP 服务器在日常工作中配合智能体使用它,也可以用 npm 库构建交互式应用。",
- "leadHighlight2": "Flint 通过统一接口,在 {{backends}} 种渲染后端上支持 {{chartTypes}} 种图表类型,并提供 {{themes}} 套主题和 {{presets}} 种交互预设",
- "leadAfter": "如需定制可视化,可以在主题实验室中设计自定义主题,并用 Flint API 构建高级交互。",
+ "leadInsight": "其核心设计是把底层图表库中混在一起的视觉逻辑、样式逻辑和交互逻辑解耦:你或你的智能体分别用简短的语义规范描述它们,由编译器将它们组合起来。",
+ "leadAvailability": "你可以把它作为 MCP 服务器配合智能体使用,也可以作为 npm 库构建交互式应用。",
+ "leadHighlight2": "Flint 在 {{backends}} 种渲染后端上支持 {{chartTypes}} 种图表类型,并提供 {{themes}} 套主题和 {{presets}} 种交互预设",
+ "leadAfter": "如需定制可视化,可以在主题实验室中设计自己的主题,并用 Flint API 构建高级交互。",
"backendRosterLabel": "渲染后端",
"themeRosterLabel": "主题",
"interactionRosterLabel": "交互",
@@ -565,6 +571,8 @@
"leadBefore": "将 flint-chart-mcp 配置为",
"leadMcpLink": "Model Context Protocol",
"leadAfter": "服务器后,智能体既能创建交互式图表,也能编写可复用的视觉主题。Flint 默认打开可交互的图表视图;也可以导出静态结果,并引导智能体通过正式的 ThemeSpec 定义视觉设计。",
+ "copyPrompt": "复制提示词",
+ "copied": "已复制",
"quickStart": "让 AI 智能体帮你配置:",
"quickStartBody": "把下面这段请求发给智能体即可。若想手动配置,请参阅",
"installConfigure": "安装与配置",
diff --git a/site/src/routes/Landing.tsx b/site/src/routes/Landing.tsx
index d5e08ede..8d3c0341 100644
--- a/site/src/routes/Landing.tsx
+++ b/site/src/routes/Landing.tsx
@@ -12,6 +12,9 @@ import { ScaleToFit } from '../components/ScaleToFit';
import { GalleryOptionsBar, ThemeControl } from '../components/GalleryOptionsBar';
import { SpecPipelineFigure } from '../components/SpecPipelineFigure';
import { CodeBlock } from '../components/CodeBlock';
+import { PromptBlock } from '../components/PromptBlock';
+import { MCP_SETUP_PROMPT } from '../shared/mcp-setup';
+import { Zap } from 'lucide-react';
import stringify from 'json-stringify-pretty-compact';
import { testCaseToFlintSummary, testCaseToAssemblyInput, withHouse, withHouseId } from '../shared/test-case-utils';
import { buildPanelModel, withoutEchoedOverrides } from '../shared/chart-options';
@@ -64,7 +67,7 @@ export function Landing() {
{/* ---- Hero ------------------------------------------------------ */}
-
+
@@ -64,18 +65,25 @@ const DIFF = {
};
const GLUE_LINES = glue.trimEnd().split('\n').length;
-/** A playful theme an agent might write from a one-line prompt; the slide shows this exact object. */
-const FUN_THEME = {
- extends: 'cartoon',
- id: 'theme-park',
- label: 'Theme park',
+/** What is wrong with the raw chart, circled on it. */
+const RAW_FLAWS: Flaw[] = [
+ { role: 'marks', label: 'The chart runs far too wide for the page.' },
+ { role: 'x-axis', label: 'Months show as raw numbers like 202101.' },
+ { role: 'legend', label: 'Losses and gains share one color ramp, with no midpoint at zero.' },
+];
+
+/** A brand theme an agent might write from a short style guide; the slide shows this exact object. */
+const BRAND_THEME = {
+ extends: 'swiss',
+ id: 'northwind',
+ label: 'Northwind',
ink: {
- surface: { source: 'house', canvas: '#fdf6ff', plot: '#fdf6ff' },
- series: { categorical: ['#ff6fb5', '#4cb8ff', '#ffc93c', '#9b6cff', '#38d39f', '#ff8a5c'] },
- accent: '#ff6fb5',
+ text: { primary: '#14213d', secondary: '#4a5568' },
+ series: { single: '#1f3b73', categorical: ['#1f3b73', '#1b998b', '#e3a72f', '#8d99ae', '#c8553d', '#5b8e7d'] },
+ accent: '#1b998b',
},
- type: { headline: { family: "'Chalkboard SE', 'Comic Neue', cursive", weight: 'bold' } },
- marks: { cornerRadius: 12, strokeWeight: 5 },
+ type: { headline: { family: "Georgia, 'Times New Roman', serif", weight: 'bold' } },
+ structure: { grid: { measure: 'quiet', category: 'omit' } },
} as unknown as ThemeSpec;
const PRESETS: { caption: string; spec: ChartAssemblyInput }[] = [
@@ -109,6 +117,59 @@ const TLDR_SPEC = `{
// After the Flint version: one request at a time, each starting where the last one left off.
const FLINT_W = 52;
+/**
+ * The type tree: the drawn boxes and connectors from the sketch, with the branch text set over them in
+ * the deck's own type. Both sit on the same 1000 × 720 frame, so the text stays on its line at any size.
+ */
+const TypeTree = () => (
+
+);
+
+/** The three use cases, labelled under the sketch's three panels. */
+const USE_CASES = [
+ { title: 'Explore data', short: 'A chart or a dashboard, right in your chat.', long: 'Ask, and a live chart or dashboard opens in your chat through the Flint MCP server.' },
+ { title: 'Build apps', short: 'Flint as a component in your app.', long: 'Your coding agent writes Flint into the app as a component and wires it to the rest of the page.' },
+ { title: 'Design', short: 'One theme for every chart.', long: 'Write your house style once as a theme, and every chart in every library follows it.' },
+];
+
+/** The three specs, labelled under the sketch's three panels, each in its section color. */
+const SPECS = [
+ { title: 'The chart spec', short: 'What the data means.', long: 'Semantic types and a layout engine take care of what the data means.', color: '#2f6db5' },
+ { title: 'The theme spec', short: 'How it looks.', long: 'A formal specification of style, written once for every chart.', color: '#e8954a' },
+ { title: 'The interaction spec', short: 'How it behaves.', long: 'Semantic events and update operators describe how a chart behaves.', color: '#d9534f' },
+];
+
+/**
+ * A three-panel sketch with readable labels under its panels. With `focus`, the sketch circles that
+ * panel, its label is spelled out, and the other two fade back.
+ */
+const Trio = ({ sketch, items, focus }: {
+ sketch: string; items: { title: string; short: string; long: string; color?: string }[]; focus?: number;
+}) => (
+
+
+
+ {items.map((u, i) => (
+
+
{i + 1}. {u.title}
+
{focus === i ? u.long : u.short}
+
+ ))}
+
+
+);
+const UseCases = ({ focus }: { focus?: number }) => ;
+
/** The "draw your guess" demo's interaction, condensed: a trigger, and a handler that answers with an update. */
const BESPOKE_ROWS: CodeRow[] = [
{ text: 'const draw: CanvasInteractionDef = {', hot: true },
@@ -152,16 +213,6 @@ const APP_ROWS: CodeRow[] = [
{ text: '' },
];
-/** The semantic types Flint knows, from its type registry, grouped as the registry groups them. */
-const SEMANTIC_TYPES: [string, string][] = [
- ['Points in time', 'DateTime, Date, Time, Timestamp'],
- ['Time units', 'Year, Quarter, Month, Week, Day, Hour, YearMonth, YearQuarter, YearWeek, Decade, Duration'],
- ['Measures', 'Quantity, Count, Amount, Price, Percentage, Temperature'],
- ['Signed measures', 'Profit, PercentageChange, Sentiment, Correlation'],
- ['Ordered numbers', 'Rank, Score, ID'],
- ['Places', 'Country, State, City, Region, Address, ZipCode, Latitude, Longitude'],
- ['Categories', 'Category, Name, Status, Boolean, Direction, Range'],
-];
/** The parts of the real "economist" preset that the theme slides talk about. */
const ECON = (THEME_PRESETS as Record }>).economist.spec;
@@ -236,7 +287,7 @@ export const SLIDES: SlideDef[] = [
{
id: 'title', kind: 'title', render: () => (<>
Flint: a visualization language for the AI era
-
Chenglong Wang, Yuwei Xiao, Kecheng Lu, Yunhai Wang, Alper Sarikaya, Michel Galley, Chris Quirk, Jianfeng Gao Deep Learning Group, Microsoft Research
Flint is a visualization language for AI agents to reliably create polished data visualizations. The agent writes a short, simple spec, and Flint's compiler takes care of the rest.
Task: "Make a heatmap of net new users by game and month for our report page, in The Economist style, and let me click a game to highlight it next to our table."
- The same few lines give a valid spec and a wrong chart. To fix it we parse 202101 into a date, sum the four regions in each cell, and centre the colours on zero, adding {DIFF.parse.plus} lines.>}
- />
+ id: 'broken', render: () => (<>
+
Plug the data in, and the chart breaks
+
+
+
+
>),
},
{
- id: 'attempt-2', render: () => (<>
-
Attempt two: five years of months need a new layout
+ id: 'attempt-1', render: () => (<>
+
Let's fix parsing and layout
Sixty months crowd the axis with Jan to Dec five times over. We widen the chart, label each year once, give long game names room, and move the legend to the top. That adds {DIFF.layout.plus} lines and changes {DIFF.layout.minus}.>}
+ before={ROWS.raw} beforeSpec={withData(STEPS.raw)}
+ after={stepLayout(STEPS.layout, STEPS.raw)} afterSpec={withData(STEPS.layout)}
+ note={<>Parse 202101 into a date, sum the four regions, centre the colours on zero, then widen the chart and label each year once: {lineDiff(STEPS.raw, STEPS.layout).plus} lines.>}
/>
>),
},
@@ -333,7 +375,7 @@ export const SLIDES: SlideDef[] = [
id: 'theme-vl', render: () => (<>
Making it look like The Economist is mostly new work
Fonts and axes go into the config, the house colours into the encoding, and the red tab, headline, and source line become extra views placed by hand. The spec grows by {DIFF.theme.plus} lines.>}
/>
@@ -362,7 +404,7 @@ export const SLIDES: SlideDef[] = [
-
A click filters the table and a picker selects a game. These {GLUE_LINES} lines talk in signal names and internal stores, not in terms of the data.
Low-level configuration ties together what the data means, how the chart looks, and how it behaves. Every change ripples into the others.
-
"The logic depends on coordinates, pixels, and SVG paths, all tangled together. So the agent reasons, writes, debugs, and goes around again, and still hands you something fragile."
Flint is a language for AI agents that disentangles visual and interaction logic
+
Flint is a language for AI agents that disentangles visual and interaction logic
-
You and your agent work with the high-level specs, without losing control. The compiler takes care of data parsing, layout, events, design tokens, and the dependencies between them.
Semantic types: a small vocabulary with a lot behind it
-
-
- {SEMANTIC_TYPES.map(([family, types]) =>
{family}
{types}
)}
-
-
+
Agents are really good at this. Saying that a column is a month, a profit, or a country is just reading the data, and it is far easier than writing parsing, scale, and format code.
The layout engine: the data pushes out, the canvas pushes back
-
Each item is a spring that wants its own room, and the canvas is a stiffer spring that resists growing. The plot settles where the two balance, never past the most it may stretch.
Describe the chart and how it should behave. The agent writes the interaction spec next to the chart spec, and the chart appears in the conversation, ready to hover and read.
-
-
-
-
Visualize U.S. egg and bread prices since 2015, and let me hover to read both at any month.
-
-
Here it is. Hover along the timeline to read both prices.
"Create a theme inspired by a Disneyland day out: candy colors, rounded shapes, and a playful font."
-
+
"Here is our brand guide: navy and teal, slate for supporting series, Georgia for headlines, and quiet grids. Write a Flint theme so every chart in our reports matches."
Add the Flint MCP server to GitHub Copilot or your own agent with npx -y flint-chart-mcp, and ask for styled, interactive charts, reports, and dashboards right in the chat.
+
1. If you explore data
+
Add the Flint MCP server to GitHub Copilot or your own agent with npx -y flint-chart-mcp, and ask for charts and dashboards right in the chat.
-
If you build interactive apps
+
2. If you build apps
Build Flint into your product with npm install flint-chart. Give your agent the Flint skills, and its charts will talk to your tables, widgets, and app state.
-
If you design
-
Let's work on new themes together. Your team's style guide can become a Flint theme that every chart, on every library, follows.
+
3. If you design
+
Let's work on new themes together. Your team's style guide can become a Flint theme that every chart follows.
We want to collaborate! Ping me and I'm happy to demonstrate Flint to your team, and to work together on the next generation of interactive artifacts.
diff --git a/site/src/talk/talk.css b/site/src/talk/talk.css
index 8c6b5cbe..4b74233d 100644
--- a/site/src/talk/talk.css
+++ b/site/src/talk/talk.css
@@ -42,7 +42,6 @@
.talk-slide strong { color: var(--ink); font-weight: 650; }
.talk-slide code { font: 500 0.86em/1.3 ui-monospace, 'SF Mono', Menlo, Consolas, monospace; color: var(--ink); background: var(--panel); padding: 0.06em 0.3em; border-radius: 6px; }
.talk-lead { font-size: 34px !important; line-height: 1.4; color: var(--ink) !important; }
-.talk-quote { font-size: 32px; line-height: 1.45; color: var(--ink); font-style: italic; }
.c-meaning { color: var(--meaning); }
.c-look { color: var(--look); }
.c-behavior { color: var(--behavior); }
@@ -110,10 +109,6 @@
.talk-slide.is-title h1 { font-size: 80px; max-width: 1300px; margin-bottom: 16px; }
.talk-slide.is-section h1 { font-size: 76px; }
.talk-slide.is-statement h1 { font-size: 64px; max-width: 1300px; }
-.talk-bar { width: 120px; height: 10px; border-radius: 5px; margin-bottom: 32px; flex: none; }
-.talk-bar.meaning { background: var(--meaning); }
-.talk-bar.look { background: var(--look); }
-.talk-bar.behavior { background: var(--behavior); }
/* A chat, as an agent client shows it. */
.talk-chat { flex: 1 1 auto; min-height: 0; display: flex; flex-direction: column; gap: 16px; background: var(--panel); border-radius: 16px; padding: 22px; }
@@ -164,14 +159,16 @@
.talk-dashboard .idash-heading h1 { font-size: 44px; line-height: 1.1; max-width: none; }
/* Call to action: one card per audience, each with its section color on top. */
-.talk-cta-wrap { flex: 1 1 auto; min-height: 0; display: flex; flex-direction: column; justify-content: center; gap: 32px; }
+.talk-cta-wrap { flex: 1 1 auto; min-height: 0; display: flex; flex-direction: column; justify-content: center; gap: 22px; }
+/* The three use cases, as the act 4 sketch draws them, above the card for each. */
+.talk-cta-sketch { flex: 1 1 200px; min-height: 140px; max-height: 240px; position: relative; }
.talk-cta-wrap > .talk-cta { flex: none; align-items: stretch; gap: 28px; }
-.talk-slide .talk-collab { margin: 0; font-size: 30px; line-height: 1.45; padding: 22px 28px; }
-.talk-cta-card { background: var(--panel); border-radius: 12px; border-top: 6px solid #2f6db5; padding: 22px 26px; }
+.talk-slide .talk-collab { margin: 0; font-size: 27px; line-height: 1.4; padding: 16px 26px; }
+.talk-cta-card { background: var(--panel); border-radius: 12px; border-top: 6px solid #2f6db5; padding: 18px 24px; }
.talk-cta-card.look { border-top-color: #e8954a; }
.talk-cta-card.behavior { border-top-color: #d9534f; }
.talk-cta-card h3 { margin: 0 0 14px; }
-.talk-cta-card p { font-size: 26px; line-height: 1.45; margin: 0; }
+.talk-cta-card p { font-size: 23px; line-height: 1.4; margin: 0; }
/* A side-by-side demo stacked for a narrow slot: the chart on top, the table below it. */
.talk-slide .talk-stacked-demo .ig-continent-cohort .it-workspace { grid-template-columns: minmax(0, 1fr); }
@@ -196,3 +193,38 @@
box-shadow: 0 8px 22px rgba(0, 40, 90, 0.12); overflow: hidden;
}
.talk-themes-card:hover { z-index: 20 !important; }
+
+/* Labels under the use-case sketch: one column per panel, in the deck's own type. */
+.talk-usecases { flex: none; display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 40px; padding: 0 3%; }
+.talk-usecases h3 { margin: 0 0 6px; text-align: center; }
+.talk-usecases p { margin: 0; font-size: 24px; line-height: 1.4; text-align: center; }
+.talk-usecases .on h3 { color: #c0392b; }
+.talk-usecases .off { opacity: 0.4; }
+
+/* The first slide of each act: its title leads with a mark, in place of a separate divider slide. */
+.talk-slide h2.is-act::before {
+ content: ''; display: inline-block; width: 0.42em; height: 0.42em; margin: 0 0.5em 0 0.06em;
+ background: #0067b8; border-radius: 3px; transform: rotate(45deg); vertical-align: 0.14em;
+}
+
+/* A callout that floats over the slide like a sticky note, out of the layout's flow. */
+.talk-slide .talk-callout {
+ position: absolute; top: 46px; right: 64px; z-index: 5; max-width: 420px; margin: 0;
+ padding: 18px 22px; border-radius: 10px; background: #fff7d6; border: 1.5px solid #e8c766;
+ color: var(--ink); font-size: 27px; line-height: 1.35; font-weight: 550;
+ box-shadow: 0 12px 28px rgba(60, 45, 0, 0.18); transform: rotate(1.6deg);
+}
+
+/* The problems circled on a chart, numbered to match its red badges. */
+.talk-flaws { flex: none; display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 40px; margin: 8px 0 0; padding: 0; list-style: none; }
+.talk-flaws li { display: flex; align-items: flex-start; gap: 12px; margin: 0; font-size: 26px; line-height: 1.35; color: var(--ink); }
+.talk-flaws span { flex: none; width: 34px; height: 34px; border-radius: 50%; background: #e4572e; color: #fff; font-weight: 700; font-size: 20px; display: grid; place-items: center; }
+
+/* A sketch with text laid over it: the frame keeps the sketch's aspect, so text and lines stay aligned. */
+.talk-frame { position: absolute; inset: 0; margin: auto; max-width: 100%; max-height: 100%; container-type: size; }
+.talk-frame .talk-sketch { position: absolute; inset: 0; }
+.talk-leaf { position: absolute; transform: translateY(-50%); white-space: nowrap; font-size: 2.9cqw; color: var(--ink); line-height: 1.2; }
+.talk-leaf.mono { font: 500 1.9cqw/1.2 ui-monospace, 'SF Mono', Menlo, Consolas, monospace; }
+.talk-leaf.muted { color: var(--ink-3); }
+.talk-leaf.good { color: #3d7a27; }
+.talk-slide .talk-callout.talk-callout-inline { position: relative; top: auto; right: auto; flex: none; max-width: none; margin: 0 8px 8px; transform: rotate(-1deg); }