Skip to content

The talk, told as a story: 68 slides from 'why do you love Next.js' to the contributor ask - #15

Merged
MUKE-coder merged 3 commits into
mainfrom
talk-85-slides
Oct 30, 2026
Merged

MUKE-coder merged 3 commits into
mainfrom
talk-85-slides

Conversation

@MUKE-coder

Copy link
Copy Markdown
Owner

What this changes

The deck at /talk keeps its renderer (talk.astro) and the clinic narrative, but slides.ts is rewritten from 43 slides to 85, built around one rule: one idea per slide. Nothing new is claimed about the product — every command, number and behaviour on a slide was already in the old deck or in the docs.

The flow problems this fixes

Before After
The problem act was 4 slides; Flare appeared before the pain landed Two full acts before Flare: the fortnight itemised and taken one item at a time (auth, uploads, admin, the table), then the three coping habits — copy the last project, buy a template, admin last — each followed by its catch on its own slide
Key arguments lived in captions under already-full splits Each argument is now its own statement slide: the bug in four projects, "a template is a fork with no upstream", the rule that lives in one place, the float bug (now a big 0.07 + 0.07 + 0.07 slide), admin-only by default
No roadmap; the room couldn't tell where it was A "Where this goes" slide after the speaker, numbered 01–08, matching the section order
Prescriptions had no slide; invoices and payments shared one Every table gets its own slide, so part one walks the whole chain
The position was implicit Part six now says it outright, twice: "Not a dependency. Not a template. Not a low-code tool." and "A starting point that stays current, in code you own."
No setup → payoff structure for the field types "Three traps" is named at the end of part one (money, files, sometimes-fields) and paid off as the part-five sequence
Ended on the claim A "Tonight" slide with the one command to run, then the close

Mechanics

  • The fortnight and the habits lists are module constants, so the focus slides that highlight one item at a time cannot drift out of sync.
  • Splits lost their stacked captions; each caption's point moved to the slide after it.
  • No changes to talk.astro or types.ts — only existing slide kinds are used.

Checked

  • astro build passes; /talk renders all 85 slides.
  • Paged through in a headless browser: no console errors, and no slide's content overflows its 1920×1080 stage (verified programmatically on a 22-slide sample covering every new layout use).

Generated by Claude Code

Muke JohnBaptist and others added 2 commits October 30, 2026 20:42
The deck told the right story but told it crowded: insights rode along
as captions under splits, the problem act was four slides long, and the
position — what Flare is instead of — was never said outright.

This keeps the renderer and the clinic narrative, and rewrites slides.ts:

- A slide now carries one idea. Captions that argued a point became
  statement slides of their own (the appointment rule, the float bug,
  the admin-built-last complaint, admin-only-by-default).
- The problem act is built properly before Flare appears: the fortnight
  itemised as a list, then taken one item at a time with the focus
  layout; then the three coping habits, each followed by its catch.
- A roadmap slide after the speaker, so the room knows where it is.
- Prescriptions, invoices and payments each get their own table slide;
  prescriptions had no slide at all before.
- "Three traps" is named in part one and paid off in part five, so the
  money/file/conditional sequence lands as a callback.
- Part six now states the position in two slides: not a dependency, not
  a template, not a low-code tool; a starting point that stays current,
  in code you own.
- A "tonight" slide before the close, with the one command to run.

Shared lists (the fortnight, the habits) are constants so the focus
slides cannot drift apart. Built and paged through end to end; no slide
overflows its stage.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012FCfxpfM8UsyjkG9kBSndw
The sibling talk at gritframework.dev/talk works because of its
structure, so this deck now runs on the same one, with slides 1-3 kept:

- A hook question (and its AI twin) before any argument.
- Twelve developer problems, D1-D12: listed once, then one at a time
  with the rest faded. Two get example slides (the fix that cannot
  travel; the float arithmetic).
- Eight client questions, B1-B8, each a quote in the client's voice,
  closed by the honest answer: "yes, in about three weeks."
- Why both lists survive: superb libraries that are not the shape, the
  template as a photograph of one Tuesday, and phase two. Then the
  hinge: generated, owned, and still improving.
- The idea, the one command, the by-hand comparison, and then what the
  command wrote, file by file (descriptor, migration, validators,
  route, client, policy, pages, OpenAPI).
- Four concepts, C1-C4 - the resource as the unit, nothing hidden,
  "there is no mechanism" answered, one description two platforms.
- The clinic build, three tool slides answering B6/B2 by number, the
  deploy, and three scorecards that account for all twenty problems.

Every slide carries speaker notes, and the viewer learns to show them:
N toggles a notes panel under the deck (types.ts grows an optional
notes field; the panel never renders on the stage, and print omits it).

