用这个模板做的 3 个案例
同一份提示词,不同的 [VARIABLES] 变量。点一个在上方预览。关于这个模板
一个为命令行开发者工具打造的单页发布站,这里写的是一个叫 Ferrule 的快速代码审查 CLI。页面以分栏首屏开场:左侧是一句简短承诺、带 npm、brew 和 npx 标签页的安装命令以及一键复制按钮;右侧是一个终端窗口,循环打出两段可信的审查会话,包含加载指示器、按颜色区分的发现项和通过的 pre-commit 钩子。下方是从零绘制的 diff 查看器,展示一段看起来真实的 TypeScript 改动,审查评论逐条滑入特定行下方,每条都带严重级别标签、规则名称和可一键应用的修复建议块。其余部分保持紧凑、易扫读的节奏:六格功能网格配细线边框、配置片段、滚动时数字递增的基准条形竞速、纯文本集成标签、可展开的更新日志时间线,以及包含三个可复制步骤的最终安装区块。整站以键盘优先。按下问号键,或点击角落的提示标签,就会打开带 kbd 样式按键的快捷键浮层;快捷键真实可用,从复制安装命令到在区块间跳转、重播终端都能操作。配色以近黑色为主,搭配单一青柠信号色,diff 用语义化的绿色和红色,严重级别用琥珀色和蓝色。标题用 Space Grotesk,正文用 Inter,所有标签、数字和代码行用 JetBrains Mono,全部自托管。适合独立开发者和团队发布 CLI、linter、测试运行器、迁移工具或 AI 编程助手。修改品牌、命令名、产品类型、语言和受众后,文案、终端会话、diff 和基准会一并重写,布局和动效保持不变。开启减少动态效果时,所有动画直接跳到最终状态。
模板提示词
在线演示就是用这份提示词原样做出来的,没有额外补充。其他案例只是改了 [VARIABLES] 变量的值。 提示词保持英文原版,国内常用的 AI 编程工具都能直接理解;下面附中文参考译文。
# Dark Developer Tool Launch Page
Build this website exactly as described below. Replace the [VARIABLES] with your own values; keep everything else.
## Brief
A one-page launch site for [BRAND], a local-first [PRODUCT] for [LANGUAGES]. The page proves speed and precision by showing the product working: a hero terminal that types real-looking review sessions, a diff viewer where line comments stream in, a benchmark bar race, a keyboard shortcut overlay opened with '?', a changelog teaser and copy-to-clipboard install commands. Everything is drawn in code; there are no photos.
- Audience: [AUDIENCE]: engineers and tech leads who live in the terminal, distrust marketing pages and decide in under a minute whether a tool is worth one install command.
- Goal: Get the visitor to copy the install command and run a first review. Secondary: show exactly what a review looks like (terminal + diff), back the speed claim with an illustrative benchmark, and signal an active project through the changelog.
- Tone: Terse, technical and confident, like a well-written README. Short sentences, concrete numbers, real command names, no hype words (no 'revolutionary', 'blazing', 'supercharge', 'magic'). Monospace for anything a developer would type or read in a terminal.
## Stack
- Framework: Vite 5 + React 18 + TypeScript
- Styling: Tailwind CSS 3.4
- Libraries: react (MIT), react-dom (MIT), motion (motion.dev, import from 'motion/react') (MIT), lucide-react (ISC), tailwindcss (MIT), postcss (MIT), autoprefixer (MIT), vite (MIT), @vitejs/plugin-react (MIT), typescript (Apache-2.0), @fontsource-variable/space-grotesk (OFL-1.1), @fontsource-variable/inter (OFL-1.1), @fontsource-variable/jetbrains-mono (OFL-1.1)
- Build: `npm run build` → static files in `dist/`. No backend, no server code, no external APIs.
- Setup:
- Scaffold with npm create vite@latest using the react-ts template. One page: index.html at the project root with entry src/main.tsx. All sections live on this page and are reached by hash anchors (#demo, #features, #benchmarks, #integrations, #changelog, #install).
- vite.config.ts: base './', plugins [react()], build { outDir 'dist', sourcemap false, assetsInlineLimit 0 }. Do not copy src/ into dist/.
- Tailwind 3.4 through PostCSS (tailwindcss + postcss + autoprefixer), content ['./index.html', './src/**/*.{ts,tsx}']. In tailwind.config.ts add every color under Design to theme.extend.colors with kebab-case keys (ink, panel, panel-2, line, line-strong, text, muted, faint, signal, signal-ink, add, add-bg, del, del-bg, warn, info) and fontFamily display ['Space Grotesk Variable', 'system-ui', 'sans-serif'], sans ['Inter Variable', 'system-ui', 'sans-serif'], mono ['JetBrains Mono Variable', 'ui-monospace', 'monospace']. Add maxWidth { container: '1200px' } and borderRadius { DEFAULT: '6px', lg: '10px' }.
- In src/fonts.ts import '@fontsource-variable/space-grotesk', '@fontsource-variable/inter' and '@fontsource-variable/jetbrains-mono'; import src/fonts.ts and src/index.css from src/main.tsx.
- src/index.css: Tailwind layers; html { scroll-behavior: smooth; scroll-padding-top: 72px } (auto under prefers-reduced-motion); body bg ink, text text, font sans, antialiased; ::selection { background: #C6F43233 }; a .bg-grid utility (two linear-gradients of #FFFFFF08 1px lines every 48px, masked with radial-gradient(ellipse at 50% 0%, black 30%, transparent 75%)); a .noise utility that layers an inline SVG feTurbulence data URI (baseFrequency 0.9, opacity 0.035) as a fixed full-page overlay with pointer-events none; keyframes caret-blink (steps(1) 1s infinite) and pulse-line (signal left border fading from 100% to 0% over 1.2s).
- File layout: src/content.ts (every string, number, terminal script, diff line, comment, benchmark row, feature, chip, changelog entry and shortcut, typed), src/lib/brand.ts (exports BRAND, BRAND_SLUG and installCommands { npm: 'npm i -g ' + BRAND_SLUG, brew: 'brew install ' + BRAND_SLUG, npx: 'npx ' + BRAND_SLUG + ' review' }), src/lib/clipboard.ts (navigator.clipboard.writeText with a hidden-textarea + document.execCommand('copy') fallback, wrapped in try/catch), src/lib/useReducedMotion.ts (re-export of Motion's useReducedMotion), src/lib/toast.ts (tiny external store via useSyncExternalStore: showToast(text) displays one toast for 1.8s).
- Components in src/components/: Header.tsx, Wordmark.tsx (inline SVG glyph + name), InstallBox.tsx (tabs + command + copy button; the selected tab is shared through a small store so both install boxes stay in sync), Terminal.tsx (+ terminalScript.ts: the sessions as an array of steps), DiffViewer.tsx (DiffLine.tsx, ReviewComment.tsx, FindingsPanel.tsx), FeatureGrid.tsx, ConfigSnippet.tsx, BenchmarkRace.tsx, Integrations.tsx, Changelog.tsx, FinalCta.tsx, Footer.tsx, ShortcutOverlay.tsx, ShortcutHint.tsx, Toast.tsx, Kbd.tsx, SectionHeading.tsx, Reveal.tsx (Motion whileInView wrapper: opacity 0 to 1, y 16 to 0, 0.5s, once, amount 0.2). src/App.tsx composes them in the section order under Pages & Sections and registers the global keyboard handler (src/lib/useShortcuts.ts).
- Syntax coloring in the diff, terminal and config snippet is done by hand with a tiny tokenizer in src/lib/highlight.ts (keywords, strings, numbers, comments, function names) mapped to Tailwind classes. No highlighting library.
- public/favicon.svg as described under Assets. index.html: lang en, <meta name='theme-color' content='#0A0B0D'>, <link rel='icon' href='./favicon.svg' type='image/svg+xml'>, <title>[BRAND] — the [PRODUCT] that finishes before you push</title>.
- Write ASSETS.md at the project root listing the three Fontsource font packages (OFL-1.1, with upstream authors), lucide-react (ISC) and a line saying every other graphic (wordmark glyph, favicon, grid, noise, terminal and diff chrome, bars) is drawn in code in this project.
- dist/ holds index.html, hashed JS/CSS, the woff2 font files and favicon.svg. Target under 2 MB.
## Variables
- [BRAND] — Product name (default: "Ferrule"). Invented tool name, one or two words. Used in the wordmark, title, headlines, terminal banner, comment author line, feature copy, changelog and footer. Never a real developer tool.
- [BRAND_SLUG] — Command and package name (default: "ferrule"). Lowercase, no spaces. It is the CLI command typed in every terminal line, the npm/brew package name in the install box, the config file name (.[BRAND_SLUG].toml) and the bot name on diff comments. Derive nothing else from it.
- [PRODUCT] — What the tool is (default: "code review CLI"). Short noun phrase, lowercase. Drives the title, hero copy, feature cards, terminal session content, diff comments and benchmark metric. For a test runner the diff comments become failing-test annotations; for a linter they become rule violations.
- [LANGUAGES] — Languages or file types it covers (default: "TypeScript, Go and Python"). Two to four languages or formats. The terminal file paths, the diff code sample, the config snippet and the first integration chips use these languages.
- [AUDIENCE] — Who it is for (default: "teams that ship several times a day"). Short phrase, lowercase. Used in the hero subline, the features intro and the final call to action.
- [CREDIT] — keep a small "Template by VibeFather" link to https://vibefather.ai/t/dark-developer-tool-launch-page in the footer (default: yes; delete this line to remove it)
The copy under Pages & Sections is written for the default values. If your values differ, rewrite every headline, paragraph, label and image for them — same length, tone and structure. Layout, colors, type and motion stay as described.
Keep all copy, image paths and links in one content file (for example `src/content.ts`), keyed by section, so the content can be swapped later without touching components.
## Design
### Colors
- Ink `#0A0B0D` — Page background, terminal body
- Panel `#111317` — Cards, diff viewer body, install box, overlay panel
- Panel 2 `#171A1F` — Terminal and diff title bars, hunk header rows, hovered rows, kbd keys
- Line `#22262D` — All 1px hairline borders and dividers, inactive benchmark bars track
- Line Strong `#323842` — Hovered borders, inactive benchmark bars, kbd bottom border
- Text `#E7E9EC` — Headlines and body text
- Muted `#8C939D` — Secondary copy, line numbers, terminal prompt path, labels
- Faint `#5B626C` — Footnotes, disabled states, diff context gutter
- Signal `#C6F432` — The one accent: primary buttons, our benchmark bars, active tab underline, focus rings, caret, git branch in the prompt, 'Latest' tag, wordmark glyph
- Signal Ink `#0A0B0D` — Text on Signal buttons and tags
- Add `#3DDC97` — Added-line +/- gutter sign and text tint, success checkmarks, 'perf' and 'fix' changelog tags
- Add BG `rgba(61,220,151,0.09)` — Added-line row background
- Del `#FF6B6B` — Removed-line sign, 'high' severity dot and tag, 'breaking' tag
- Del BG `rgba(255,107,107,0.09)` — Removed-line row background
- Warn `#F5B841` — 'medium' severity dot and tag
- Info `#6CB4FF` — 'low' severity dot and tag, 'feat' changelog tag, code keywords
### Typography
- Display: hero headline (56px desktop / 38px mobile, weight 600, tracking -0.03em, line-height 1.02), section headings (36px / 28px, weight 600, tracking -0.02em), stat numbers: Space Grotesk (OFL), weights 500/600/700
- Text: body 16px/1.6 weight 400, card titles 16px weight 500, buttons 14px weight 500: Inter (OFL), weights 400/500/600
- Mono: terminal (13.5px/1.7), diff (13px/1.65), install commands (15px), eyebrows and labels (12px uppercase, tracking 0.08em), all numbers, kbd keys, chips, version tags: JetBrains Mono (OFL), weights 400/500/700
### Layout & motion
- Spacing: Container max-width 1200px with 24px side padding (16px under 640px). Sections are separated by 1px Line borders full-bleed, with 112px vertical padding on desktop and 72px on mobile. Grids use a 1px gap over a Line-colored background so cells share hairline borders. Inner card padding 24px. Base unit 4px; dense rhythm, no huge empty bands.
- Radius: 6px on buttons, chips, kbd keys, inputs and tags; 10px on the terminal window, diff viewer, install box, overlay panel and feature grid outer frame; 999px only on severity dots and the hint chip.
- Motion: Section reveal: every section heading and block fades up (opacity 0 to 1, y 16px to 0, 0.5s, ease [0.22, 1, 0.36, 1]) once when 20% visible; children stagger by 0.06s.
- Motion: Hero terminal: commands type character by character at 32ms per char with a blinking block caret (Signal, 1s steps); output lines appear one by one with 110ms between lines; the spinner cycles the braille frames ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏ every 80ms for 900ms before being replaced by its result line. After the last line of session 2 it waits 2.6s, fades the body out over 0.3s and restarts session 1. It starts only when the terminal is in view and pauses when off screen or when the tab is hidden.
- Motion: Diff viewer: when the viewer is 35% in view, the three comments open in order, 1.1s apart. For each, the anchored line gets a 1.2s pulse-line highlight, then the comment card expands from height 0 to auto with opacity 0 to 1 (0.45s); the matching item in the Findings panel ticks from a hollow dot to a filled severity dot.
- Motion: Benchmark race: when the chart is 40% in view, bars grow from width 0 to their value (1.1s, ease [0.22, 1, 0.36, 1], stagger 0.12s top to bottom) and the numbers count up in sync using Motion's animate() on a motion value, formatted to one decimal for seconds and integers for counts. Switching tabs replays the race from 0.
- Motion: Micro-interactions: copy buttons swap the Lucide Copy icon for Check with a 0.15s scale pop and show a toast 'Copied: <command>' bottom-center for 1.8s; buttons lift 1px and brighten on hover; chips and cards change border to Line Strong on hover; the active tab underline slides between tabs with a shared layoutId.
- Motion: Shortcut overlay: backdrop fades to rgba(10,11,13,0.72) with backdrop-blur 6px in 0.2s; the panel scales from 0.97 to 1 and fades in over 0.2s; Esc or a backdrop click reverses it.
- Motion: Changelog expand: older entries animate height 0 to auto and fade in over 0.35s.
- Motion: prefers-reduced-motion: no typing, spinner or loop (the terminal renders session 1 complete and static with a Replay button that swaps to session 2), diff comments are all open from the start, bars and numbers render at their final values, reveals are instant, smooth scrolling is off. Overlay and toast still appear but without scale or movement.
- Imagery: No photos and no illustrations. The visual interest comes from code-drawn UI: the terminal window, the diff viewer, the bar chart, hairline grids, a very faint 48px background grid under the hero masked with a radial fade, and a 3.5% SVG noise overlay across the page. The wordmark glyph is an inline SVG: a 20x20 rounded square (radius 5) in Signal with two Ink horizontal strokes of different length, like two diff lines, the lower one offset right by 4px. Icons are Lucide at 18–20px with stroke-width 1.75.
## Pages & Sections
### [BRAND] — launch page (`index.html`)
1. **Content file and copy rules** — All copy below is written for the default values ([BRAND] = Ferrule, [BRAND_SLUG] = ferrule, [PRODUCT] = code review CLI, [LANGUAGES] = TypeScript, Go and Python, [AUDIENCE] = teams that ship several times a day). Put every string, number, terminal step, diff line, comment, benchmark row and list in src/content.ts and render from it. If any variable value differs, rewrite every headline, terminal session, file path, code sample, review comment, rule name, feature, benchmark metric and row label, chip and changelog entry so it is specific and believable for the new product, keeping the same structure, counts and approximate lengths. Every command shown uses [BRAND_SLUG]; every repository, file path, function and commit in the samples is invented (the sample repository is called ledgerline). Product facts used throughout: current version 2.4.0; 212 rules, 143 of them with auto-fixes, 38 security rules; median review 1.8s on a 1,240-line pull request; re-review after a fix 0.4s; cold start 140 ms; runs fully offline; Apache-2.0 core.
Layout: No visual output. content.ts exports typed objects: nav, hero, install, terminalSessions, diff (file, hunks, lines, comments, findings), features, config, benchmarks (tabs, rows, stats, footnote), integrations, changelog, finalCta, footer, shortcuts.
2. **Header (sticky, shared)** — Left: Wordmark (glyph + '[BRAND]' in JetBrains Mono 15px weight 700) linking to #top, followed by a version pill 'v2.4.0' (mono 11px, Muted text, 1px Line border, radius 6px) that links to #changelog. Center/right nav links (Inter 14px, Muted, hover Text): Demo (#demo), Features (#features), Benchmarks (#benchmarks), Changelog (#changelog). Far right: a ghost icon button with Lucide Keyboard and the tooltip/aria-label 'Keyboard shortcuts (?)' that opens the overlay, and a primary button 'Install' (Signal background, Signal Ink text, Lucide Download 16px) that scrolls to #install.
Layout: Height 60px, full width, sticky top-0, z-40, background rgba(10,11,13,0.78) with backdrop-blur 10px and a 1px Line bottom border that appears only after scrolling 8px. Inner row uses the 1200px container, flex, items-center, justify-between. Under 768px the four nav links are hidden and only the wordmark, the keyboard button and Install remain; no hamburger menu.
Motion: Border fades in over 0.2s when scrolled. Nav link of the section currently in view (IntersectionObserver, rootMargin -40% 0 -55% 0) turns Text color with a 1px Signal underline.
3. **Hero (#top)** — Left column, top to bottom: (1) Announcement link chip: a mono 12px pill with a Signal dot, text 'v2.4.0 — suggested fixes for 41 more rules' and Lucide ArrowRight 14px, linking to #changelog. (2) Headline (display): 'Code review that finishes before you push.' (3) Subline (Inter 18px, Muted, max-width 520px): '[BRAND] is a local-first code review CLI for TypeScript, Go and Python. It reads only what changed, leaves line-level comments on real bugs and hands you a fix you can apply with one key. Built for teams that ship several times a day.' (4) InstallBox (see below). (5) Button row: a ghost button 'See it review a diff' with Lucide ArrowDown linking to #demo, then a text hint 'or press ? for shortcuts' in mono 12px Faint with the ? rendered as a Kbd. (6) Mono 12px facts row separated by middle dots, Muted: '1.8s median review · 212 rules · runs offline · Apache-2.0 core'. InstallBox: a 10px-radius Panel box with 1px Line border; top row of three tabs 'npm', 'brew', 'npx' (mono 12px, the active one Text with a 2px Signal underline, inactive Muted); body row with a Signal '$' prompt, the command in mono 15px ('npm i -g ferrule' / 'brew install ferrule' / 'npx ferrule review', built from [BRAND_SLUG]) and a right-aligned 32px icon button (Lucide Copy, aria-label 'Copy install command') that copies the visible command. Right column: the Terminal window. Title bar (36px, Panel 2, 1px Line bottom border): three 10px circles in Line Strong (no traffic-light colors), centered mono 12px Muted title '~/work/ledgerline — zsh', right side two 28px icon buttons Lucide Pause/Play (toggle) and RotateCcw (replay, aria-label 'Replay session'). Body (Ink, 20px padding, fixed height 420px desktop / 360px mobile, overflow hidden, newest lines stay visible by scrolling the body to the bottom). Session 1, line by line (prompt = Muted '~/work/ledgerline' + Signal '(feat/retry-queue)' + Text '$'): typed command 'ferrule review --base main'; output '◆ ferrule 2.4.0 · 14 files changed · +312 −87' (◆ in Signal); spinner line '⠋ Reading diff and call sites…'; replaced by '✓ Reviewed in 1.8s' (✓ in Add); then five findings, each with a colored ● and a fixed-width severity word, path in Text, line number in Muted, message in Muted: 'high src/billing/retry-queue.ts:40 async callback inside forEach is never awaited'; 'high src/api/webhooks.ts:118 signature compared with === (timing leak)'; 'medium src/billing/retry-queue.ts:46 retry limit hard-coded to 3'; 'medium internal/ledger/post.go:203 error from tx.Rollback() ignored'; 'low scripts/backfill.py:31 bare except swallows KeyboardInterrupt'; summary line '2 high · 2 medium · 1 low · 4 fixes available' (counts colored by severity); typed command 'ferrule fix 1 2 --apply'; output '✓ Applied 2 fixes · re-reviewed in 0.4s · 0 high remaining'. Session 2 (body clears first): typed 'ferrule review --staged'; '✓ Reviewed 3 files in 0.6s'; 'No high or medium findings. 1 low:'; '● low src/ui/InvoiceTable.tsx:88 list key uses array index in a sortable table'; typed 'git commit -m "fix: await retries in queue"'; '◆ ferrule pre-commit hook · passed in 0.3s'; '[feat/retry-queue 4e1c9a2] fix: await retries in queue'; '2 files changed, 9 insertions(+), 6 deletions(-)'. Then loop.
Layout: Full-width section with the .bg-grid background behind it, padding 96px top / 112px bottom (56px / 72px on mobile). Inside the container a 12-column grid at lg (≥1024px): left column spans 5 (vertically centered), terminal spans 7. Below 1024px the columns stack: copy first, terminal second, full width. Terminal has a 1px Line border, 10px radius and a soft shadow 0 30px 80px -30px rgba(198,244,50,0.12). Long terminal lines wrap with a 2-space hanging indent on mobile (font 12px). The InstallBox is max-width 460px, full width on mobile.
Motion: Headline, subline, install box and facts row fade up in a 0.06s stagger on load. Terminal typing as described under Design motion. Pause toggles the script; Replay restarts session 1. Shortcut 'r' also replays.
4. **Diff review demo (#demo)** — Section heading block: eyebrow (mono 12px uppercase Signal) 'Line-level review'; heading 'Comments land on the line, not in a wall of text.'; intro (Muted, max 600px): 'Every finding is anchored to the exact line, tagged by severity and rule, and most come with a patch. This is the same retry-queue change from the terminal above.' Diff viewer, file header bar: Lucide FileCode2 16px, path 'src/billing/retry-queue.ts' in mono 13px Text, then '+9' in Add and '−6' in Del, right side a mono 12px label 'Unified' and a ghost button 'Replay comments' (Lucide RotateCcw). Hunk header row (Panel 2, Info text): '@@ -38,8 +38,14 @@ export async function drainQueue(queue: RetryQueue)'. Lines (old no. | new no. | sign | code): ' 38 | 38 | | export async function drainQueue(queue: RetryQueue) {'; ' 39 | 39 | | const due = await queue.takeDue(new Date());'; ' 40 | | - | due.forEach((job) => {'; ' 41 | | - | chargeInvoice(job.invoiceId);'; ' | 40 | + | due.forEach(async (job) => {'; ' | 41 | + | await chargeInvoice(job.invoiceId);'; ' | 42 | + | metrics.increment("billing.retry.charged");'; ' 42 | 43 | | });'; ' 43 | 44 | |'; ' | 45 | + | for (const job of queue.failed()) {'; ' | 46 | + | if (job.attempts < 3) {'; ' | 47 | + | queue.schedule(job, backoff(job.attempts));'; ' | 48 | + | }'; ' | 49 | + | }'; ' 44 | | - | log.info(`drained ${due.length} jobs`);'; ' | 50 | + | log.info(`drained ${due.length} jobs, ${queue.failed().length} failed`);'; ' 45 | 51 | | }'. Comment 1, under new line 40 — author row: wordmark glyph 16px, 'ferrule' mono 12px Text, rule 'async-foreach-await' mono 12px Muted, severity tag 'high' (Del text on Del BG, 1px Del/40% border); body: 'forEach ignores the promise each async callback returns, so drainQueue resolves before any invoice is charged and a failed charge is never caught.'; 'Suggested fix' label, then a mini code block with Add-tinted lines: 'for (const job of due) {' / ' await chargeInvoice(job.invoiceId);' / ' metrics.increment("billing.retry.charged");' / '}'; actions: primary small button 'Apply fix' with Kbd 'a', ghost button 'Ignore' with Kbd 'i'. Comment 2, under new line 46 — rule 'magic-number', tag 'medium' (Warn): 'The retry limit 3 is also hard-coded in src/api/webhooks.ts:77. Read it from config.billing.maxRetries so both paths stay in sync.' Suggested fix: 'if (job.attempts < config.billing.maxRetries) {'. Comment 3, under new line 50 — rule 'structured-logging', tag 'low' (Info): 'queue.failed() walks the whole queue a second time. Reuse the count from the loop above, and pass fields as data so the log is searchable.' Suggested fix: 'log.info("drained", { due: due.length, failed: failedCount });'. Findings panel (right): title 'Findings · 3', list of the three with severity dot, rule name, 'line 40' etc.; below a mono 12px line '1.8s · 14 files · 212 rules checked'. Clicking a finding scrolls the diff to that line and pulses it.
Layout: Container with an 8/4 split at lg: diff viewer spans 8 columns, Findings panel spans 4 and is sticky (top 84px). Below 1024px the panel moves under the diff as a full-width card. Diff viewer: Panel background, 1px Line border, 10px radius, overflow hidden. Rows are CSS grid columns 44px | 44px | 20px | 1fr; line numbers right-aligned in Faint, sign in Add/Del, added rows Add BG, removed rows Del BG, context rows transparent; code text tinted by the hand tokenizer (keywords Info, strings Add, numbers Warn, function names Text, punctuation Muted). Comments are inserted as full-width rows after their anchor line: a Panel 2 card with 16px padding, inset from the left by 108px on desktop (8px on mobile), 1px Line border, 6px radius, and a 2px left border in the severity color. On mobile the code area scrolls horizontally inside the viewer (font 12px) while comment cards wrap to the viewer width; the page itself never scrolls sideways.
Motion: Comment sequence as in Design motion. 'Apply fix' (click or 'a' while the comment has focus or is the latest opened unresolved one) collapses the comment to a single resolved row 'Resolved · fix applied' with a Lucide CheckCircle2 in Add, swaps the anchored lines for the suggested code with a 0.3s crossfade, and turns its Findings item to a struck-through Faint label; 'Ignore' collapses it to 'Ignored · reason: false positive'. 'Replay comments' restores the original diff and replays the sequence.
5. **Feature grid (#features)** — Eyebrow 'Why teams switch'; heading 'Built for the loop you already run.'; intro: 'Review on save, on commit and in CI with the same rules and the same output. Made for teams that ship several times a day.' Six cells, each: Lucide icon 20px in Signal, title (Inter 16px weight 500), body (Muted 14.5px, 2–3 lines), footer stat (mono 12px Faint, top 1px Line divider). (1) Zap — 'Reviews only the diff' — 'Reads the changed hunks plus the call sites they touch, so a 2,000-line pull request takes seconds instead of minutes.' — '1.8s median'. (2) HardDrive — 'Runs on your machine' — 'No code leaves your laptop or CI runner. Works on a plane, in air-gapped networks and behind strict proxies.' — '0 bytes uploaded'. (3) Wand2 — 'Fixes you can apply' — 'Most findings ship a patch. Preview it inline, apply it with one key, and [BRAND] re-reviews the result.' — '143 of 212 rules auto-fix'. (4) ShieldAlert — 'Security rules on by default' — 'Timing-safe comparisons, secrets in diffs, unsafe deserialization and SQL built from strings.' — '38 security rules'. (5) Keyboard — 'Keyboard-first TUI' — 'j and k to move, a to apply, i to ignore with a reason. ferrule review -i opens the interactive view.' — 'press ? on this page'. (6) FileCog — 'One config file' — 'Rules, severities and ignores live in .ferrule.toml next to your code and get reviewed like everything else.' — '.ferrule.toml'. Under the grid, ConfigSnippet: left text block 'Configure once, run everywhere.' (display 22px) + Muted line 'The same file drives the pre-commit hook, the CI step and the editor diagnostics.'; right a code panel titled '.ferrule.toml' with lines: '[review]' / 'base = "main"' / 'fail_on = "high"' / 'languages = ["typescript", "go", "python"]' / '' / '[rules]' / '"async-foreach-await" = "high"' / '"magic-number" = { level = "medium", ignore = ["tests/**"] }' / '"structured-logging" = "low"', with a copy button.
Layout: Grid frame: 10px radius, 1px Line border, overflow hidden, display grid with gap 1px on a Line background so every cell shares hairline borders; cells are Panel with 24px padding. 3 columns at lg, 2 at md (≥768px), 1 below. ConfigSnippet sits 48px below: 5/7 split at lg, stacked below 1024px; code panel uses the same chrome as the diff viewer header.
Motion: Cells reveal with a 0.06s stagger. On hover a cell's background shifts to Panel 2 and its icon nudges up 2px (0.2s).
6. **Benchmarks (#benchmarks)** — Eyebrow 'Benchmarks'; heading 'Fast enough to run on every save.'; a mono 11px badge next to the heading: 'Illustrative figures'. Segmented tabs: 'Review time' and 'Bugs caught'. Tab 'Review time' — caption 'Seconds to review a 1,240-line pull request · lower is better'; rows top to bottom (label, value): '[BRAND]' 1.8s; '[BRAND] --deep' 4.6s; 'Linter chain (5 tools)' 7.9s; 'Hosted review bot' 38.0s; 'Script calling a large model' 52.4s. Tab 'Bugs caught' — caption 'Seeded bugs found, out of 50 · higher is better'; rows: '[BRAND] --deep' 46; '[BRAND]' 41; 'Script calling a large model' 33; 'Hosted review bot' 29; 'Linter chain (5 tools)' 17. Right column, three stat tiles stacked: '21×' + 'faster than a hosted review bot'; '0.4s' + 'to re-review after applying a fix'; '92%' + 'of seeded bugs caught in deep mode'. Footnote under the chart (mono 11.5px, Faint, max 720px): 'Illustrative numbers for this page. Measured on an invented 1,240-line TypeScript and Go pull request with 50 seeded bugs, 10-core laptop, median of 10 runs. Other rows are generic tool categories, not specific products.'
Layout: 8/4 split at lg (chart 8, tiles 4), stacked below 1024px with the tiles in a 3-column row on md and stacked on mobile. Each bar row: label column 220px (mono 13px; [BRAND] rows in Text with a Signal 6px square before them, others Muted) | track (height 28px, Panel background, 1px Line border, 6px radius) with the bar inside (Signal for [BRAND] rows, Line Strong for others) | value 64px right-aligned mono 14px (Text for [BRAND], Muted for others). Width = value / max value in the active tab. Under 640px the label sits above its track and the value moves inside the track's right end. Stat tiles: Panel, 1px Line border, 10px radius, 24px padding, number in display 40px Text with the unit in Signal, label Muted 14px.
Motion: Bar race and count-up as in Design motion; the active tab pill slides with layoutId. Stat tile numbers count up once when visible.
7. **Integrations (#integrations)** — Eyebrow 'Integrations'; heading 'Fits where reviews already happen.' Two labeled chip rows. 'Works with' (label mono 12px Faint): Pre-commit hook, Pre-push hook, CI pipelines, Merge request comments, Editor diagnostics (LSP), SARIF output, JSON output, Monorepos, Self-hosted runners, Offline mode. 'Languages': TypeScript, Go, Python first (from [LANGUAGES], each with a Signal 6px dot meaning 'full support'), then JavaScript, Rust, Java, Kotlin, Ruby, SQL (no dot, a trailing mono 10px 'beta'). Plain text chips only, no logos. Under the rows a one-line mono command with copy button: '$ ferrule hooks install' and Muted text 'adds the pre-commit hook in one step'.
Layout: Container, rows separated by 24px. Chips: inline-flex, mono 13px, 6px 12px padding, 1px Line border, 6px radius, Panel background, wrap with 8px gaps. Label column 140px on the left at md and above; on mobile the label sits above its chips.
Motion: Chips fade in with a 0.02s stagger per row; hover turns the border Line Strong and the text Text.
8. **Changelog teaser (#changelog)** — Eyebrow 'Changelog'; heading 'Shipping every week.'; Muted line 'Four recent releases. Breaking changes are rare and always come with a migration command.' Entries (version tag mono 13px weight 700, type tag, one-line change): v2.4.0 [Latest, Signal tag] [feat] 'Suggested fixes for 41 more rules; ferrule fix now re-reviews automatically.'; v2.3.2 [fix] 'Go generics no longer trip the shadowed-variable rule.'; v2.3.0 [perf] 'Cold start down from 420 ms to 140 ms with a shared parse cache.'; v2.2.0 [feat] 'Interactive TUI: ferrule review -i with j/k navigation and inline apply.' Hidden until expanded: v2.1.1 [fix] 'SARIF output now includes rule help text.'; v2.1.0 [feat] 'Python support leaves beta with 64 rules.'; v2.0.0 [breaking] 'Config moved to .ferrule.toml; ferrule migrate converts the old file.'; v1.9.0 [feat] 'Hook installer: ferrule hooks install.' Button under the list: 'Show 4 older releases' with Lucide ChevronDown, toggling to 'Show fewer' with ChevronUp. No dates.
Layout: Max-width 760px, left aligned in the container. Vertical timeline: a 1px Line rule at left 7px; each entry has a 9px dot on the rule (Signal for v2.4.0, Line Strong for others), then a row: version tag, type tag (feat Info, fix and perf Add, breaking Del; mono 11px, 1px border at 40% of the color, 6px radius), and the change text in Text 15px on the same line at md, wrapping under the tags on mobile. 20px between entries.
Motion: Entries reveal with a 0.05s stagger; expanding as in Design motion. Shortcut 'l' scrolls here.
9. **Final install CTA (#install)** — Heading (display 44px / 32px mobile, centered): 'Run your first review in 30 seconds.' Muted subline: 'Free for teams that ship several times a day, from side projects to monorepos. No account, no upload.' The same InstallBox as the hero (shared tab state), centered. Below, three numbered steps as mono rows with copy buttons: '1 npm i -g ferrule' (follows the selected install tab), '2 ferrule review --base main', '3 ferrule hooks install'. Then a ghost button 'Keyboard shortcuts' with Kbd '?' that opens the overlay.
Layout: Centered column, max-width 620px, inside a full-bleed band with a radial Signal glow (radial-gradient(600px circle at 50% 0%, rgba(198,244,50,0.08), transparent 70%)) and the faint grid. Step rows: Panel, 1px Line border, 6px radius, 12px 16px padding, step number in Signal, command in Text, copy icon button right; 8px between rows.
Motion: Fades up on reveal. Copy behavior and toast as in Design motion.
10. **Footer** — Left: Wordmark and Muted line '[BRAND] — a local-first code review CLI for TypeScript, Go and Python.' Middle: two link columns — 'Product': Demo, Features, Benchmarks, Changelog (hash anchors); 'Install': npm, brew, npx (each copies that command and shows the toast; render as buttons styled like links). Bottom row (1px Line top border, mono 12px Faint): '© [BRAND] contributors · Apache-2.0 core' on the left; on the right the [CREDIT] link if it is kept.
Layout: Container, 64px top / 40px bottom padding, 3-column grid at md (brand column wider: 2fr 1fr 1fr), stacked on mobile. Bottom row flex justify-between, wrapping on mobile.
Motion: None besides link hover color.
11. **Keyboard shortcuts overlay and hint chip (global)** — Hint chip: fixed bottom-right, mono 12px, 'Press ? for shortcuts' with a Kbd '?', Panel background, 1px Line border, radius 999px; clicking opens the overlay. Overlay: modal titled 'Keyboard shortcuts' (display 20px) with a close button (Lucide X) and a two-column list of rows (description left in Text 14px, keys right as Kbd): '?' Open this panel; 'Esc' Close; 'c' Copy install command; 'd' Jump to the diff demo; 'f' Jump to features; 'b' Jump to benchmarks; 'l' Jump to changelog; 'i' Jump to install; 't' Back to top; 'r' Replay the terminal; 'a' Apply the open suggested fix (when the diff demo is in view). Footer line in mono 12px Faint: 'Shortcuts are ignored while typing in a field.' Kbd component: mono 12px, min-width 22px, height 22px, centered, Panel 2 background, 1px Line Strong border with a 2px bottom border, 6px radius.
Layout: Overlay panel: width min(560px, 100vw - 32px), max-height 80vh with internal scroll, centered, Panel background, 1px Line border, 10px radius, 24px padding; rows separated by 1px Line dividers. Hint chip sits 20px from the bottom and right edges (16px on mobile) and hides while the overlay is open; on mobile it reads just 'Shortcuts' with the Kbd.
Motion: Open/close animation as in Design motion. The global handler ignores keys with Ctrl/Meta/Alt and keys typed into input, textarea or contenteditable; 'c' copies the command of the selected install tab and toasts; section keys smooth-scroll (instant with reduced motion). The overlay is a role dialog with aria-modal true, aria-labelledby on its title, focus moves to the close button on open, Tab is trapped inside, and focus returns to the opener on close.
## Assets
- image: No photos, illustrations or bitmap images. Everything visual is drawn in code inside this project: the wordmark glyph (inline SVG described under Design imagery), the terminal and diff viewer chrome, severity dots, bar chart, background grid (CSS gradients) and noise overlay (inline SVG feTurbulence data URI). Note in ASSETS.md that these are original to the project.
- image: public/favicon.svg: a 32x32 SVG with a rounded square (rx 7) filled #C6F432 and two #0A0B0D horizontal bars (x 7, y 11, width 14, height 3 and x 11, y 18, width 14, height 3, both rx 1.5) — the same mark as the wordmark glyph. Written by hand, no generator.
- icon: lucide-react (ISC), installed from npm and tree-shaken: Copy, Check, Download, Keyboard, ArrowRight, ArrowDown, Pause, Play, RotateCcw, FileCode2, CheckCircle2, Zap, HardDrive, Wand2, ShieldAlert, FileCog, ChevronDown, ChevronUp, X. Size 16–20px, strokeWidth 1.75. No octicon-style or code-hosting glyphs, no brand icons.
- font: Self-hosted through Fontsource npm packages, imported in src/fonts.ts so Vite bundles the woff2 files into dist/: @fontsource-variable/space-grotesk (Space Grotesk, OFL-1.1, Florian Karsten), @fontsource-variable/inter (Inter, OFL-1.1, Rasmus Andersson), @fontsource-variable/jetbrains-mono (JetBrains Mono, OFL-1.1, JetBrains). List all three in ASSETS.md with package name, upstream source and license.
## Don'ts
- No backend of any kind: no server code, API routes, databases, auth, analytics, forms that submit anywhere or third-party APIs. Copy-to-clipboard and the shortcut overlay are the only interactions that touch the browser outside the page.
- Do not load fonts from fonts.googleapis.com, fonts.gstatic.com, Adobe Fonts or any CDN. Self-host through the three Fontsource packages only.
- No CDN <script>, <link> or import maps. Every script, style, font and icon is in the project and bundled into dist/.
- No source maps in the production build (build.sourcemap false), and src/ is not copied into dist/.
- Relative asset paths (Vite base './'). Internal links are hash anchors on index.html (#demo, #features, #benchmarks, #integrations, #changelog, #install, #top) or ./index.html, never a bare directory or a leading slash. No link points to a page that does not exist.
- Do not change the stack (Vite 5 + React 18 + TypeScript + Tailwind CSS 3.4 + Motion + lucide-react + Fontsource) unless the user asks. No router, no UI kit, no syntax-highlighting library, no chart library, no 3D.
- No names, logos or wordmarks of real code-review, linting, testing or AI coding tools. The product is the invented [BRAND]; its only mark is the code-drawn glyph and typeset name.
- No real benchmark numbers and no real competitor names in the bar race. Rows are generic categories ('Hosted review bot', 'Linter chain (5 tools)', 'Script calling a large model'), every figure is invented, and the chart keeps its 'Illustrative figures' badge and methodology footnote.
- No real company or open-source project logos in integrations or anywhere else; integrations are plain text chips with generic names, and languages are plain words.
- Do not copy the diff view styling, colors, layout chrome or octicon-style glyphs of real code-hosting sites. Draw the diff viewer from scratch as specified and use Lucide icons only.
- No real repository names, usernames, people or real code in terminal, diff, config or changelog samples. Use the invented ledgerline repository and the code given here.
- No commercial or custom fonts: only Space Grotesk, Inter and JetBrains Mono (OFL), self-hosted.
- Only dependencies under MIT, ISC, BSD, Apache-2.0, 0BSD, CC0 or Unlicense (OFL for fonts). No Aceternity UI, Tailwind Plus / Tailwind UI or purchased template code; write every effect yourself.
- No photos, stock images, placeholder-image services, Unsplash, Pexels or Pixabay. All visuals are drawn in code.
- One accent only: Signal lime. Add, Del, Warn and Info are semantic colors for diffs, severities and changelog tags only, never for buttons or headings. No purple gradients, no glassmorphism cards, no neon glows beyond the two subtle ones specified (terminal shadow and final CTA radial).
- No mention of VibeFather, its pricing, members or numbers anywhere in the site except the optional [CREDIT] footer link.
- Respect prefers-reduced-motion exactly as described under Design motion: typing, spinner, comment sequence and bar race jump to their end states. The terminal loop pauses when off screen or when the tab is hidden.
- Accessibility: every interactive element is keyboard reachable with a visible 2px Signal focus ring (outline-offset 2px); the overlay traps focus and closes on Esc; tabs use role tablist/tab with aria-selected; the terminal body has aria-live off and an sr-only summary of session 1; copy buttons have aria-labels; the toast uses role status.
- Must render at 1440×900 and 390×844 with zero console errors and no horizontal page scroll (only the diff code area and terminal lines may scroll inside their own boxes). Clipboard calls are wrapped in try/catch with the textarea fallback.
- Keep dist/ under 20 MB (target under 2 MB).
- No lorem ipsum, filler or hype words. No meta descriptions, Open Graph tags, JSON-LD or sitemap: only the <title> and favicon.
---
— Prompt by VibeFather · https://vibefather.ai/t/dark-developer-tool-launch-page · CC BY-NC 4.0 (non-commercial; commercial use needs a VibeFather Pro license) · Request removal: https://vibefather.ai/takedown
中文参考译文(帮助理解,复制给 AI 时请用上面的英文原版)
# 深色开发者工具发布页
完全按照以下描述构建此网站。将 [VARIABLES] 替换为你自己的值;其余内容保持不变。
## 简介
为 [BRAND] 打造的单页发布站点,[BRAND] 是一款面向 [LANGUAGES] 的本地优先(local-first)[PRODUCT]。页面通过展示产品实际运行来证明速度与精准:一个 hero 终端,会逐字打出看起来真实的评审会话;一个 diff 查看器,行内评论会流式出现;一场基准测试条形竞赛;一个用 '?' 打开的键盘快捷键浮层;一段更新日志预告,以及可复制到剪贴板的安装命令。所有内容均由代码绘制;没有任何照片。
- 受众:[AUDIENCE]:生活在终端里的工程师和技术负责人,他们不信任营销页面,并在一分钟内决定一个工具是否值得执行一条安装命令。
- 目标:让访客复制安装命令并运行第一次评审。次要目标:准确展示一次评审是什么样子(终端 + diff),用一份示意性基准测试支撑速度声明,并通过更新日志表明项目活跃。
- 语气:简洁、技术化且自信,像一份写得好的 README。短句、具体数字、真实命令名,不用炒作词汇(不用 'revolutionary'、'blazing'、'supercharge'、'magic')。开发者会输入或在终端中读取的任何内容都使用等宽字体。
## 技术栈
- 框架:Vite 5 + React 18 + TypeScript
- 样式:Tailwind CSS 3.4
- 库:react(MIT)、react-dom(MIT)、motion(motion.dev,从 'motion/react' 导入)(MIT)、lucide-react(ISC)、tailwindcss(MIT)、postcss(MIT)、autoprefixer(MIT)、vite(MIT)、@vitejs/plugin-react(MIT)、typescript(Apache-2.0)、@fontsource-variable/space-grotesk(OFL-1.1)、@fontsource-variable/inter(OFL-1.1)、@fontsource-variable/jetbrains-mono(OFL-1.1)
- 构建:`npm run build` → 静态文件输出到 `dist/`。无后端、无服务端代码、无外部 API。
- 设置:
- 使用 react-ts 模板通过 npm create vite@latest 搭建脚手架。单页面:项目根目录的 index.html,入口为 src/main.tsx。所有区块都位于此页面,通过哈希锚点访问(#demo、#features、#benchmarks、#integrations、#changelog、#install)。
- vite.config.ts:base './',plugins [react()],build { outDir 'dist', sourcemap false, assetsInlineLimit 0 }。不要将 src/ 复制到 dist/。
- 通过 PostCSS 使用 Tailwind 3.4(tailwindcss + postcss + autoprefixer),content ['./index.html', './src/**/*.{ts,tsx}']。在 tailwind.config.ts 中,将 Design 下的每种颜色以 kebab-case 键添加到 theme.extend.colors(ink、panel、panel-2、line、line-strong、text、muted、faint、signal、signal-ink、add、add-bg、del、del-bg、warn、info),并设置 fontFamily display ['Space Grotesk Variable', 'system-ui', 'sans-serif']、sans ['Inter Variable', 'system-ui', 'sans-serif']、mono ['JetBrains Mono Variable', 'ui-monospace', 'monospace']。添加 maxWidth { container: '1200px' } 和 borderRadius { DEFAULT: '6px', lg: '10px' }。
- 在 src/fonts.ts 中导入 '@fontsource-variable/space-grotesk'、'@fontsource-variable/inter' 和 '@fontsource-variable/jetbrains-mono';从 src/main.tsx 导入 src/fonts.ts 和 src/index.css。
- src/index.css:Tailwind 层;html { scroll-behavior: smooth; scroll-padding-top: 72px }(在 prefers-reduced-motion 下为 auto);body 背景为 ink,文本为 text,字体为 sans,抗锯齿;::selection { background: #C6F43233 };一个 .bg-grid 工具类(两个 linear-gradient,使用 #FFFFFF08 的 1px 线条,每 48px 一条,用 radial-gradient(ellipse at 50% 0%, black 30%, transparent 75%) 遮罩);一个 .noise 工具类,将内联 SVG feTurbulence data URI(baseFrequency 0.9,opacity 0.035)作为固定全页覆盖层,pointer-events 为 none;关键帧 caret-blink(steps(1) 1s infinite)和 pulse-line(signal 左边框在 1.2s 内从 100% 淡出到 0%)。
- 文件布局:src/content.ts(每个字符串、数字、终端脚本、diff 行、注释、基准行、功能、chip、变更日志条目和快捷键,均带类型),src/lib/brand.ts(导出 BRAND、BRAND_SLUG 和 installCommands { npm: 'npm i -g ' + BRAND_SLUG, brew: 'brew install ' + BRAND_SLUG, npx: 'npx ' + BRAND_SLUG + ' review' }),src/lib/clipboard.ts(navigator.clipboard.writeText,带隐藏 textarea + document.execCommand('copy') 回退,包裹在 try/catch 中),src/lib/useReducedMotion.ts(重新导出 Motion 的 useReducedMotion),src/lib/toast.ts(通过 useSyncExternalStore 的微型外部存储:showToast(text) 显示一个 toast 1.8s)。
- src/components/ 中的组件:Header.tsx、Wordmark.tsx(内联 SVG 字形 + 名称)、InstallBox.tsx(标签页 + 命令 + 复制按钮;选中的标签页通过一个小型存储共享,以便两个安装框保持同步)、Terminal.tsx(+ terminalScript.ts:会话作为步骤数组)、DiffViewer.tsx(DiffLine.tsx、ReviewComment.tsx、FindingsPanel.tsx)、FeatureGrid.tsx、ConfigSnippet.tsx、BenchmarkRace.tsx、Integrations.tsx、Changelog.tsx、FinalCta.tsx、Footer.tsx、ShortcutOverlay.tsx、ShortcutHint.tsx、Toast.tsx、Kbd.tsx、SectionHeading.tsx、Reveal.tsx(Motion whileInView 包装器:opacity 0 到 1,y 16 到 0,0.5s,once,amount 0.2)。src/App.tsx 按 Pages & Sections 下的区块顺序组合它们,并注册全局键盘处理器(src/lib/useShortcuts.ts)。
- diff、终端和配置片段中的语法着色通过 src/lib/highlight.ts 中的微型分词器手工完成(关键字、字符串、数字、注释、函数名)映射到 Tailwind 类。不使用高亮库。
- public/favicon.svg 如 Assets 下所述。index.html:lang en,<meta name='theme-color' content='#0A0B0D'>,<link rel='icon' href='./favicon.svg' type='image/svg+xml'>,<title>[BRAND] — the [PRODUCT] that finishes before you push</title>。
- 在项目根目录编写 ASSETS.md,列出三个 Fontsource 字体包(OFL-1.1,含上游作者)、lucide-react(ISC),并写一行说明所有其他图形(字标字形、favicon、网格、噪点、终端和 diff 界面元素、条形图)均在本项目的代码中绘制。
- dist/ 包含 index.html、带哈希的 JS/CSS、woff2 字体文件和 favicon.svg。目标小于 2 MB。
## 变量
- [BRAND] — 产品名称(默认:"Ferrule")。虚构的工具名称,一到两个单词。用于字标、标题、主标题、终端横幅、评论作者行、功能文案、更新日志和页脚。绝不能是真实的开发者工具。
- [BRAND_SLUG] — 命令和包名(默认:"ferrule")。小写,无空格。它是每一行终端中输入的命令、安装框中 npm/brew 包名、配置文件名(.[BRAND_SLUG].toml)以及 diff 评论中的机器人名称。不要从中派生任何其他内容。
- [PRODUCT] — 工具是什么(默认:"code review CLI")。简短名词短语,小写。驱动标题、主视觉文案、功能卡片、终端会话内容、diff 评论和基准指标。对于测试运行器,diff 评论变为失败测试注解;对于 linter,它们变为规则违规。
- [LANGUAGES] — 它覆盖的语言或文件类型(默认:"TypeScript, Go and Python")。两到四种语言或格式。终端文件路径、diff 代码示例、配置片段和第一个集成标签使用这些语言。
- [AUDIENCE] — 面向谁(默认:"teams that ship several times a day")。简短短语,小写。用于主视觉副标题、功能简介和最终行动号召。
- [CREDIT] — 在页脚保留一个指向 https://vibefather.ai/t/dark-developer-tool-launch-page 的小型 "Template by VibeFather" 链接(默认:是;删除此行以移除)
页面与区块下的文案是为默认值编写的。如果你的值不同,请为它们重写每个标题、段落、标签和图片——保持相同的长度、语气和结构。布局、颜色、字体和动效保持所述不变。
将所有文案、图片路径和链接放在一个内容文件中(例如 `src/content.ts`),按区块键控,以便之后无需改动组件即可替换内容。
## 设计
### 颜色
- Ink `#0A0B0D` — 页面背景、终端主体
- Panel `#111317` — 卡片、diff 查看器主体、安装框、浮层面板
- Panel 2 `#171A1F` — 终端和 diff 标题栏、hunk 头部行、悬停行、kbd 按键
- Line `#22262D` — 所有 1px 细线边框和分隔线、未激活基准条轨道
- Line Strong `#323842` — 悬停边框、未激活基准条、kbd 底部边框
- Text `#E7E9EC` — 标题和正文文本
- Muted `#8C939D` — 次要文案、行号、终端提示符路径、标签
- Faint `#5B626C` — 脚注、禁用状态、diff 上下文装订线
- Signal `#C6F432` — 唯一强调色:主按钮、我们的基准条、活动标签下划线、焦点环、光标、提示符中的 git 分支、'Latest' 标签、字标字形
- Signal Ink `#0A0B0D` — Signal 按钮和标签上的文字
- Add `#3DDC97` — 新增行的 +/- 装订线符号和文字着色、成功对勾、'perf' 和 'fix' 变更日志标签
- Add BG `rgba(61,220,151,0.09)` — 新增行行背景
- Del `#FF6B6B` — 删除行符号、'high' 严重度圆点和标签、'breaking' 标签
- Del BG `rgba(255,107,107,0.09)` — 删除行行背景
- Warn `#F5B841` — 'medium' 严重度圆点和标签
- Info `#6CB4FF` — 'low' 严重度圆点和标签、'feat' 变更日志标签、代码关键字
### 排版
- Display:hero 标题(桌面 56px / 移动 38px,字重 600,字距 -0.03em,行高 1.02),区块标题(36px / 28px,字重 600,字距 -0.02em),统计数字:Space Grotesk(OFL),字重 500/600/700
- Text:正文 16px/1.6 字重 400,卡片标题 16px 字重 500,按钮 14px 字重 500:Inter(OFL),字重 400/500/600
- Mono:终端(13.5px/1.7),diff(13px/1.65),安装命令(15px),眉题和标签(12px 大写,字距 0.08em),所有数字、kbd 按键、chip、版本标签:JetBrains Mono(OFL),字重 400/500/700
### 布局与动效
- 间距:容器最大宽度 1200px,侧边内边距 24px(640px 以下为 16px)。区块之间由全出血的 1px Line 边框分隔,桌面垂直内边距 112px,移动端 72px。网格在 Line 色背景上使用 1px 间隙,使单元格共享细线边框。卡片内部内边距 24px。基础单位 4px;节奏紧凑,没有大片空白带。
- 圆角:按钮、chip、kbd 按键、输入框和标签为 6px;终端窗口、diff 查看器、安装框、浮层面板和功能网格外框为 10px;仅严重度圆点和提示 chip 为 999px。
- 动效:区块显现:每个区块标题和块在 20% 可见时淡入上移一次(不透明度 0 到 1,y 16px 到 0,0.5s,ease [0.22, 1, 0.36, 1]);子元素以 0.06s 错开。
- 动效:Hero 终端:命令以每字符 32ms 逐字符输入,带闪烁块状光标(Signal,1s steps);输出行逐行出现,行间 110ms;spinner 以每 80ms 循环盲文帧 ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏,持续 900ms 后被其结果行替换。会话 2 的最后一行之后等待 2.6s,主体在 0.3s 内淡出并重新开始会话 1。仅在终端进入视图时启动,在离开屏幕或标签页隐藏时暂停。
- 动效:Diff 查看器:当查看器 35% 进入视图时,三条评论按顺序打开,间隔 1.1s。对每条评论,锚定行获得 1.2s 的 pulse-line 高亮,然后评论卡片从高度 0 展开到 auto,不透明度 0 到 1(0.45s);Findings 面板中匹配项从空心圆点变为填充的严重度圆点。
- 动效:基准竞速:当图表 40% 进入视图时,条形从宽度 0 增长到其值(1.1s,ease [0.22, 1, 0.36, 1],从上到下错开 0.12s),数字通过 Motion 的 animate() 在 motion value 上同步计数,秒数格式化为一位小数,计数为整数。切换标签会从 0 重放竞速。
- 动效:微交互:复制按钮将 Lucide Copy 图标换成 Check,带 0.15s 缩放弹出,并在底部居中显示 toast 'Copied: <command>' 持续 1.8s;按钮悬停时上移 1px 并变亮;chip 和卡片悬停时边框变为 Line Strong;活动标签下划线通过共享 layoutId 在标签之间滑动。
- 动效:快捷键浮层:背景在 0.2s 内淡入到 rgba(10,11,13,0.72),带 backdrop-blur 6px;面板在 0.2s 内从 0.97 缩放到 1 并淡入;Esc 或点击背景反向执行。
- 动效:变更日志展开:较旧条目在 0.35s 内从高度 0 动画到 auto 并淡入。
- 动效:prefers-reduced-motion:无打字、spinner 或循环(终端渲染会话 1 完整且静态,带一个 Replay 按钮切换到会话 2),diff 评论从一开始就全部打开,条形和数字以最终值渲染,显现即时完成,平滑滚动关闭。浮层和 toast 仍会出现,但无缩放或移动。
- 图像:无照片、无插图。视觉趣味来自代码绘制的 UI:终端窗口、diff 查看器、条形图、细线网格、hero 下方非常淡的 48px 背景网格(用径向渐变遮罩),以及全页 3.5% 的 SVG 噪点叠加。字标字形是内联 SVG:一个 20x20 圆角方块(半径 5),Signal 色,带两条不同长度的 Ink 水平笔画,像两条 diff 行,下面一条向右偏移 4px。图标为 Lucide,18–20px,stroke-width 1.75。
## 页面与区块
### [BRAND] — 启动页(`index.html`)
1. **内容文件与文案规则** — 以下所有文案均按默认值编写([BRAND] = Ferrule,[BRAND_SLUG] = ferrule,[PRODUCT] = 代码审查 CLI,[LANGUAGES] = TypeScript、Go 和 Python,[AUDIENCE] = 每天多次发布的团队)。将每个字符串、数字、终端步骤、diff 行、注释、基准测试行和列表都放入 src/content.ts 并从中渲染。如果任何变量值不同,请重写每个标题、终端会话、文件路径、代码示例、审查评论、规则名称、功能、基准指标和行标签、chip 和 changelog 条目,使其对新产品的描述具体且可信,同时保持相同的结构、数量和大致长度。显示的每个命令都使用 [BRAND_SLUG];示例中的每个仓库、文件路径、函数和提交都是虚构的(示例仓库名为 ledgerline)。贯穿全文使用的产品事实:当前版本 2.4.0;212 条规则,其中 143 条带自动修复,38 条安全规则;在 1,240 行的 pull request 上审查中位数为 1.8s;修复后重新审查 0.4s;冷启动 140 ms;完全离线运行;Apache-2.0 核心。
布局:无视觉输出。content.ts 导出类型化对象:nav、hero、install、terminalSessions、diff(file、hunks、lines、comments、findings)、features、config、benchmarks(tabs、rows、stats、footnote)、integrations、changelog、finalCta、footer、shortcuts。
2. **页头(粘性,共享)** — 左侧:Wordmark(字形 + '[BRAND]',JetBrains Mono 15px 字重 700)链接到 #top,后跟一个版本 pill 'v2.4.0'(mono 11px,Muted 文本,1px Line 边框,圆角 6px)链接到 #changelog。中/右导航链接(Inter 14px,Muted,悬停 Text):Demo(#demo)、Features(#features)、Benchmarks(#benchmarks)、Changelog(#changelog)。最右侧:一个 ghost 图标按钮,带 Lucide Keyboard 和 tooltip/aria-label 'Keyboard shortcuts (?)',点击打开 overlay,以及一个主按钮 'Install'(Signal 背景,Signal Ink 文本,Lucide Download 16px),滚动到 #install。
布局:高度 60px,全宽,sticky top-0,z-40,背景 rgba(10,11,13,0.78),backdrop-blur 10px,以及仅在滚动 8px 后出现的 1px Line 底部边框。内部行使用 1200px 容器,flex,items-center,justify-between。768px 以下隐藏四个导航链接,仅保留 wordmark、键盘按钮和 Install;没有汉堡菜单。
动效:滚动时边框在 0.2s 内淡入。当前视口中所属区块的导航链接(IntersectionObserver,rootMargin -40% 0 -55% 0)变为 Text 颜色,并带 1px Signal 下划线。
3. **Hero(#top)** — 左列,从上到下:(1)公告链接 chip:一个 mono 12px pill,带 Signal 圆点,文本 'v2.4.0 — suggested fixes for 41 more rules' 和 Lucide ArrowRight 14px,链接到 #changelog。(2)标题(display):'Code review that finishes before you push.'(3)副标题(Inter 18px,Muted,max-width 520px):'[BRAND] is a local-first code review CLI for TypeScript, Go and Python. It reads only what changed, leaves line-level comments on real bugs and hands you a fix you can apply with one key. Built for teams that ship several times a day.'(4)InstallBox(见下文)。(5)按钮行:一个 ghost 按钮 'See it review a diff',带 Lucide ArrowDown,链接到 #demo,然后是一个文本提示 'or press ? for shortcuts',mono 12px Faint,其中 ? 渲染为 Kbd。(6)Mono 12px 事实行,以中点分隔,Muted:'1.8s median review · 212 rules · runs offline · Apache-2.0 core'。InstallBox:一个 10px 圆角的 Panel 盒子,带 1px Line 边框;顶部一行三个标签 'npm'、'brew'、'npx'(mono 12px,激活项为 Text 并带 2px Signal 下划线,非激活项为 Muted);主体行带一个 Signal '$' 提示符,命令为 mono 15px('npm i -g ferrule' / 'brew install ferrule' / 'npx ferrule review',由 [BRAND_SLUG] 构建),以及一个右对齐的 32px 图标按钮(Lucide Copy,aria-label 'Copy install command'),复制可见命令。右列:终端窗口。标题栏(36px,Panel 2,1px Line 底部边框):三个 10px 圆点,颜色为 Line Strong(无交通灯颜色),居中 mono 12px Muted 标题 '~/work/ledgerline — zsh',右侧两个 28px 图标按钮 Lucide Pause/Play(切换)和 RotateCcw(重播,aria-label 'Replay session')。主体(Ink,20px 内边距,固定高度桌面 420px / 移动端 360px,overflow hidden,通过将主体滚动到底部保持最新行可见)。会话 1,逐行(提示符 = Muted '~/work/ledgerline' + Signal '(feat/retry-queue)' + Text '$'):输入的命令 'ferrule review --base main';输出 '◆ ferrule 2.4.0 · 14 files changed · +312 −87'(◆ 为 Signal);spinner 行 '⠋ Reading diff and call sites…';替换为 '✓ Reviewed in 1.8s'(✓ 为 Add);然后五条发现,每条带一个彩色 ● 和固定宽度的严重性词,路径为 Text,行号为 Muted,消息为 Muted:'high src/billing/retry-queue.ts:40 async callback inside forEach is never awaited';'high src/api/webhooks.ts:118 signature compared with === (timing leak)';'medium src/billing/retry-queue.ts:46 retry limit hard-coded to 3';'medium internal/ledger/post.go:203 error from tx.Rollback() ignored';'low scripts/backfill.py:31 bare except swallows KeyboardInterrupt';摘要行 '2 high · 2 medium · 1 low · 4 fixes available'(计数按严重性着色);输入的命令 'ferrule fix 1 2 --apply';输出 '✓ Applied 2 fixes · re-reviewed in 0.4s · 0 high remaining'。会话 2(先清空主体):输入 'ferrule review --staged';'✓ Reviewed 3 files in 0.6s';'No high or medium findings. 1 low:';'● low src/ui/InvoiceTable.tsx:88 list key uses array index in a sortable table';输入 'git commit -m "fix: await retries in queue"';'◆ ferrule pre-commit hook · passed in 0.3s';'[feat/retry-queue 4e1c9a2] fix: await retries in queue';'2 files changed, 9 insertions(+), 6 deletions(-)'。然后循环。
布局:全宽区块,背后有 .bg-grid 背景,内边距顶部 96px / 底部 112px(移动端 56px / 72px)。容器内 lg(≥1024px)为 12 列网格:左列跨 5 列(垂直居中),终端跨 7 列。1024px 以下列堆叠:文案在前,终端在后,全宽。终端有 1px Line 边框、10px 圆角和柔和阴影 0 30px 80px -30px rgba(198,244,50,0.12)。长终端行在移动端以 2 空格悬挂缩进换行(字体 12px)。InstallBox 为 max-width 460px,移动端全宽。
动效:标题、副标题、安装盒和事实行在加载时以 0.06s 交错淡入上移。终端打字如 Design motion 中所述。Pause 切换脚本;Replay 重新开始会话 1。快捷键 'r' 也可重播。
4. **Diff 审查演示(#demo)** — 区块标题块:眉题(等宽 12px 大写 Signal)'Line-level review';标题 'Comments land on the line, not in a wall of text.';引言(Muted,最大 600px):'Every finding is anchored to the exact line, tagged by severity and rule, and most come with a patch. This is the same retry-queue change from the terminal above.' Diff 查看器,文件头栏:Lucide FileCode2 16px,路径 'src/billing/retry-queue.ts' 以等宽 13px Text 显示,然后是 '+9' 以 Add 色显示、'−6' 以 Del 色显示,右侧一个等宽 12px 标签 'Unified' 和一个幽灵按钮 'Replay comments'(Lucide RotateCcw)。Hunk 头行(Panel 2,Info 文本):'@@ -38,8 +38,14 @@ export async function drainQueue(queue: RetryQueue)'。行(旧行号 | 新行号 | 符号 | 代码):' 38 | 38 | | export async function drainQueue(queue: RetryQueue) {';' 39 | 39 | | const due = await queue.takeDue(new Date());';' 40 | | - | due.forEach((job) => {';' 41 | | - | chargeInvoice(job.invoiceId);';' | 40 | + | due.forEach(async (job) => {';' | 41 | + | await chargeInvoice(job.invoiceId);';' | 42 | + | metrics.increment("billing.retry.charged");';' 42 | 43 | | });';' 43 | 44 | |';' | 45 | + | for (const job of queue.failed()) {';' | 46 | + | if (job.attempts < 3) {';' | 47 | + | queue.schedule(job, backoff(job.attempts));';' | 48 | + | }';' | 49 | + | }';' 44 | | - | log.info(`drained ${due.length} jobs`);';' | 50 | + | log.info(`drained ${due.length} jobs, ${queue.failed().length} failed`);';' 45 | 51 | | }'。评论 1,位于新第 40 行下方 — 作者行:wordmark 字形 16px,'ferrule' 等宽 12px Text,规则 'async-foreach-await' 等宽 12px Muted,严重度标签 'high'(Del 文本配 Del 背景,1px Del/40% 边框);正文:'forEach ignores the promise each async callback returns, so drainQueue resolves before any invoice is charged and a failed charge is never caught.';'Suggested fix' 标签,然后是一个带 Add 色调行的迷你代码块:'for (const job of due) {' / ' await chargeInvoice(job.invoiceId);' / ' metrics.increment("billing.retry.charged");' / '}';操作:主小按钮 'Apply fix' 配 Kbd 'a',幽灵按钮 'Ignore' 配 Kbd 'i'。评论 2,位于新第 46 行下方 — 规则 'magic-number',标签 'medium'(Warn):'The retry limit 3 is also hard-coded in src/api/webhooks.ts:77. Read it from config.billing.maxRetries so both paths stay in sync.' 建议修复:'if (job.attempts < config.billing.maxRetries) {'。评论 3,位于新第 50 行下方 — 规则 'structured-logging',标签 'low'(Info):'queue.failed() walks the whole queue a second time. Reuse the count from the loop above, and pass fields as data so the log is searchable.' 建议修复:'log.info("drained", { due: due.length, failed: failedCount });'。发现面板(右侧):标题 'Findings · 3',三个发现的列表,带严重度圆点、规则名、'line 40' 等;下方一行等宽 12px 文本 '1.8s · 14 files · 212 rules checked'。点击一个发现会将 diff 滚动到该行并使其脉冲。
布局:Container 在 lg 下为 8/4 分栏:diff 查看器跨 8 列,发现面板跨 4 列且为粘性(top 84px)。低于 1024px 时面板作为全宽卡片移到 diff 下方。Diff 查看器:Panel 背景,1px Line 边框,10px 圆角,overflow hidden。行是 CSS grid 列 44px | 44px | 20px | 1fr;行号右对齐以 Faint 显示,符号以 Add/Del 显示,新增行 Add 背景,删除行 Del 背景,上下文行透明;代码文本由手工分词器着色(关键字 Info,字符串 Add,数字 Warn,函数名 Text,标点 Muted)。评论作为全宽行插入其锚定行之后:一个 Panel 2 卡片,16px 内边距,桌面端从左侧内缩 108px(移动端 8px),1px Line 边框,6px 圆角,以及 2px 左边框以严重度颜色显示。移动端代码区域在查看器内水平滚动(字体 12px),而评论卡片换行到查看器宽度;页面本身从不横向滚动。
动效:评论序列如 Design motion 中所述。'Apply fix'(点击或在评论获得焦点或为最新打开未解决项时按 'a')将评论折叠为单行已解决行 'Resolved · fix applied',配一个 Add 色的 Lucide CheckCircle2,以 0.3s 交叉淡入淡出将锚定行替换为建议代码,并将其发现项变为带删除线的 Faint 标签;'Ignore' 将其折叠为 'Ignored · reason: false positive'。'Replay comments' 恢复原始 diff 并重放序列。
5. **功能网格(#features)** — 眉题 'Why teams switch';标题 'Built for the loop you already run.';引言:'Review on save, on commit and in CI with the same rules and the same output. Made for teams that ship several times a day.' 六个单元格,每个:Lucide 图标 20px 以 Signal 显示,标题(Inter 16px 字重 500),正文(Muted 14.5px,2–3 行),页脚统计(等宽 12px Faint,顶部 1px Line 分隔线)。(1) Zap — 'Reviews only the diff' — 'Reads the changed hunks plus the call sites they touch, so a 2,000-line pull request takes seconds instead of minutes.' — '1.8s median'。(2) HardDrive — 'Runs on your machine' — 'No code leaves your laptop or CI runner. Works on a plane, in air-gapped networks and behind strict proxies.' — '0 bytes uploaded'。(3) Wand2 — 'Fixes you can apply' — 'Most findings ship a patch. Preview it inline, apply it with one key, and [BRAND] re-reviews the result.' — '143 of 212 rules auto-fix'。(4) ShieldAlert — 'Security rules on by default' — 'Timing-safe comparisons, secrets in diffs, unsafe deserialization and SQL built from strings.' — '38 security rules'。(5) Keyboard — 'Keyboard-first TUI' — 'j and k to move, a to apply, i to ignore with a reason. ferrule review -i opens the interactive view.' — 'press ? on this page'。(6) FileCog — 'One config file' — 'Rules, severities and ignores live in .ferrule.toml next to your code and get reviewed like everything else.' — '.ferrule.toml'。网格下方,ConfigSnippet:左侧文本块 'Configure once, run everywhere.'(display 22px)+ Muted 行 'The same file drives the pre-commit hook, the CI step and the editor diagnostics.';右侧一个代码面板,标题 '.ferrule.toml',行内容:'[review]' / 'base = "main"' / 'fail_on = "high"' / 'languages = ["typescript", "go", "python"]' / '' / '[rules]' / '"async-foreach-await" = "high"' / '"magic-number" = { level = "medium", ignore = ["tests/**"] }' / '"structured-logging" = "low"',带一个复制按钮。
布局:网格框架:10px 圆角,1px Line 边框,overflow hidden,display grid 在 Line 背景上 gap 1px,使每个单元格共享细线边框;单元格为 Panel,24px 内边距。lg 下 3 列,md(≥768px)下 2 列,以下 1 列。ConfigSnippet 位于下方 48px:lg 下 5/7 分栏,低于 1024px 堆叠;代码面板使用与 diff 查看器头相同的 chrome。
动效:单元格以 0.06s 交错显现。悬停时单元格背景变为 Panel 2,其图标上移 2px(0.2s)。
6. **基准测试(#benchmarks)** — 眉题 'Benchmarks';标题 'Fast enough to run on every save.';标题旁一个等宽 11px 徽章:'Illustrative figures'。分段标签页:'Review time' 和 'Bugs caught'。标签页 'Review time' — 说明 'Seconds to review a 1,240-line pull request · lower is better';行从上到下(标签,值):'[BRAND]' 1.8s;'[BRAND] --deep' 4.6s;'Linter chain (5 tools)' 7.9s;'Hosted review bot' 38.0s;'Script calling a large model' 52.4s。标签页 'Bugs caught' — 说明 'Seeded bugs found, out of 50 · higher is better';行:'[BRAND] --deep' 46;'[BRAND]' 41;'Script calling a large model' 33;'Hosted review bot' 29;'Linter chain (5 tools)' 17。右列,三个统计磁贴堆叠:'21×' + 'faster than a hosted review bot';'0.4s' + 'to re-review after applying a fix';'92%' + 'of seeded bugs caught in deep mode'。图表下方脚注(等宽 11.5px,Faint,最大 720px):'Illustrative numbers for this page. Measured on an invented 1,240-line TypeScript and Go pull request with 50 seeded bugs, 10-core laptop, median of 10 runs. Other rows are generic tool categories, not specific products.'
布局:lg 下 8/4 分栏(图表 8,磁贴 4),低于 1024px 堆叠,磁贴在 md 下为 3 列行,移动端堆叠。每个条形行:标签列 220px(等宽 13px;[BRAND] 行以 Text 显示,前面有一个 Signal 6px 方块,其他为 Muted)| 轨道(高度 28px,Panel 背景,1px Line 边框,6px 圆角),条形在内([BRAND] 行为 Signal,其他为 Line Strong)| 值 64px 右对齐等宽 14px([BRAND] 为 Text,其他为 Muted)。宽度 = 值 / 活动标签页中的最大值。低于 640px 时标签位于其轨道上方,值移到轨道右端内。统计磁贴:Panel,1px Line 边框,10px 圆角,24px 内边距,数字以 display 40px Text 显示,单位以 Signal 显示,标签 Muted 14px。
动效:条形竞速和计数如 Design motion 中所述;活动标签页胶囊以 layoutId 滑动。统计磁贴数字在可见时计数一次。
7. **Integrations(#integrations)** — 眉标 'Integrations';标题 'Fits where reviews already happen.' 两行带标签的 chip。'Works with'(标签 mono 12px Faint):Pre-commit hook、Pre-push hook、CI pipelines、Merge request comments、Editor diagnostics (LSP)、SARIF output、JSON output、Monorepos、Self-hosted runners、Offline mode。'Languages':TypeScript、Go、Python 在前(来自 [LANGUAGES],每个带一个 Signal 6px 圆点,表示"完全支持"),然后是 JavaScript、Rust、Java、Kotlin、Ruby、SQL(无圆点,尾部带一个 mono 10px 的 'beta')。仅纯文本 chip,无 logo。行下方是一行带复制按钮的 mono 命令:'$ ferrule hooks install',以及 Muted 文本 'adds the pre-commit hook in one step'。
布局:Container,行间距 24px。Chip:inline-flex,mono 13px,内边距 6px 12px,1px Line 边框,6px 圆角,Panel 背景,以 8px 间距换行。md 及以上时标签列在左侧宽 140px;移动端标签位于其 chip 上方。
动效:Chip 按行以 0.02s 交错淡入;悬停时边框变为 Line Strong,文字变为 Text。
8. **Changelog teaser(#changelog)** — 眉标 'Changelog';标题 'Shipping every week.';Muted 行 'Four recent releases. Breaking changes are rare and always come with a migration command.' 条目(版本标签 mono 13px 字重 700,类型标签,一行变更):v2.4.0 [Latest, Signal 标签] [feat] 'Suggested fixes for 41 more rules; ferrule fix now re-reviews automatically.';v2.3.2 [fix] 'Go generics no longer trip the shadowed-variable rule.';v2.3.0 [perf] 'Cold start down from 420 ms to 140 ms with a shared parse cache.';v2.2.0 [feat] 'Interactive TUI: ferrule review -i with j/k navigation and inline apply.' 展开前隐藏:v2.1.1 [fix] 'SARIF output now includes rule help text.';v2.1.0 [feat] 'Python support leaves beta with 64 rules.';v2.0.0 [breaking] 'Config moved to .ferrule.toml; ferrule migrate converts the old file.';v1.9.0 [feat] 'Hook installer: ferrule hooks install.' 列表下方按钮:'Show 4 older releases' 带 Lucide ChevronDown,切换为 'Show fewer' 带 ChevronUp。无日期。
布局:最大宽度 760px,在容器内左对齐。垂直时间线:左侧 7px 处一条 1px Line 竖线;每个条目在竖线上有一个 9px 圆点(v2.4.0 为 Signal,其余为 Line Strong),然后是一行:版本标签、类型标签(feat 为 Info,fix 和 perf 为 Add,breaking 为 Del;mono 11px,1px 边框,颜色 40% 透明度,6px 圆角),以及变更文本,md 时以 Text 15px 同行显示,移动端在标签下方换行。条目间距 20px。
动效:条目以 0.05s 交错显现;展开效果同 Design motion。快捷键 'l' 滚动到此处。
9. **Final install CTA(#install)** — 标题(display 44px / 移动端 32px,居中):'Run your first review in 30 seconds.' Muted 副行:'Free for teams that ship several times a day, from side projects to monorepos. No account, no upload.' 与 hero 相同的 InstallBox(共享标签页状态),居中。下方是三个带复制按钮的编号步骤,以 mono 行呈现:'1 npm i -g ferrule'(跟随所选安装标签页)、'2 ferrule review --base main'、'3 ferrule hooks install'。然后是一个 ghost 按钮 'Keyboard shortcuts' 带 Kbd '?',点击打开浮层。
布局:居中列,最大宽度 620px,位于全出血带内,带径向 Signal 辉光(radial-gradient(600px circle at 50% 0%, rgba(198,244,50,0.08), transparent 70%))和淡网格。步骤行:Panel,1px Line 边框,6px 圆角,内边距 12px 16px,步骤编号为 Signal,命令为 Text,复制图标按钮在右;行间距 8px。
动效:显现时向上淡入。复制行为和 toast 同 Design motion。
10. **Footer** — 左侧:Wordmark 和 Muted 行 '[BRAND] — a local-first code review CLI for TypeScript, Go and Python.' 中间:两个链接列 — 'Product':Demo、Features、Benchmarks、Changelog(哈希锚点);'Install':npm、brew、npx(各自复制该命令并显示 toast;渲染为按钮,样式如链接)。底行(1px Line 顶部边框,mono 12px Faint):左侧 '© [BRAND] contributors · Apache-2.0 core';右侧为保留时的 [CREDIT] 链接。
布局:Container,顶部内边距 64px / 底部 40px,md 时三列网格(品牌列更宽:2fr 1fr 1fr),移动端堆叠。底行 flex justify-between,移动端换行。
动效:除链接悬停颜色外无。
11. **Keyboard shortcuts overlay and hint chip(global)** — 提示 chip:固定右下角,mono 12px,'Press ? for shortcuts' 带 Kbd '?',Panel 背景,1px Line 边框,圆角 999px;点击打开浮层。浮层:模态框标题 'Keyboard shortcuts'(display 20px),带关闭按钮(Lucide X)和两列行列表(描述在左,Text 14px,按键在右为 Kbd):'?' 打开此面板;'Esc' 关闭;'c' 复制安装命令;'d' 跳转到 diff demo;'f' 跳转到 features;'b' 跳转到 benchmarks;'l' 跳转到 changelog;'i' 跳转到 install;'t' 返回顶部;'r' 重放终端;'a' 应用当前打开的推荐修复(当 diff demo 在视野内时)。底部行 mono 12px Faint:'Shortcuts are ignored while typing in a field.' Kbd 组件:mono 12px,最小宽度 22px,高度 22px,居中,Panel 2 背景,1px Line Strong 边框加 2px 底部边框,6px 圆角。
布局:浮层面板:宽度 min(560px, 100vw - 32px),最大高度 80vh 带内部滚动,居中,Panel 背景,1px Line 边框,10px 圆角,内边距 24px;行之间以 1px Line 分隔线隔开。提示 chip 距底部和右边缘 20px(移动端 16px),浮层打开时隐藏;移动端仅显示 'Shortcuts' 带 Kbd。
动效:打开/关闭动画同 Design motion。全局处理器忽略带 Ctrl/Meta/Alt 的按键以及输入到 input、textarea 或 contenteditable 中的按键;'c' 复制所选安装标签页的命令并弹出 toast;分区键平滑滚动(减少动效时为即时)。浮层为 role dialog,aria-modal 为 true,aria-labelledby 指向其标题,打开时焦点移至关闭按钮,Tab 被限制在内部,关闭时焦点返回打开者。
## 资产
- 图像:不使用照片、插图或位图图像。所有视觉元素均在本项目的代码中绘制:字标字形(在“设计图像”下描述的内联 SVG)、终端和差异查看器的界面框架、严重程度圆点、条形图、背景网格(CSS 渐变)以及噪点叠加层(内联 SVG feTurbulence data URI)。在 ASSETS.md 中注明这些均为项目原创。
- 图像:public/favicon.svg:一个 32x32 的 SVG,包含一个圆角方形(rx 7),填充色为 #C6F432,以及两条 #0A0B0D 水平条(x 7、y 11、宽度 14、高度 3,以及 x 11、y 18、宽度 14、高度 3,两者 rx 均为 1.5)——与字标字形相同的标记。手工编写,未使用生成器。
- 图标:lucide-react(ISC),从 npm 安装并进行 tree-shaking:Copy、Check、Download、Keyboard、ArrowRight、ArrowDown、Pause、Play、RotateCcw、FileCode2、CheckCircle2、Zap、HardDrive、Wand2、ShieldAlert、FileCog、ChevronDown、ChevronUp、X。尺寸 16–20px,strokeWidth 1.75。不使用 octicon 风格或代码托管类字形,不使用品牌图标。
- 字体:通过 Fontsource npm 包自托管,在 src/fonts.ts 中导入,以便 Vite 将 woff2 文件打包到 dist/ 中:@fontsource-variable/space-grotesk(Space Grotesk,OFL-1.1,Florian Karsten)、@fontsource-variable/inter(Inter,OFL-1.1,Rasmus Andersson)、@fontsource-variable/jetbrains-mono(JetBrains Mono,OFL-1.1,JetBrains)。在 ASSETS.md 中列出全部三种字体,并注明包名、上游来源和许可证。
## 禁止事项
- 不得有任何形式的后端:不得有服务器代码、API 路由、数据库、认证、分析、会提交到任何地方的 forms 或第三方 API。复制到剪贴板和快捷键浮层是仅有的会触及页面之外浏览器的交互。
- 不得从 fonts.googleapis.com、fonts.gstatic.com、Adobe Fonts 或任何 CDN 加载字体。仅通过三个 Fontsource 包自托管。
- 不得使用 CDN 的 <script>、<link> 或 import maps。每个脚本、样式、字体和图标都位于项目中,并打包进 dist/。
- 生产构建中不得有 source maps(build.sourcemap false),且 src/ 不会被复制进 dist/。
- 使用相对资源路径(Vite base './')。内部链接是 index.html 上的哈希锚点(#demo、#features、#benchmarks、#integrations、#changelog、#install、#top)或 ./index.html,绝不能是裸目录或前导斜杠。不得有链接指向不存在的页面。
- 除非用户要求,否则不得更改技术栈(Vite 5 + React 18 + TypeScript + Tailwind CSS 3.4 + Motion + lucide-react + Fontsource)。不得使用 router、UI kit、语法高亮库、图表库、3D。
- 不得出现真实代码审查、linting、测试或 AI 编程工具的名称、logo 或字标。产品是虚构的 [BRAND];其唯一标识是代码绘制的字形和排版名称。
- 条形竞赛中不得出现真实基准数字和真实竞品名称。行是通用类别('Hosted review bot'、'Linter chain (5 tools)'、'Script calling a large model'),每个数字都是虚构的,图表保留其 'Illustrative figures' 徽章和方法学脚注。
- integrations 或任何其他地方不得出现真实公司或开源项目 logo;integrations 是带有通用名称的纯文本 chips,语言是纯文字。
- 不得复制真实代码托管站点的 diff 视图样式、颜色、布局 chrome 或 octicon 风格字形。按规范从零绘制 diff 查看器,并且仅使用 Lucide 图标。
- terminal、diff、config 或 changelog 示例中不得出现真实仓库名、用户名、人物或真实代码。使用虚构的 ledgerline 仓库和此处给出的代码。
- 不得使用商业或自定义字体:仅使用 Space Grotesk、Inter 和 JetBrains Mono(OFL),自托管。
- 仅使用 MIT、ISC、BSD、Apache-2.0、0BSD、CC0 或 Unlicense 下的依赖(字体为 OFL)。不得使用 Aceternity UI、Tailwind Plus / Tailwind UI 或购买的模板代码;每个效果都自己编写。
- 不得使用照片、图库图片、占位图服务、Unsplash、Pexels 或 Pixabay。所有视觉元素均以代码绘制。
- 仅一种强调色:Signal lime。Add、Del、Warn 和 Info 是仅用于 diffs、severities 和 changelog tags 的语义色,绝不用于按钮或标题。不得有紫色渐变、不得有 glassmorphism 卡片、不得有超出指定的两个微妙效果(terminal shadow 和 final CTA radial)的霓虹光晕。
- 站点中任何地方都不得提及 VibeFather、其定价、成员或数字,除了可选的 [CREDIT] 页脚链接。
- 严格按照 Design motion 中所述尊重 prefers-reduced-motion:typing、spinner、comment sequence 和 bar race 跳转到其结束状态。terminal loop 在屏幕外或标签页隐藏时暂停。
- 无障碍:每个交互元素都可通过键盘到达,并带有可见的 2px Signal 焦点环(outline-offset 2px);overlay 捕获焦点并在 Esc 时关闭;tabs 使用 role tablist/tab 和 aria-selected;terminal body 的 aria-live 为 off,并带有 session 1 的 sr-only 摘要;copy buttons 有 aria-labels;toast 使用 role status。
- 必须在 1440×900 和 390×844 下渲染,零控制台错误且无水平页面滚动(仅 diff 代码区域和 terminal 行可在其自身框内滚动)。Clipboard 调用包裹在 try/catch 中,并带有 textarea 回退。
- 保持 dist/ 低于 20 MB(目标低于 2 MB)。
- 不得有 lorem ipsum、填充内容或炒作词汇。不得有 meta descriptions、Open Graph tags、JSON-LD 或 sitemap:仅有 <title> 和 favicon。
---
— Prompt by VibeFather · https://vibefather.ai/t/dark-developer-tool-launch-page · CC BY-NC 4.0 (non-commercial; commercial use needs a VibeFather Pro license) · Request removal: https://vibefather.ai/takedown
个人项目可免费使用(CC BY-NC 4.0)。 商业用途需要 Pro.
DESIGN.md
单独的设计规范:配色、字体、间距和动效。可以把这套视觉用到你已有的项目上。
---
name: "Dark Developer Tool Launch Page"
colors:
ink: "#0A0B0D"
panel: "#111317"
panel_2: "#171A1F"
line: "#22262D"
line_strong: "#323842"
text: "#E7E9EC"
muted: "#8C939D"
faint: "#5B626C"
signal: "#C6F432"
signal_ink: "#0A0B0D"
add: "#3DDC97"
add_bg: "rgba(61,220,151,0.09)"
del: "#FF6B6B"
del_bg: "rgba(255,107,107,0.09)"
warn: "#F5B841"
info: "#6CB4FF"
typography:
display_hero_headline_56px_desktop_38px_mobile_weight_600_tracking_0_03em_line_height_1_02_section_headings_36px_28px_weight_600_tracking_0_02em_stat_numbers: { family: "Space Grotesk", weights: [500, 600, 700] }
text_body_16px_1_6_weight_400_card_titles_16px_weight_500_buttons_14px_weight_500: { family: "Inter", weights: [400, 500, 600] }
mono_terminal_13_5px_1_7_diff_13px_1_65_install_commands_15px_eyebrows_and_labels_12px_uppercase_tracking_0_08em_all_numbers_kbd_keys_chips_version_tags: { family: "JetBrains Mono", weights: [400, 500, 700] }
spacing: "Container max-width 1200px with 24px side padding (16px under 640px). Sections are separated by 1px Line borders full-bleed, with 112px vertical padding on desktop and 72px on mobile. Grids use a 1px gap over a Line-colored background so cells share hairline borders. Inner card padding 24px. Base unit 4px; dense rhythm, no huge empty bands."
radius: "6px on buttons, chips, kbd keys, inputs and tags; 10px on the terminal window, diff viewer, install box, overlay panel and feature grid outer frame; 999px only on severity dots and the hint chip."
---
# Dark Developer Tool Launch Page — Design System
Apply this design system to an existing project. It describes the look and feel only; for the full site, use prompt.md.
## Colors
- **Ink** `#0A0B0D` — Page background, terminal body
- **Panel** `#111317` — Cards, diff viewer body, install box, overlay panel
- **Panel 2** `#171A1F` — Terminal and diff title bars, hunk header rows, hovered rows, kbd keys
- **Line** `#22262D` — All 1px hairline borders and dividers, inactive benchmark bars track
- **Line Strong** `#323842` — Hovered borders, inactive benchmark bars, kbd bottom border
- **Text** `#E7E9EC` — Headlines and body text
- **Muted** `#8C939D` — Secondary copy, line numbers, terminal prompt path, labels
- **Faint** `#5B626C` — Footnotes, disabled states, diff context gutter
- **Signal** `#C6F432` — The one accent: primary buttons, our benchmark bars, active tab underline, focus rings, caret, git branch in the prompt, 'Latest' tag, wordmark glyph
- **Signal Ink** `#0A0B0D` — Text on Signal buttons and tags
- **Add** `#3DDC97` — Added-line +/- gutter sign and text tint, success checkmarks, 'perf' and 'fix' changelog tags
- **Add BG** `rgba(61,220,151,0.09)` — Added-line row background
- **Del** `#FF6B6B` — Removed-line sign, 'high' severity dot and tag, 'breaking' tag
- **Del BG** `rgba(255,107,107,0.09)` — Removed-line row background
- **Warn** `#F5B841` — 'medium' severity dot and tag
- **Info** `#6CB4FF` — 'low' severity dot and tag, 'feat' changelog tag, code keywords
## Typography
- **Display: hero headline (56px desktop / 38px mobile, weight 600, tracking -0.03em, line-height 1.02), section headings (36px / 28px, weight 600, tracking -0.02em), stat numbers** — Space Grotesk (OFL), weights 500/600/700. Self-host the font files.
- **Text: body 16px/1.6 weight 400, card titles 16px weight 500, buttons 14px weight 500** — Inter (OFL), weights 400/500/600. Self-host the font files.
- **Mono: terminal (13.5px/1.7), diff (13px/1.65), install commands (15px), eyebrows and labels (12px uppercase, tracking 0.08em), all numbers, kbd keys, chips, version tags** — JetBrains Mono (OFL), weights 400/500/700. Self-host the font files.
## Spacing & shape
- Spacing: Container max-width 1200px with 24px side padding (16px under 640px). Sections are separated by 1px Line borders full-bleed, with 112px vertical padding on desktop and 72px on mobile. Grids use a 1px gap over a Line-colored background so cells share hairline borders. Inner card padding 24px. Base unit 4px; dense rhythm, no huge empty bands.
- Radius: 6px on buttons, chips, kbd keys, inputs and tags; 10px on the terminal window, diff viewer, install box, overlay panel and feature grid outer frame; 999px only on severity dots and the hint chip.
## Motion
- Section reveal: every section heading and block fades up (opacity 0 to 1, y 16px to 0, 0.5s, ease [0.22, 1, 0.36, 1]) once when 20% visible; children stagger by 0.06s.
- Hero terminal: commands type character by character at 32ms per char with a blinking block caret (Signal, 1s steps); output lines appear one by one with 110ms between lines; the spinner cycles the braille frames ⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏ every 80ms for 900ms before being replaced by its result line. After the last line of session 2 it waits 2.6s, fades the body out over 0.3s and restarts session 1. It starts only when the terminal is in view and pauses when off screen or when the tab is hidden.
- Diff viewer: when the viewer is 35% in view, the three comments open in order, 1.1s apart. For each, the anchored line gets a 1.2s pulse-line highlight, then the comment card expands from height 0 to auto with opacity 0 to 1 (0.45s); the matching item in the Findings panel ticks from a hollow dot to a filled severity dot.
- Benchmark race: when the chart is 40% in view, bars grow from width 0 to their value (1.1s, ease [0.22, 1, 0.36, 1], stagger 0.12s top to bottom) and the numbers count up in sync using Motion's animate() on a motion value, formatted to one decimal for seconds and integers for counts. Switching tabs replays the race from 0.
- Micro-interactions: copy buttons swap the Lucide Copy icon for Check with a 0.15s scale pop and show a toast 'Copied: <command>' bottom-center for 1.8s; buttons lift 1px and brighten on hover; chips and cards change border to Line Strong on hover; the active tab underline slides between tabs with a shared layoutId.
- Shortcut overlay: backdrop fades to rgba(10,11,13,0.72) with backdrop-blur 6px in 0.2s; the panel scales from 0.97 to 1 and fades in over 0.2s; Esc or a backdrop click reverses it.
- Changelog expand: older entries animate height 0 to auto and fade in over 0.35s.
- prefers-reduced-motion: no typing, spinner or loop (the terminal renders session 1 complete and static with a Replay button that swaps to session 2), diff comments are all open from the start, bars and numbers render at their final values, reveals are instant, smooth scrolling is off. Overlay and toast still appear but without scale or movement.
## Imagery
No photos and no illustrations. The visual interest comes from code-drawn UI: the terminal window, the diff viewer, the bar chart, hairline grids, a very faint 48px background grid under the hero masked with a radial fade, and a 3.5% SVG noise overlay across the page. The wordmark glyph is an inline SVG: a 20x20 rounded square (radius 5) in Signal with two Ink horizontal strokes of different length, like two diff lines, the lower one offset right by 4px. Icons are Lucide at 18–20px with stroke-width 1.75.
## Tone
Terse, technical and confident, like a well-written README. Short sentences, concrete numbers, real command names, no hype words (no 'revolutionary', 'blazing', 'supercharge', 'magic'). Monospace for anything a developer would type or read in a terminal.
---
— Prompt by VibeFather · https://vibefather.ai/t/dark-developer-tool-launch-page · CC BY-NC 4.0 (non-commercial; commercial use needs a VibeFather Pro license) · Request removal: https://vibefather.ai/takedown
改成你自己的
- 独立开发者发布测试运行器:把 PRODUCT 设为测试运行器,将 LANGUAGES 指向你支持的文件类型,并把 diff 评论重写为失败测试标注。
- 平台团队发布基础设施 linter:把 BRAND_SLUG 设为你的命令,将配置片段换成你的规则文件,并把 diff 评论变成规则违规。
- 面向后端工程师的 AI 编程助手:设置 PRODUCT 和 AUDIENCE,然后重写终端会话,展示助手会话而不是审查运行。
- 面向遗留代码库的迁移工具:保留 diff 查看器,把 TypeScript 示例换成你的迁移前后对比,并让基准竞速围绕已转换文件数展开。
深色开发者工具发布页:常见问题
深色开发者工具发布页的 BRAND、PRODUCT 和 LANGUAGES 变量能改什么?
深色开发者工具发布页通过五个变量重写标题、终端会话、diff 示例、配置片段、基准指标和集成标签:BRAND 设定工具名称,BRAND_SLUG 设定命令和包名,PRODUCT 设定工具的功能,LANGUAGES 设定展示的文件类型,AUDIENCE 设定页面对谁说话。布局、颜色和动效保持不变。
开发者工具发布页的键盘快捷键浮层是怎么工作的?
深色开发者工具发布页以键盘优先:按下问号键,或点击角落的提示标签,就会打开带 kbd 样式按键的快捷键浮层。快捷键真实可用,覆盖复制安装命令、在区块间跳转和重播终端会话,让页面本身展示目标受众早已熟悉的终端习惯。
这个深色发布页能用于 linter、测试运行器或迁移工具,而不是代码审查 CLI 吗?
可以。深色开发者工具发布页围绕 PRODUCT 变量构建,把它设为 linter,diff 评论就变成规则违规;设为测试运行器,就变成失败测试标注;迁移工具或 AI 编程助手也会有各自的审查会话。提示词中写明,文案、终端会话、diff 和基准都会针对新的产品类型重写。
怎么用 AI 做一个深色开发者工具发布页?
复制本页的提示词,或者运行 npx vibefather add dark-developer-tool-launch-page,把 [BRAND]、[PRODUCT]、[AUDIENCE]、[LANGUAGES] 换成你自己的内容,再粘贴到 Claude Code、Codex、Cursor 等 AI 编程工具里。在线演示就是用这份提示词原样做出来的。