@litfamily/litgravity 0.1.1 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +46 -0
- package/README.md +19 -3
- package/README_ko-KR.md +19 -3
- package/TRADEMARK.md +12 -0
- package/package.json +3 -2
- package/plugin/hooks/lib/lanes.mjs +65 -0
- package/plugin/hooks/lib/liveness.mjs +81 -0
- package/plugin/hooks/lib/motion.mjs +34 -5
- package/plugin/hooks/lib/reentry.mjs +7 -0
- package/plugin/hooks/lib/rewind/brief.mjs +364 -0
- package/plugin/hooks/lib/rewind/collect.mjs +359 -0
- package/plugin/hooks/lib/rewind/gauge.mjs +55 -0
- package/plugin/hooks/lib/rewind/next-step.mjs +77 -0
- package/plugin/hooks/lib/rewind/redact.mjs +60 -0
- package/plugin/hooks/lib/rewind/transcripts.mjs +214 -0
- package/plugin/hooks/lib/routes.mjs +79 -5
- package/plugin/hooks/lib/workflow-stack.mjs +213 -0
- package/plugin/hooks/post-tool-use.mjs +39 -1
- package/plugin/hooks/pre-invocation.mjs +93 -2
- package/plugin/hooks/session-start.mjs +26 -3
- package/plugin/hooks/stop.mjs +55 -6
- package/plugin/hud/looks.mjs +29 -0
- package/plugin/hud/render.mjs +277 -12
- package/plugin/plugin.json +1 -1
- package/plugin/skills/frontend-ui-ux/SKILL.md +12 -1
- package/plugin/skills/frontend-ui-ux/kit/components.css +417 -0
- package/plugin/skills/frontend-ui-ux/kit/fonts.json +22 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/landing.html +164 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/settings.html +114 -0
- package/plugin/skills/frontend-ui-ux/kit/layouts/workspace.html +115 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/computational-brutalism.json +227 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/field-notes.json +205 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/graphite.json +200 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/meadow.json +199 -0
- package/plugin/skills/frontend-ui-ux/kit/styles/neo-brutalism.json +222 -0
- package/plugin/skills/frontend-ui-ux/kit/ui.js +226 -0
- package/plugin/skills/frontend-ui-ux/references/house-styles.md +234 -0
- package/plugin/skills/frontend-ui-ux/scripts/design-lock.mjs +400 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-lock.mjs +196 -0
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-page.mjs +30 -9
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe-rules.mjs +20 -8
- package/plugin/skills/frontend-ui-ux/scripts/interface-probe.mjs +42 -9
- package/plugin/skills/frontend-ui-ux/scripts/pixel-art.mjs +60 -0
- package/plugin/skills/lit-adhd/SKILL.md +160 -0
- package/plugin/skills/lit-adhd/references/card-examples.md +107 -0
- package/plugin/skills/lit-adhd/references/status-taxonomy.md +34 -0
- package/plugin/skills/lit-adhd/scripts/rewind.mjs +5 -0
- package/plugin/skills/lit-diagram-drawer/SKILL.md +5 -3
- package/plugin/skills/lit-diagram-drawer/references/drawing-rules.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/style-guide.md +21 -12
- package/plugin/skills/lit-diagram-drawer/references/type-architecture.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-dependency.md +1 -1
- package/plugin/skills/lit-diagram-drawer/references/type-tree.md +3 -3
- package/plugin/skills/lit-diagram-drawer/references/type-wardley.md +1 -1
- package/plugin/skills/lit-diagram-drawer/scripts/diagram-craft-rules.mjs +1 -2
- package/plugin/skills/lit-diagram-drawer/scripts/visual-quality.mjs +1 -2
- package/plugin/skills/lit-docx/SKILL.md +3 -3
- package/plugin/skills/lit-handoff/SKILL.md +1 -0
- package/plugin/skills/lit-hijack/SKILL.md +263 -0
- package/plugin/skills/lit-hijack/references/capture-and-provenance.md +100 -0
- package/plugin/skills/lit-hijack/references/clean-room-build.md +75 -0
- package/plugin/skills/lit-hijack/references/distil-and-licence.md +67 -0
- package/plugin/skills/lit-hijack/references/gap-and-port-design.md +100 -0
- package/plugin/skills/lit-hijack/references/parity-and-report.md +85 -0
- package/plugin/skills/lit-hijack/scripts/hijack.mjs +953 -0
- package/plugin/skills/lit-plan/SKILL.md +3 -2
- package/plugin/skills/lit-plan/references/plan-contract.md +12 -1
- package/plugin/skills/lit-plan/scripts/check-plan.mjs +39 -3
- package/plugin/skills/lit-plan/templates/plan.md +3 -0
- package/plugin/skills/lit-pptx/SKILL.md +8 -8
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Bold.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/JetBrainsMono-Regular.ttf +0 -0
- package/plugin/skills/lit-pptx/fonts/jetbrains-mono/OFL.txt +93 -0
- package/plugin/skills/lit-pptx/fonts/provenance.json +32 -1
- package/plugin/skills/lit-pptx/references/agents/analyst.md +34 -56
- package/plugin/skills/lit-pptx/references/agents/antithesis.md +49 -67
- package/plugin/skills/lit-pptx/references/agents/architect.md +38 -51
- package/plugin/skills/lit-pptx/references/agents/critic.md +25 -41
- package/plugin/skills/lit-pptx/references/agents/synthesizer.md +37 -46
- package/plugin/skills/lit-pptx/references/agents/thesis.md +29 -49
- package/plugin/skills/lit-pptx/references/anti-slop-checklist.md +119 -145
- package/plugin/skills/lit-pptx/references/authoring-guide.md +187 -278
- package/plugin/skills/lit-pptx/references/consensus-protocol.md +99 -97
- package/plugin/skills/lit-pptx/references/data-display-cookbook.md +36 -137
- package/plugin/skills/lit-pptx/references/density-and-fill.md +147 -216
- package/plugin/skills/lit-pptx/references/design-system-azure.md +56 -85
- package/plugin/skills/lit-pptx/references/direction-step.md +134 -176
- package/plugin/skills/lit-pptx/references/examples/01-pitch-signal-ko.md +114 -115
- package/plugin/skills/lit-pptx/references/examples/02-pitch-studio-ko.md +66 -66
- package/plugin/skills/lit-pptx/references/examples/03-business-review-ledger-ko.md +63 -63
- package/plugin/skills/lit-pptx/references/examples/04-business-review-night-en.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/05-research-talk-paper-en.md +81 -81
- package/plugin/skills/lit-pptx/references/examples/06-lecture-chalk-ko.md +103 -103
- package/plugin/skills/lit-pptx/references/examples/07-data-review-night-en.md +100 -98
- package/plugin/skills/lit-pptx/references/examples/08-image-led-atlas-ko.md +76 -76
- package/plugin/skills/lit-pptx/references/examples/09-briefing-gazette-ko.md +96 -96
- package/plugin/skills/lit-pptx/references/examples/10-status-update-ledger-ko.md +80 -80
- package/plugin/skills/lit-pptx/references/examples/11-portfolio-studio-en.md +72 -72
- package/plugin/skills/lit-pptx/references/examples/12-research-tutorial-chalk-en.md +95 -95
- package/plugin/skills/lit-pptx/references/examples/13-engineering-review-computational-brutalism-ko.md +173 -0
- package/plugin/skills/lit-pptx/references/examples/14-launch-pitch-neo-brutalism-ko.md +154 -0
- package/plugin/skills/lit-pptx/references/examples/15-design-lecture-bauhaus-ko.md +139 -0
- package/plugin/skills/lit-pptx/references/examples/16-community-programme-riso-ko.md +158 -0
- package/plugin/skills/lit-pptx/references/examples/17-public-data-briefing-newsroom-ko.md +179 -0
- package/plugin/skills/lit-pptx/references/interview-protocol.md +83 -102
- package/plugin/skills/lit-pptx/references/layout-families.md +161 -265
- package/plugin/skills/lit-pptx/references/stages/autopilot.md +30 -70
- package/plugin/skills/lit-pptx/references/stages/interview.md +36 -68
- package/plugin/skills/lit-pptx/references/stages/plan.md +26 -67
- package/plugin/skills/lit-pptx/references/title-treatments.md +93 -145
- package/plugin/skills/lit-pptx/references/tonalities/atlas.md +95 -108
- package/plugin/skills/lit-pptx/references/tonalities/bauhaus.md +140 -0
- package/plugin/skills/lit-pptx/references/tonalities/chalk.md +107 -122
- package/plugin/skills/lit-pptx/references/tonalities/computational-brutalism.md +150 -0
- package/plugin/skills/lit-pptx/references/tonalities/gazette.md +87 -111
- package/plugin/skills/lit-pptx/references/tonalities/ledger.md +96 -125
- package/plugin/skills/lit-pptx/references/tonalities/neo-brutalism.md +161 -0
- package/plugin/skills/lit-pptx/references/tonalities/newsroom.md +144 -0
- package/plugin/skills/lit-pptx/references/tonalities/night.md +104 -131
- package/plugin/skills/lit-pptx/references/tonalities/paper.md +114 -130
- package/plugin/skills/lit-pptx/references/tonalities/riso.md +137 -0
- package/plugin/skills/lit-pptx/references/tonalities/signal.md +96 -103
- package/plugin/skills/lit-pptx/references/tonalities/studio.md +81 -112
- package/plugin/skills/lit-pptx/scripts/compile-deck.js +4 -6
- package/plugin/skills/lit-pptx/scripts/craft_extras.py +135 -91
- package/plugin/skills/lit-pptx/scripts/deck_craft.py +1 -1
- package/plugin/skills/lit-pptx/scripts/embed_fonts.py +13 -1
- package/plugin/skills/lit-pptx/scripts/layout_inventory.py +1 -1
- package/plugin/skills/lit-pptx/scripts/learn_template.py +1 -1
- package/plugin/skills/lit-pptx/scripts/lib/grid-resolver.js +101 -110
- package/plugin/skills/lit-pptx/scripts/lib/layout-resolver.js +9 -15
- package/plugin/skills/lit-pptx/scripts/lib/render-pack.js +370 -563
- package/plugin/skills/lit-pptx/scripts/lib/slide-grid.js +104 -0
- package/plugin/skills/lit-pptx/scripts/lib/template-registry.js +57 -6
- package/plugin/skills/lit-pptx/scripts/qa_deck.py +6 -6
- package/plugin/skills/lit-pptx/scripts/render_pages.py +31 -0
- package/plugin/skills/lit-pptx/scripts/validate_pptx.py +1 -1
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v1.md +167 -191
- package/plugin/skills/lit-pptx/specs/markdown-slide-spec-v2.md +117 -166
- package/plugin/skills/lit-pptx/specs/template-enrollment-contract.md +307 -330
- package/plugin/skills/lit-pptx/templates/tonalities/atlas/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/bauhaus/pack.yaml +98 -0
- package/plugin/skills/lit-pptx/templates/tonalities/chalk/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/computational-brutalism/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/gazette/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/ledger/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/neo-brutalism/pack.yaml +107 -0
- package/plugin/skills/lit-pptx/templates/tonalities/newsroom/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/night/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/paper/pack.yaml +1 -1
- package/plugin/skills/lit-pptx/templates/tonalities/riso/pack.yaml +99 -0
- package/plugin/skills/lit-pptx/templates/tonalities/signal/pack.yaml +2 -2
- package/plugin/skills/lit-pptx/templates/tonalities/studio/pack.yaml +1 -1
- package/plugin/skills/lit-schematic/SKILL.md +114 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/build.mjs +38 -0
- package/plugin/skills/lit-schematic/examples/iso-heat-exchanger/scene.mjs +133 -0
- package/plugin/skills/lit-schematic/examples/journal-adsorption-rig/build.mjs +87 -0
- package/plugin/skills/lit-schematic/examples/pid-dosing-skid/build.mjs +85 -0
- package/plugin/skills/lit-schematic/references/cutaway-outputs.md +70 -0
- package/plugin/skills/lit-schematic/references/isometric-craft.md +101 -0
- package/plugin/skills/lit-schematic/references/journal-figures.md +72 -0
- package/plugin/skills/lit-schematic/references/kit-api.md +134 -0
- package/plugin/skills/lit-schematic/references/pfd-and-layout.md +53 -0
- package/plugin/skills/lit-schematic/references/pid-drafting.md +103 -0
- package/plugin/skills/lit-schematic/references/pid-symbols.md +163 -0
- package/plugin/skills/lit-schematic/references/verification.md +100 -0
- package/plugin/skills/lit-schematic/scripts/doctor.mjs +57 -0
- package/plugin/skills/lit-schematic/scripts/lib/figure.mjs +81 -0
- package/plugin/skills/lit-schematic/scripts/lib/fonts.mjs +27 -0
- package/plugin/skills/lit-schematic/scripts/lib/geom.mjs +113 -0
- package/plugin/skills/lit-schematic/scripts/lib/interactive.mjs +292 -0
- package/plugin/skills/lit-schematic/scripts/lib/isa.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/lib/iso.mjs +719 -0
- package/plugin/skills/lit-schematic/scripts/lib/legend-sheet.mjs +162 -0
- package/plugin/skills/lit-schematic/scripts/lib/pid.mjs +937 -0
- package/plugin/skills/lit-schematic/scripts/lib/png.mjs +132 -0
- package/plugin/skills/lit-schematic/scripts/lib/qa-core.mjs +658 -0
- package/plugin/skills/lit-schematic/scripts/lib/route.mjs +218 -0
- package/plugin/skills/lit-schematic/scripts/lib/sheet.mjs +890 -0
- package/plugin/skills/lit-schematic/scripts/lib/svg.mjs +82 -0
- package/plugin/skills/lit-schematic/scripts/lib/theme.mjs +115 -0
- package/plugin/skills/lit-schematic/scripts/motion.mjs +129 -0
- package/plugin/skills/lit-schematic/scripts/qa.mjs +92 -0
- package/plugin/skills/lit-schematic/scripts/render.mjs +233 -0
- package/plugin/skills/lit-schematic/scripts/scaffold.mjs +60 -0
- package/plugin/skills/lit-scientific-visualization/SKILL.md +17 -6
- package/plugin/skills/lit-typographic-motion/SKILL.md +58 -48
- package/plugin/skills/lit-typographic-motion/engine/THIRD_PARTY_NOTICES +13 -2
- package/plugin/skills/lit-typographic-motion/engine/blender/runner.py +218 -0
- package/plugin/skills/lit-typographic-motion/engine/core/presets.mjs +1 -1
- package/plugin/skills/lit-typographic-motion/engine/node/analysis.mjs +65 -1
- package/plugin/skills/lit-typographic-motion/engine/node/assets.mjs +298 -0
- package/plugin/skills/lit-typographic-motion/engine/node/blender.mjs +143 -0
- package/plugin/skills/lit-typographic-motion/engine/node/board.mjs +136 -0
- package/plugin/skills/lit-typographic-motion/engine/node/brief.mjs +7 -1
- package/plugin/skills/lit-typographic-motion/engine/node/chrome.mjs +9 -12
- package/plugin/skills/lit-typographic-motion/engine/node/cover-assets.mjs +5 -3
- package/plugin/skills/lit-typographic-motion/engine/node/cover-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/cover-treatment.mjs +37 -4
- package/plugin/skills/lit-typographic-motion/engine/node/cover.mjs +19 -8
- package/plugin/skills/lit-typographic-motion/engine/node/done.mjs +45 -6
- package/plugin/skills/lit-typographic-motion/engine/node/frame-worker.mjs +7 -5
- package/plugin/skills/lit-typographic-motion/engine/node/gallery.mjs +121 -0
- package/plugin/skills/lit-typographic-motion/engine/node/host.mjs +34 -0
- package/plugin/skills/lit-typographic-motion/engine/node/house.mjs +44 -0
- package/plugin/skills/lit-typographic-motion/engine/node/look.mjs +34 -20
- package/plugin/skills/lit-typographic-motion/engine/node/pipeline.mjs +19 -9
- package/plugin/skills/lit-typographic-motion/engine/node/scaffold.mjs +210 -0
- package/plugin/skills/lit-typographic-motion/engine/node/score.mjs +639 -0
- package/plugin/skills/lit-typographic-motion/engine/node/sound-cli.mjs +21 -4
- package/plugin/skills/lit-typographic-motion/engine/node/sound.mjs +127 -29
- package/plugin/skills/lit-typographic-motion/engine/node/stage-capture.mjs +7 -6
- package/plugin/skills/lit-typographic-motion/engine/node/stage-gate.mjs +59 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage-qa.mjs +141 -9
- package/plugin/skills/lit-typographic-motion/engine/node/stage-serve.mjs +28 -5
- package/plugin/skills/lit-typographic-motion/engine/node/stage.mjs +82 -14
- package/plugin/skills/lit-typographic-motion/engine/node/styles.mjs +213 -0
- package/plugin/skills/lit-typographic-motion/engine/node/treatment.mjs +311 -10
- package/plugin/skills/lit-typographic-motion/engine/stage/cover-init.js +14 -2
- package/plugin/skills/lit-typographic-motion/engine/stage/init.js +11 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/qa.js +6 -1
- package/plugin/skills/lit-typographic-motion/engine/stage/stage-kit.js +83 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/LICENSE +21 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/environments/RoomEnvironment.js +144 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/addons/geometries/RoundedBoxGeometry.js +155 -0
- package/plugin/skills/lit-typographic-motion/engine/vendor/three/three.module.js +54571 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/expected.json +69 -0
- package/plugin/skills/lit-typographic-motion/recipes/hero-3d/index.html +139 -0
- package/plugin/skills/lit-typographic-motion/recipes/orbit-loop/expected.json +6 -4
- package/plugin/skills/lit-typographic-motion/recipes/painted-light/expected.json +4 -2
- package/plugin/skills/lit-typographic-motion/recipes/weight-tide/expected.json +7 -5
- package/plugin/skills/lit-typographic-motion/references/cover.md +394 -443
- package/plugin/skills/lit-typographic-motion/references/craft-loop.md +57 -87
- package/plugin/skills/lit-typographic-motion/references/depth.md +122 -0
- package/plugin/skills/lit-typographic-motion/references/look.md +94 -129
- package/plugin/skills/lit-typographic-motion/references/runtime.md +58 -91
- package/plugin/skills/lit-typographic-motion/references/sound.md +130 -99
- package/plugin/skills/lit-typographic-motion/references/stage.md +190 -215
- package/plugin/skills/lit-typographic-motion/references/studio.md +245 -0
- package/plugin/skills/lit-typographic-motion/references/style-bibles.md +108 -97
- package/plugin/skills/lit-typographic-motion/references/treatment.md +191 -143
- package/plugin/skills/lit-typographic-motion/scripts/motion-doctor.mjs +17 -5
- package/plugin/skills/lit-typographic-motion/scripts/motion.mjs +47 -7
- package/plugin/skills/lit-typographic-motion/styles/paper.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/swiss-signal.json +41 -0
- package/plugin/skills/lit-typographic-motion/styles/terminalcore.json +42 -0
- package/plugin/skills/lit-typographic-motion/styles/tidal.json +41 -0
- package/plugin/skills/litresearch/SKILL.md +1 -0
- package/plugin/skills/readme-studio/SKILL.md +2 -0
- package/plugin/skills/review-work/SKILL.md +1 -1
- package/plugin/skills/start-work/SKILL.md +2 -2
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
# Neo-Brutalism
|
|
2
|
+
|
|
3
|
+
Neo-Brutalism is the loud direction, and it is loud on purpose. Every card is a flat yellow block
|
|
4
|
+
with a thick black border and a hard black shadow offset down and to the right, with no blur at all.
|
|
5
|
+
Titles are heavy and tight, the topic band is saturated blue, one pink-red accent marks the figure
|
|
6
|
+
the slide is for, and the ground is a warm cream. Nothing is soft: no gradients, no rounded corners,
|
|
7
|
+
no glow. It reads like a poster or a product sticker, so it suits a room that should feel energy,
|
|
8
|
+
and it stays legible because every colour pair still meets the contrast floor.
|
|
9
|
+
|
|
10
|
+
## When to use it
|
|
11
|
+
|
|
12
|
+
Reach for Neo-Brutalism for a startup pitch at a demo day, a consumer product launch, a campaign
|
|
13
|
+
kick-off, a creator or community event, a hackathon final or an education deck for a young audience.
|
|
14
|
+
The content signals that point here are a short body (one claim and two or three facts per slide),
|
|
15
|
+
three or four headline numbers, a launch or sign-up ask, and words such as 런칭, 출시, 데모데이,
|
|
16
|
+
캠페인, 크리에이터, or the user asking for something bold, punchy or "brutalist". It is the second
|
|
17
|
+
candidate for the pitch deck type, after Signal, and the first when the user asks for a bold or
|
|
18
|
+
playful look.
|
|
19
|
+
|
|
20
|
+
## When it is the wrong choice
|
|
21
|
+
|
|
22
|
+
It fails for a formal report, an academic talk, a board or finance review and any deck read alone
|
|
23
|
+
later: the blocks take space a reader needs for detail, and a slide of long paragraphs between thick
|
|
24
|
+
borders reads as noise. It is wrong for grief, safety, HR or financial-loss topics, and
|
|
25
|
+
for a deck under a corporate brand guide. When the brief says "clean" or "minimal", Signal or Studio
|
|
26
|
+
fits; when it says "report", Ledger or Gazette.
|
|
27
|
+
|
|
28
|
+
## Tokens
|
|
29
|
+
|
|
30
|
+
The values below come from the pack file and are what the engine draws.
|
|
31
|
+
|
|
32
|
+
| Token | Value |
|
|
33
|
+
|---|---|
|
|
34
|
+
| ground / surface | #FFF5E1 / #FFD43B (the yellow card) |
|
|
35
|
+
| ink / ink-muted / line | #111111 / #3A3A3A / #111111 |
|
|
36
|
+
| accent / accent-deep / accent-tint | #D81B5C / #6B0F2E / #FFC9DA |
|
|
37
|
+
| field / on-field | #2F4BFF / #FFFFFF |
|
|
38
|
+
| positive / negative | #137A43 / #111111 |
|
|
39
|
+
| series | #D81B5C, #2F4BFF, #111111, #137A43 |
|
|
40
|
+
| faces | Pretendard Bold for display, title, labels and numerals, Pretendard Regular for body; `faces: a2z` swaps to A2Z Black display, titles and numerals |
|
|
41
|
+
| register / ramp / hero | bold / presented (body 18 pt, labels 14, sources 12, titles 32, display 44) / allowed: a statement and a big figure may take the 72 pt hero step |
|
|
42
|
+
| type voice | titles tracked −2, display −3 |
|
|
43
|
+
| density / variance | 10 / 7 |
|
|
44
|
+
| radius / edge | 0 / fill and border, 2.5 pt in ink |
|
|
45
|
+
| shadow | 6 pt offset at 45°, ink, fully opaque, no blur |
|
|
46
|
+
| table | yellow header, ruled grid, protagonist row in pink tint, bold totals |
|
|
47
|
+
| chart | no gridlines, direct labels, series in order (pink, blue, black) |
|
|
48
|
+
|
|
49
|
+
This is the family's bold register (`register: bold`): it sets presented type and the 72 pt hero step, so
|
|
50
|
+
titles, figures and statements run large, but they fill the same slide-grid zones as every other
|
|
51
|
+
pack. A title still sits in the one title zone and the body still starts at y 120; the register
|
|
52
|
+
changes the size inside a zone, never the zone. The registry refuses presented type in a pack without
|
|
53
|
+
`register: bold`, so a report pack cannot drift into this size by accident; every pack takes its own
|
|
54
|
+
hero step on the cover and statements. A KPI
|
|
55
|
+
row keeps its bordered cards, because the card is this direction's figure. The pink accent was darkened until a pink figure on a yellow card still holds 3:1 at title
|
|
56
|
+
size. Losses use ink with a ▼ sign, because pink already means "look here".
|
|
57
|
+
|
|
58
|
+
The shadow is written into the file as a real outer shadow with a blur of zero, so PowerPoint,
|
|
59
|
+
Keynote and LibreOffice all draw the same hard edge. Every block of the blue field (a band, a
|
|
60
|
+
section page, a cover plate) carries the black border too.
|
|
61
|
+
|
|
62
|
+
## QA allowances
|
|
63
|
+
|
|
64
|
+
The yellow card, the blue band and the pink accent share a content slide inside the default OF-101
|
|
65
|
+
limit (four hue families; a fifth fails). The gate reads this pack's `qa:` block:
|
|
66
|
+
`offset-shadow: true` lets OF-120 pass the hard shadow; a shadow with any blur still fails, and the
|
|
67
|
+
same shadow in any pack without this allowance fails. Contrast floors are unchanged.
|
|
68
|
+
|
|
69
|
+
## Treatments by slide role
|
|
70
|
+
|
|
71
|
+
Content slides and data with a takeaway take `top-plain-large`; data, sequence, reference and
|
|
72
|
+
definition slides take `band` (the title in white on the blue band); image slides `bottom-anchor`;
|
|
73
|
+
statements `statement`. `kicker-numeral` is the third option for a sequence. The engine lays out
|
|
74
|
+
every treatment the family allows, keeps the role's own when the body fills, and otherwise takes the
|
|
75
|
+
one that leaves the least empty band. Force one with `title: <id>` on the line after `layout:`.
|
|
76
|
+
|
|
77
|
+
## Families and variants
|
|
78
|
+
|
|
79
|
+
- `kpi-row` sets two to four results as yellow cards, each with value, label and basis.
|
|
80
|
+
- `big-number` is a blue panel of related figures beside the facts that explain them.
|
|
81
|
+
- `comparison` reads before and after across shared rows.
|
|
82
|
+
- `process` and `step-diagram` show three to five steps with a numeral in the accent.
|
|
83
|
+
- `chart-insight` carries one growth chart with its takeaway beside it.
|
|
84
|
+
- `table-insight` holds the one table a pitch needs, usually unit economics.
|
|
85
|
+
- `image-split` pairs a product shot with three short points.
|
|
86
|
+
- `summary-box-list` sets two to four bordered boxes of one claim each.
|
|
87
|
+
- `agenda`, `quote` and `statement` keep the type loud and the page open.
|
|
88
|
+
|
|
89
|
+
Covers are `cover-typographic`, `cover-split-field` and `cover-numeral`; sections are
|
|
90
|
+
`section-field` and `section-numeral`; closings are `closing-ask`, `closing-decision-box` and
|
|
91
|
+
`closing-statement`.
|
|
92
|
+
|
|
93
|
+
Display slides. The typographic cover sets the topic in white on a blue plate across the lower
|
|
94
|
+
half, bordered in black. A statement drenches the page in blue with the sentence in white. A big
|
|
95
|
+
number is a blue field panel. A closing's next step sits in a bordered box with its shadow.
|
|
96
|
+
|
|
97
|
+
## Do
|
|
98
|
+
|
|
99
|
+
- Keep one claim per slide and write it in the first body line, in plain words.
|
|
100
|
+
- Give every figure its label and its basis in the card.
|
|
101
|
+
- Let the yellow cards carry figures and short labels, never paragraphs.
|
|
102
|
+
- End on `closing-ask` with the amount, its uses and the next meeting.
|
|
103
|
+
|
|
104
|
+
## Avoid
|
|
105
|
+
|
|
106
|
+
- Blurred or soft shadows, rounded corners and gradients; the look is flat and hard.
|
|
107
|
+
- Thin hairlines beside the 2.5 pt borders.
|
|
108
|
+
- More than three fill colours on one slide.
|
|
109
|
+
- Muted grey text on the yellow surface.
|
|
110
|
+
- This direction for formal reports or sensitive topics.
|
|
111
|
+
|
|
112
|
+
## Two worked slides
|
|
113
|
+
|
|
114
|
+
A launch deck opens its traction slide with four results as cards and two facts under them.
|
|
115
|
+
|
|
116
|
+
```markdown
|
|
117
|
+
---
|
|
118
|
+
layout: kpi-row
|
|
119
|
+
|
|
120
|
+
## 베타 8주 성과, 2026년 10월
|
|
121
|
+
|
|
122
|
+
| 가입자 | 주간 재방문 | 추천 가입 | 유료 전환 |
|
|
123
|
+
|---|---|---|---|
|
|
124
|
+
| 1만 2천 명 | 46% | 38% | 7.4% |
|
|
125
|
+
| 목표 1만 명 | 업계 평균 25% | 광고비 0원 | 목표 5% |
|
|
126
|
+
|
|
127
|
+
> 베타 운영 기록, 2026년 8-10월 (예시)
|
|
128
|
+
|
|
129
|
+
- 광고 없이 가입자 목표를 넘겼다: 셋 중 하나 이상이 친구 추천으로 왔다
|
|
130
|
+
- 유료 전환 7.4%는 목표 5%를 넘었고, 연 결제가 그중 60%다
|
|
131
|
+
- 출처: 예시 서비스 운영 대시보드, 2026년 10월 (예시)
|
|
132
|
+
---
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
The closing states the ask, shows where the money goes and names the next step.
|
|
136
|
+
|
|
137
|
+
```markdown
|
|
138
|
+
---
|
|
139
|
+
layout: closing-ask
|
|
140
|
+
|
|
141
|
+
## 시드 15억 원 사용 계획
|
|
142
|
+
|
|
143
|
+
| 쓰임 | 금액 | 시점 |
|
|
144
|
+
|---|---|---|
|
|
145
|
+
| 앱 개발 인력 4명 | 7억 원 | 2027년 상반기 |
|
|
146
|
+
| 크리에이터 제휴 200곳 | 4억 원 | 2027년 1분기 |
|
|
147
|
+
| 마케팅 실험 | 3억 원 | 상시 |
|
|
148
|
+
| 운영 예비비 | 1억 원 | 필요 시 |
|
|
149
|
+
| 합계 | 15억 원 | 12개월 |
|
|
150
|
+
|
|
151
|
+
> 투자금 쓰임 (예시 데이터)
|
|
152
|
+
|
|
153
|
+
- 요청: 시드 15억 원 투자 승인
|
|
154
|
+
- 기대 성과: 12개월 뒤 가입자 10만 명, 월 매출 2억 원
|
|
155
|
+
- 다음 단계: 11월 첫째 주 후속 미팅, 담당 예시 대표
|
|
156
|
+
---
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
## Examples
|
|
160
|
+
|
|
161
|
+
`14-launch-pitch-neo-brutalism-ko.md`
|
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
# Newsroom
|
|
2
|
+
|
|
3
|
+
Newsroom is the direction for a data story told to people who do not read tables: a public
|
|
4
|
+
briefing, an explainer, a newsletter's deck, a talk that walks a general audience through a few
|
|
5
|
+
numbers. It looks like a newspaper's graphics desk: a black masthead band behind the title of a
|
|
6
|
+
data page and the cover, a heavy black rule under the other titles, grey charts with one orange series, labels on the lines, and a source and period under every figure.
|
|
7
|
+
The title names the topic and its period; the finding leads the body, in the first line under the
|
|
8
|
+
chart.
|
|
9
|
+
|
|
10
|
+
## When to use it
|
|
11
|
+
|
|
12
|
+
Reach for Newsroom when the deck is a handful of charts with one point each, written for readers
|
|
13
|
+
outside the field: a city or school data briefing to residents, a survey result for members, a
|
|
14
|
+
newsletter's "what the numbers say", a research explainer for the press, a public talk on prices,
|
|
15
|
+
housing, climate or health figures. The content signals that point here are one or two charts per
|
|
16
|
+
idea, a finding per chart, sources and periods on every figure and
|
|
17
|
+
words such as 브리핑, 설명, 주민, 시민, 독자, 뉴스레터, 데이터로 본, explainer, briefing or "what the
|
|
18
|
+
data says". It is the first candidate for a data story for the public, ahead of Gazette and
|
|
19
|
+
Ledger.
|
|
20
|
+
|
|
21
|
+
## When it is the wrong choice
|
|
22
|
+
|
|
23
|
+
It fails for an internal, dense review where people read tables line by line (Ledger), for a pitch
|
|
24
|
+
(Signal or Neo-Brutalism), for a lecture that builds an argument step by step (Chalk) and for a
|
|
25
|
+
written report that happens to be a deck (Paper or Gazette). It is wrong when there are no figures:
|
|
26
|
+
the grey-and-orange charts are the voice.
|
|
27
|
+
|
|
28
|
+
## Tokens
|
|
29
|
+
|
|
30
|
+
The values below come from the pack file and are what the engine draws.
|
|
31
|
+
|
|
32
|
+
| Token | Value |
|
|
33
|
+
|---|---|
|
|
34
|
+
| ground / surface | #FBFAF7 / #EEEDEA |
|
|
35
|
+
| ink / ink-muted / line | #111111 / #55534D / #CCCAC5 |
|
|
36
|
+
| accent / accent-deep / accent-tint | #C2410C / #7C2A08 / #FBE3D3 |
|
|
37
|
+
| field / on-field | #111111 / #FFFFFF |
|
|
38
|
+
| positive / negative | #1F6B3A / #111111 |
|
|
39
|
+
| series | #C2410C, #77746C, #2F5D8A, #111111 |
|
|
40
|
+
| faces | Pretendard Bold for display, title, labels and numerals, Pretendard Regular for body; `faces: a2z` swaps to A2Z Bold display, titles and numerals |
|
|
41
|
+
| ramp / hero | compact (body 13 pt, labels 11, sources 9) / hero step (60 pt) on cover and statement titles that fit, off with `hero: false`; figures at most title size |
|
|
42
|
+
| density / variance | 10 / 6 |
|
|
43
|
+
| radius / edge | 0 / fill |
|
|
44
|
+
| decoration | hairline rules, column hairlines, kicker numerals; the masthead band is the `band` title |
|
|
45
|
+
| table | open, no header fill, a rule under the header, bold totals |
|
|
46
|
+
| chart | horizontal gridlines, direct labels, the accent on the story's series over greys |
|
|
47
|
+
|
|
48
|
+
The orange holds 5.2:1 on the paper, so it can set a kicker word or a figure. The second series is a
|
|
49
|
+
warm grey, the third a quiet blue for the one line a story compares against. Rules and surfaces are
|
|
50
|
+
neutral greys: a warm-tinted rule reads as a second hue family beside the orange. A loss uses ink
|
|
51
|
+
with a ▼ sign.
|
|
52
|
+
|
|
53
|
+
## QA allowances
|
|
54
|
+
|
|
55
|
+
None beyond the default craft floor. The source line under every figure is the house rule here,
|
|
56
|
+
and the gate's source checks already ask for it.
|
|
57
|
+
|
|
58
|
+
## Treatments by slide role
|
|
59
|
+
|
|
60
|
+
Data slides take `band` (the title in white on the black masthead band across the top);
|
|
61
|
+
data-with-takeaway and image slides take `bottom-anchor` (the title over a heavy black rule); content, reference and definition slides take `top-rule`; sequences
|
|
62
|
+
`kicker-numeral`; statements `statement`. Every treatment draws in the slide grid's one title zone,
|
|
63
|
+
so a band, a bottom-anchor and a top-rule title sit at the same place and only their surface or
|
|
64
|
+
rule differs.
|
|
65
|
+
Force one with `title: <id>` on the line after `layout:`.
|
|
66
|
+
|
|
67
|
+
## Families and variants
|
|
68
|
+
|
|
69
|
+
- `full-chart` gives one chart the whole body; `chart-insight` sets it beside two or three lines.
|
|
70
|
+
- `kpi-over-chart` puts the headline figures over the chart they come from.
|
|
71
|
+
- `big-number` and `kpi-row` carry a single figure or three.
|
|
72
|
+
- `figure-pair` sets two charts side by side for a before and after.
|
|
73
|
+
- `table-insight`, `comparison` and `timeline` hold the few tables and dates a story needs.
|
|
74
|
+
- `image-split`, `text-two-column` and `sidebar-note` explain a method or a term.
|
|
75
|
+
- `references-appendix` lists the sources at the end; `quote` and `statement` hold a resident's
|
|
76
|
+
sentence or the story's one finding.
|
|
77
|
+
|
|
78
|
+
Covers are `cover-typographic`, `cover-figures` and `cover-index`; sections are `section-rule` and
|
|
79
|
+
`section-numeral`; closings are `closing-summary-list`, `closing-statement` and `closing-ask`.
|
|
80
|
+
|
|
81
|
+
Display slides. The typographic cover sets the deck title in white on the black masthead band,
|
|
82
|
+
with the meta line on the band and the deck's parts on the paper under it. A statement stands between two rules. A big number sits on the orange tint. A closing's next
|
|
83
|
+
step stands under a rule. A deck index runs along the top of the display slides.
|
|
84
|
+
|
|
85
|
+
## Do
|
|
86
|
+
|
|
87
|
+
- Name the topic and its period in the title; put the finding (what changed, by how much, since
|
|
88
|
+
when) in the first line of the body, where the gate expects a claim.
|
|
89
|
+
- Colour one series orange and leave the rest grey.
|
|
90
|
+
- Put the source and the period under every chart and table.
|
|
91
|
+
- Label lines and bars directly; a legend is for a chart that cannot take labels.
|
|
92
|
+
|
|
93
|
+
## Avoid
|
|
94
|
+
|
|
95
|
+
- More than one highlighted series on a chart.
|
|
96
|
+
- A chart without its source and period.
|
|
97
|
+
- 3D, gradients or pictograms standing in for numbers.
|
|
98
|
+
- This direction for a pitch, a lecture or an internal dense review.
|
|
99
|
+
|
|
100
|
+
## Two worked slides
|
|
101
|
+
|
|
102
|
+
A full chart names its topic in the title, keeps one orange line and states the finding under it.
|
|
103
|
+
|
|
104
|
+
```markdown
|
|
105
|
+
---
|
|
106
|
+
layout: full-chart
|
|
107
|
+
|
|
108
|
+
## 매매가 대비 전셋값 비율, 2023-2026년
|
|
109
|
+
|
|
110
|
+
::: chart type=line unit="%"
|
|
111
|
+
| 연도 | 우리 구 (%) | 시 평균 (%) |
|
|
112
|
+
|---|---|---|
|
|
113
|
+
| 2023년 | 55.2 | 56.0 |
|
|
114
|
+
| 2024년 | 57.1 | 56.8 |
|
|
115
|
+
| 2025년 | 59.4 | 57.9 |
|
|
116
|
+
| 2026년 | 61.3 | 58.6 |
|
|
117
|
+
> 매매가 대비 전셋값 비율, 해마다 6월 (예시 자료)
|
|
118
|
+
:::
|
|
119
|
+
|
|
120
|
+
- 우리 구의 전셋값이 처음으로 매매가의 60%를 넘었다
|
|
121
|
+
- 출처: 예시 구청 주택 통계, 2026년 (예시)
|
|
122
|
+
---
|
|
123
|
+
```
|
|
124
|
+
|
|
125
|
+
A KPI row carries three figures over what each means.
|
|
126
|
+
|
|
127
|
+
```markdown
|
|
128
|
+
---
|
|
129
|
+
layout: kpi-row
|
|
130
|
+
|
|
131
|
+
## 주민 설문 결과, 2026년 9월
|
|
132
|
+
|
|
133
|
+
| 응답자 | 이사 계획 | 첫째 이유 |
|
|
134
|
+
|---|---|---|
|
|
135
|
+
| 1,204명 | 31% | 주거비 |
|
|
136
|
+
| 9월 1-20일, 온라인·방문 | 2년 안에 이사할 생각 | 이사 계획자의 47% |
|
|
137
|
+
|
|
138
|
+
- 출처: 예시 구 주거 실태 설문, 2026년 (예시)
|
|
139
|
+
---
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
## Examples
|
|
143
|
+
|
|
144
|
+
`17-public-data-briefing-newsroom-ko.md`
|
|
@@ -1,174 +1,147 @@
|
|
|
1
1
|
# Night
|
|
2
2
|
|
|
3
|
-
Night is a
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
3
|
+
Night is a screen in a dark room. The ground is a deep blue-black, type is off-white, and the one
|
|
4
|
+
warm accent is amber, with a soft blue as the second series. Numbers sit in labelled rows at title
|
|
5
|
+
size at most, each with its basis, charts take most of the page, and a header band marks the slides that hold data. The
|
|
6
|
+
look keeps contrast high without glare, so a chart stays readable from the back of a hall. A plot or
|
|
7
|
+
diagram brought in as a picture on white would stand as a white card here: give it a `.dark` variant
|
|
8
|
+
beside the file, or its numbers as a `::: chart` block (authoring guide, "Charts").
|
|
9
9
|
|
|
10
|
-
## When to
|
|
10
|
+
## When to use it
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
12
|
+
Use Night for data and technical keynotes, product demos, architecture talks and quarterly reviews
|
|
13
|
+
shown on a big screen. It is the first candidate for a data-heavy review and moves up whenever the
|
|
14
|
+
brief says the deck is presented on a stage, at a demo day or in a darkened room. It also earns a
|
|
15
|
+
place when a third or more of the slides hold charts, because its families give charts the most
|
|
16
|
+
room of any pack.
|
|
17
17
|
|
|
18
|
-
|
|
19
|
-
|
|
18
|
+
## When it is the wrong choice
|
|
19
|
+
|
|
20
|
+
Night is wrong for decks that will be printed or read at a desk: a dark page wastes toner and tires
|
|
21
|
+
the eye on paper, so Ledger or Gazette serve those readers. It never mixes with light slides inside
|
|
22
|
+
one deck. It also lacks a table-led family, so a deck that is mostly lookup tables belongs in
|
|
23
|
+
Ledger.
|
|
20
24
|
|
|
21
25
|
## Tokens
|
|
22
26
|
|
|
27
|
+
These values are read from the pack file `pack.yaml` of the `night` tonality.
|
|
28
|
+
|
|
23
29
|
| Token | Value |
|
|
24
30
|
|---|---|
|
|
25
|
-
| ground / surface |
|
|
26
|
-
| ink / ink-muted
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
31
|
-
|
|
|
32
|
-
|
|
|
33
|
-
|
|
|
31
|
+
| ground / surface | `#0F1419` / `#1A222B` |
|
|
32
|
+
| ink / ink-muted | `#E8EDF2` / `#A3AEBA` |
|
|
33
|
+
| line | `#5A6672` |
|
|
34
|
+
| accent / accent-deep / accent-tint | `#E3A857` / `#F2C98A` / `#2A2418` |
|
|
35
|
+
| field / on-field | `#1E2A36` / `#F5F7FA` |
|
|
36
|
+
| positive / negative | `#6CC08B` / `#F08A7E` |
|
|
37
|
+
| series | `#E3A857`, `#7FB8E0`, `#A3AEBA`, `#C58FD0` |
|
|
38
|
+
| faces | display, title Pretendard Bold; body, label and numeral Pretendard Regular; `faces: a2z` swaps numerals to A2Z Light |
|
|
39
|
+
| ramp / hero | compact (body 13 pt, labels 11, sources 9) / hero step (60 pt) on cover and statement titles that fit, off with `hero: false`; figures at most title size |
|
|
40
|
+
| density / variance | 10 / 6 |
|
|
34
41
|
| radius / edge | 6 / fill |
|
|
35
|
-
| table | header
|
|
36
|
-
| chart | hairline gridlines, direct labels, accent on the
|
|
37
|
-
|
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
Role defaults: content, images and sequences take `top-plain-large` and `kicker-numeral`; data and
|
|
50
|
-
references take `band`; data with a takeaway and definitions take `side-rail`; statements take
|
|
51
|
-
`statement`. A `band` title sits inside a full-width band in the field colour (#1E2A36), which on this
|
|
52
|
-
ground reads as a lit header strip. `bottom-anchor` is absent, so a pin such as `title: bottom-anchor`
|
|
53
|
-
stops the compile with `Slide 1: title "bottom-anchor" is not one of the night treatments
|
|
54
|
-
(top-plain-large, statement, side-rail, kicker-numeral, band)`.
|
|
55
|
-
|
|
56
|
-
| Family | Default title | Then, in pack order |
|
|
57
|
-
|---|---|---|
|
|
58
|
-
| `full-chart` | `top-plain-large` | none |
|
|
59
|
-
| `chart-insight` | `side-rail` | `top-plain-large`, `band` |
|
|
60
|
-
| `kpi-row` | `band` | `top-plain-large`, `side-rail` |
|
|
61
|
-
| `kpi-over-chart` | `band` | `top-plain-large` |
|
|
62
|
-
| `dashboard-grid` | `band` | `side-rail` |
|
|
63
|
-
| `big-number` | `side-rail` | `top-plain-large` |
|
|
64
|
-
| `method` | `side-rail` | `band` |
|
|
65
|
-
| `comparison` | `band` (numbers) / `top-plain-large` (arguments) | `top-plain-large`, `side-rail`, `band` |
|
|
66
|
-
| `timeline` | `top-plain-large` | `band` |
|
|
67
|
-
| `statement` | `statement` | none |
|
|
42
|
+
| table | header row on the surface colour with bold ink, hairline rows, no banding, numbers right-aligned, totals bold, the row the title names in the accent tint |
|
|
43
|
+
| chart | hairline gridlines, direct labels, accent on the item that matters and muted colours on the rest |
|
|
44
|
+
| decoration | header band, hairline rule, numeral, rail fill |
|
|
45
|
+
|
|
46
|
+
## Treatments by slide role
|
|
47
|
+
|
|
48
|
+
Text slides and image slides take `top-plain-large`, a title with no rule. Data slides take
|
|
49
|
+
`band`, the header band across the top. Charts with a takeaway take `side-rail`, sequences take
|
|
50
|
+
`kicker-numeral`, definitions take `side-rail`, and a pull quote takes `statement`. When the role's
|
|
51
|
+
treatment would leave an empty lower band, the engine tries the other treatments the family allows
|
|
52
|
+
and keeps the one that fills, while staying inside the variance cap. Write `title: side-rail` (or
|
|
53
|
+
another allowed treatment) under the `layout:` line to fix a slide's treatment; the business review
|
|
54
|
+
example does this for a big number and a timeline so the deck mixes enough compositions.
|
|
68
55
|
|
|
69
56
|
## Families and variants
|
|
70
57
|
|
|
71
|
-
- `full-chart`: one chart across the
|
|
72
|
-
- `chart-insight`: a chart with two or three takeaways
|
|
73
|
-
|
|
74
|
-
- `kpi-
|
|
75
|
-
- `dashboard-grid`: two to four charts read together
|
|
76
|
-
|
|
77
|
-
- `
|
|
78
|
-
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
58
|
+
- `full-chart`: one chart across the body with a short note under it.
|
|
59
|
+
- `chart-insight`: a chart with two or three takeaways.
|
|
60
|
+
- `kpi-row`: two to four headline values at title size, each with what it measures and its basis.
|
|
61
|
+
- `kpi-over-chart`: a value row above the trend it summarises.
|
|
62
|
+
- `dashboard-grid`: two to four small charts read together.
|
|
63
|
+
- `big-number`: a panel of two to four related figures (value, label, basis) with its evidence.
|
|
64
|
+
- `method`: how a metric is defined, formula first.
|
|
65
|
+
- `comparison`: two options or two periods, row by row.
|
|
66
|
+
- `timeline`: dated events on one axis.
|
|
67
|
+
- `statement`: a pull quote, or a display-led slide the user asks for.
|
|
68
|
+
|
|
69
|
+
Covers are `cover-numeral`, `cover-typographic` and `cover-figures`. Sections are `section-numeral`
|
|
70
|
+
and `section-field`. Closings are `closing-statement` and `closing-decision-box`.
|
|
71
|
+
|
|
72
|
+
Display slides. The typographic cover sets the year from the deck's date at title size beside the
|
|
73
|
+
topic name. A statement sets its quoted line in up to three balanced lines. A big-number panel
|
|
74
|
+
stands in amber on the dark amber tint, one row per figure with its label and basis. A closing's rows are keyed by date or amount, and the next step runs in the
|
|
75
|
+
field band above the footer.
|
|
86
76
|
|
|
87
77
|
## Do
|
|
88
78
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
`flow.dark.png` in the same folder and the engine picks it up.
|
|
94
|
-
- Give each chart a caption with period and source, and name the highlighted series with a period or
|
|
95
|
-
a reference word.
|
|
79
|
+
Give each chart one highlighted series in amber and let the rest sit in muted tones. Keep titles
|
|
80
|
+
short labels (subject, measure, period): the open title and the band have tight glyph budgets, and the compile log warns when a title
|
|
81
|
+
runs over. Put the source on the last slide, inside the decision box. Use big numbers only for real
|
|
82
|
+
figures from the source, each with its basis and a sourced caption.
|
|
96
83
|
|
|
97
84
|
## Avoid
|
|
98
85
|
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
## Failure patterns
|
|
105
|
-
|
|
106
|
-
| Symptom | Cause | Fix |
|
|
107
|
-
|---|---|---|
|
|
108
|
-
| QA OF-117 "a light figure (92 % near-white) on a dark ground" | a PNG exported on a white background was placed in a `method` slide | add `<name>.dark.png` beside the picture, or redraw it as a `::: chart` |
|
|
109
|
-
| `Compilation error: ... title "bottom-anchor" is not one of the night treatments (...)` | a pin copied from a light pack | pin one of the five treatments, or drop the pin |
|
|
110
|
-
| a literal `> ...` line under a chart | the caption sits after the closing `:::` | put the `>` caption inside the block |
|
|
111
|
-
| the accent lands on the wrong series | no period or reference word in the series names | name earlier series with a period or a reference word, or put the highlighted series last |
|
|
112
|
-
| `dashboard-grid` falls back to one chart | the slide holds a single `::: chart` block | use `chart-insight`, or add a second chart |
|
|
86
|
+
Avoid neon or saturated glows, a pure black ground, and any light slide mixed in. Avoid thin light
|
|
87
|
+
type below 18 pt; it breaks up on a projector. Do not lean on red and green alone for change; pair
|
|
88
|
+
the
|
|
89
|
+
colour with a sign and an arrow.
|
|
113
90
|
|
|
114
91
|
## Two worked slides
|
|
115
92
|
|
|
116
|
-
|
|
117
|
-
|
|
93
|
+
A value row above its trend states each number once with its basis, and the chart shows where it
|
|
94
|
+
came from and anchors the floor of the slide.
|
|
118
95
|
|
|
119
96
|
```markdown
|
|
120
97
|
---
|
|
121
|
-
layout:
|
|
98
|
+
layout: kpi-over-chart
|
|
122
99
|
|
|
123
|
-
##
|
|
100
|
+
## Cost per million requests, Q3 2025-Q3 2026
|
|
124
101
|
|
|
125
|
-
|
|
126
|
-
| Week | Q2 median (ms) | Q3 median (ms) |
|
|
102
|
+
| Cost per million | Target | Change on Q2 |
|
|
127
103
|
|---|---|---|
|
|
128
|
-
|
|
|
129
|
-
|
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
|
133
|
-
|
|
134
|
-
|
|
104
|
+
| $1.82 | $2.00 | ▼ −9% |
|
|
105
|
+
| Q3 2026 | 9% under target | fourth fall in a row |
|
|
106
|
+
|
|
107
|
+
::: chart type=line unit="$"
|
|
108
|
+
| Quarter | Cost per million requests ($) |
|
|
109
|
+
|---|---|
|
|
110
|
+
| Q3 2025 | 2.61 |
|
|
111
|
+
| Q4 2025 | 2.34 |
|
|
112
|
+
| Q1 2026 | 2.12 |
|
|
113
|
+
| Q2 2026 | 2.00 |
|
|
114
|
+
| Q3 2026 | 1.82 |
|
|
115
|
+
> Cost per million requests by quarter (example data)
|
|
135
116
|
:::
|
|
136
117
|
---
|
|
137
118
|
```
|
|
138
119
|
|
|
139
|
-
|
|
120
|
+
A big-number panel holds three related figures with their basis and three lines of evidence, so
|
|
121
|
+
the figures are explained on the same page.
|
|
140
122
|
|
|
141
123
|
```markdown
|
|
142
124
|
---
|
|
143
|
-
layout:
|
|
125
|
+
layout: big-number
|
|
126
|
+
title: side-rail
|
|
144
127
|
|
|
145
|
-
##
|
|
128
|
+
## Incident recovery time, Q3 2026
|
|
146
129
|
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
|
151
|
-
| East | 0.38 |
|
|
152
|
-
| South | 0.61 |
|
|
153
|
-
| West | 0.35 |
|
|
154
|
-
> Error rate by region, Q3 (example data)
|
|
155
|
-
:::
|
|
130
|
+
| Median time to recover | Auto rollbacks | Slowest recovery |
|
|
131
|
+
|---|---|---|
|
|
132
|
+
| 8 min | 2 of 3 | 21 min |
|
|
133
|
+
| Q2: 27 min | before paging | database failover |
|
|
156
134
|
|
|
157
|
-
|
|
158
|
-
| Region | Cache hit rate (%) |
|
|
159
|
-
|---|---|
|
|
160
|
-
| North | 91 |
|
|
161
|
-
| East | 93 |
|
|
162
|
-
| South | 84 |
|
|
163
|
-
| West | 94 |
|
|
164
|
-
> Cache hit rate by region, Q3 (example data)
|
|
165
|
-
:::
|
|
135
|
+
> Incident log, July-September 2026 (example)
|
|
166
136
|
|
|
167
|
-
-
|
|
168
|
-
-
|
|
137
|
+
- Recovery time is now under ten minutes
|
|
138
|
+
- The median fell from 27 minutes in Q2 after automatic rollback went live in July
|
|
139
|
+
- Two of the three incidents were rolled back before a person was paged
|
|
140
|
+
- The slowest recovery, 21 minutes, was a database failover in week 9
|
|
169
141
|
---
|
|
170
142
|
```
|
|
171
143
|
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
144
|
+
## Examples
|
|
145
|
+
|
|
146
|
+
`04-business-review-night-en.md` and `07-data-review-night-en.md` both use the pack defaults
|
|
147
|
+
(density 10, variance 6).
|