The overflow check got stricter and caught a latent bug: a pre clips
its own content silently, so five code slides were losing their last
lines inside the frame - including the old deck's full-build slide.
Code is now 26px (96 mono columns on the stage), filenames moved into
eyebrows, and all 83 slides pass a stage + pre + child-spill check.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012FCfxpfM8UsyjkG9kBSndw
@MUKE-coder MUKE-coder changed the title Rebuild the talk: 85 slides, one idea each Rebuild the talk on the Grit deck's skeleton: 83 slides, twenty problems paid off Oct 30, 2026

Copy link
Copy Markdown
Owner Author

v2 — restructured on the gritframework.dev/talk skeleton (per request; slides 1–3 kept as they were).

What changed from the first rewrite:

  • The Grit structure: hook question (+ its AI twin) → D1–D12 developer problems, listed once then taken one at a time → B1–B8 client questions, each a quote in the client's voice → "why these survive" (libraries / templates / phase two) → the hinge question → the idea → one command → what it wrote, file by file (8 slides) → four concepts (C1–C4) → the clinic build → ship it → three scorecards that pay off all twenty problems by number.
  • Callbacks by number, like the Grit deck: "there is no mechanism" (D1-ex) returns word-for-word at C3; D3 gets ticked off on the client-type slide; B2/B6/B7 are answered by name in the tools and deploy acts.
  • Speaker notes on every slide, and the viewer now shows them: press N for a notes panel under the deck (never on the stage; hidden in print). types.ts grows an optional notes field.
  • A latent rendering bug fixed: a pre clips its own overflow silently, so five code slides — including the old deck's full-build slide — were losing their last lines inside the frame. Code is now 26px (≈96 mono columns on the 1920 stage), filenames moved into eyebrows, and all 83 slides pass a stricter stage + pre + child-spill check.

Build passes; notes toggle verified in a headless browser; zero console errors.

🤖 Generated with Claude Code

https://claude.ai/code/session_012FCfxpfM8UsyjkG9kBSndw


Generated by Claude Code

Told the way it will be spoken, per the speaker's own flow:

- Open on the room: who builds with Next.js, why do you love it, their
  answers written down, and an honest "Next.js earned this room" - so
  nothing later reads as a dunk.
- The blank canvas, and the two to-do lists every real project brings:
  six developer problems (the CRUD hell leading) and four client
  expectations, each a quote, each explained on its own slide.
- The turn: "what if there were a different first day" - introducing
  Flare, then the framework word struck out (delete the CLI, the app
  still builds), then the lineage slide: a code generator from the
  Rails/Django/Laravel family, with four ways Flare goes further.
- The proof: a Patient Management System. How long would it take you;
  the insight (tables, fields, relationships are the real work); the
  install command; the anatomy of a flare command; a field-grammar
  reference table; then all seven tables, each as a design slide plus
  its command, with every flag explained in the caption.
- Run it step by step: migrate, seed demo, dev, first-signup-is-admin,
  tunnel, deploy - closing the room's own "cheap to run" with a number.
- The ending the talk exists for: Flare needs contributors who will
  stay, with six concrete ways in.

68 slides, speaker notes on all, every slide re-checked for stage,
code-block and child overflow.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012FCfxpfM8UsyjkG9kBSndw

Copy link
Copy Markdown
Owner Author

v3 — the talk as a story, following the speaker's own flow end to end:

  1. The room first: who builds with Next.js → why do you love it (the floor answers; the slide writes them down: one app front+back, free deploy/cheap to run, …) → "Next.js earned this room."
  2. The blank canvas, then the two to-do lists: six developer problems (The CRUD Hell, auth again, types ×4, admin last, uploads, the fix that cannot travel) and four client expectations as quotes — each explained on its own slide.
  3. The turn: "what if there were a different first day" → Introducing Flare → did I say framework? (why devs hate the word / delete the CLI, the app still builds) → a code generator from the Rails/Django/Laravel family, with four ways it goes further.
  4. The proof — a Patient Management System: "how long would this take you?", the insight (tables + fields + relationships are the work), the install command, the anatomy of a flare command, a field-grammar reference table, then all seven tables — design slide + command slide each, every flag explained.
  5. Step by step: migrate → seed demo → dev → first sign-up is admin → tunnel → deploy, closing the room's own "cheap to run" with a real number.
  6. The ending: Flare needs people who will stay — the contributor ask, with six concrete ways in.

68 slides, speaker notes on every one (press N), all slides pass the stage/code/overflow checks, build green.

🤖 Generated with Claude Code

https://claude.ai/code/session_012FCfxpfM8UsyjkG9kBSndw


Generated by Claude Code

@MUKE-coder MUKE-coder changed the title Rebuild the talk on the Grit deck's skeleton: 83 slides, twenty problems paid off The talk, told as a story: 68 slides from 'why do you love Next.js' to the contributor ask Oct 30, 2026
@MUKE-coder
MUKE-coder merged commit fd7c0d5 into main Oct 30, 2026
1 of 3 checks passed
@MUKE-coder
MUKE-coder deleted the talk-85-slides branch October 30, 2026 19:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant