Skip to content

Anti-AI-slop design skill for Claude Code, Cursor, and Codex.

CSS

Pages are built from the visitor's job, not one stock anatomy

Youssef5c16b12e52e2
diff --git a/skills/hallmark/SKILL.md b/skills/hallmark/SKILL.md
index c7adf48..0d851cb 100644
--- a/skills/hallmark/SKILL.md
+++ b/skills/hallmark/SKILL.md
@@ -71,9 +71,11 @@ Skipped fields are opt-outs: infer them, state the inferences in one line at the
**Material first.** The inventory, one line: *real* (every concrete thing the brief and the project supply: name, claim, numbers, places, dates, images), *pictures* (what the page shows and where each comes from: the user's, screenshots of the real product, the product built, the library), *absent* (every proof it will not have: logos, quotes, metrics nobody gave). The shape follows it: a page with pictures leads with them (`imagery.md` § 1); a page about words carries type and facts (Long Document, Letter, Index-First, Manifesto).
-Then design the page: its shape, how it opens, each section's composition, the nav, the footer, what carries the hero. Starting points: 21 shapes in [`references/macrostructures.md`](references/macrostructures.md) (load only the file you pick); compositions, navs and footers in `layout.md`.
+**The job.** Name what a visitor comes to do (subscribe, book, visit, attend, buy, try, sign up, hire, join, listen) and read that job in [`references/anatomy.md`](references/anatomy.md): where real sites in the category put the action, the sections they are built around (the menu, the lineup, the issues, the record), and how they end. The page is built from that anatomy, never from a default run of figures, steps and an email band (85).
-**The draw.** On a theme build, once Step 3 has picked the theme, run `node <skill-dir>/scripts/theme.mjs draw --material photo|product|words --theme <slug> [--log .hallmark/log.json]`. Clear of the log and the theme's picture, it deals a shape, the hero posture, the nav, the footer, the first section, two compositions to leave out and what the hero leads with. Take it unless the material refuses a pick, and name any swap in the Picks block: one brief in one theme, built twice, makes two pages. **Mirror test:** would a neighbouring brief in the same category get this exact combination? If yes, change one decision and say which.
+Then design the page: its shape, how it opens, each section's content and composition, the nav, the footer, what carries the hero. Starting points: 21 shapes in [`references/macrostructures.md`](references/macrostructures.md) (load only the file you pick); compositions, navs and footers in `layout.md`.
+
+**The draw.** On a theme build, once Step 3 has picked the theme, run `node <skill-dir>/scripts/theme.mjs draw --material photo|product|words --job <job> --theme <slug> [--log .hallmark/log.json]`. Clear of the log and the theme's picture, it deals a shape, the hero posture, the nav, the footer, the first section, where the action sits, two compositions to leave out and what the hero leads with. Take it unless the material refuses a pick, and name any swap in the Picks block: one brief in one theme, built twice, makes two pages. **Mirror test:** would a neighbouring brief in the same category get this exact combination? If yes, change one decision and say which.
**Signature.** The one thing a visitor would remember: the brief's strongest real thing shown at its best (the photograph that is the place, the product doing its one job, a price set huge because it is the offer, a control to try). Make it in the theme's material, show it on the first screen, name it in the Picks block and the stamp. A number drawn as marks is a device, not a signature (82).
@@ -97,7 +99,7 @@ A theme is a material, not a plan: it never sets what the page contains or in wh
### 4. Load
-Exactly these, for a page build: [`references/layout.md`](references/layout.md) · [`references/imagery.md`](references/imagery.md) · [`references/craft.md`](references/craft.md) · `references/genres/<genre>.md` · `references/themes/<slug>.md` and its picture, already seen at the deal (a named theme: look at `<slug>.jpg` now). From the theme take its palette balance, type voice, surfaces and its Range (the sections it makes without a photograph), never its layout · [`references/gates.md`](references/gates.md) § 1 to § 4. A custom run loads `direction.md` instead of the layout, genre and theme files.
+Exactly these, for a page build: [`references/layout.md`](references/layout.md) · [`references/anatomy.md`](references/anatomy.md), the job's part · [`references/imagery.md`](references/imagery.md) · [`references/craft.md`](references/craft.md) · `references/genres/<genre>.md` · `references/themes/<slug>.md` and its picture, already seen at the deal (a named theme: look at `<slug>.jpg` now). From the theme take its palette balance, type voice, surfaces and its Range (the sections it makes without a photograph), never its layout · [`references/gates.md`](references/gates.md) § 1 to § 4. A custom run loads `direction.md` instead of the layout, genre and theme files.
Only when needed, in `references/`: one macrostructure file · `microinteractions.md` for stateful UI · `interaction-and-states.md` for forms · `responsive.md` for an unusual layout · `texture.md` when the theme names texture · `scroll-choreography.md` for a scroll story · `dark-mode.md` for both modes · `data-viz.md` for charts · `fonts.md` on custom runs · `comp.md` on signal 9 (comps, generated stills) · `design-md.md` to lock the system.
@@ -110,12 +112,12 @@ The run's only recital of its decisions, and the user's redirect window:
```markdown
**Hallmark · v2.0.0**
-- **Shape** · Workbench, from draw 7f3a2c · genre modern-minimal
+- **Shape** · Workbench, from draw 7f3a2c · genre modern-minimal · job: sign up, the action in the hero and beside the price
- **Theme** · Coral, dealt 2/3 (warm grey, one coral signal, General Sans, soft pills) · clears Cobalt on paper band
- **Chrome** · nav: edge-aligned, a wordmark and one action · footer: a mast, the wordmark over the links
- **Hero** · Stage: head on columns 1 to 5, the slot on 6 to 12 at 560px, centred
- **Signature** · the invoice list chasing a late payment, built live in the hero
-- **Sections** · Hero · Showcase · Steps · Rows (pricing) · Band · Footer
+- **Sections** · Hero (the invoice list) · Pinned (one late payment, chased in three panels) · Switcher (the client's view and yours) · Table (pricing) · Footer
- **Material** · real: the 2-minute setup, the CSV import, Lisbon · pictures: the invoice list built in the hero, library photos of a Lisbon studio (muted) · absent: logos, quotes, metrics
- **Sweep** · run after build
```
@@ -127,7 +129,7 @@ A custom run's rows are in `direction.md`. Then one quiet line, skipped in compo
- **Start from the scaffold.** `node <skill-dir>/scripts/theme.mjs scaffold <slug>` (with the deal's `--dealt`; `--custom` on a custom run) writes `tokens.css` (the theme's tokens and the shared scale) and `base.css` (what the Floor already decided) beside the project's stylesheet, and prints the stamp skeleton, the two imports and the slot script. Write only the page.
- **Read [`references/patterns.md`](references/patterns.md) once:** controls in all eight states, a slot, a missing fact, a form that posts nowhere yet, one reveal, figures that compare. Take their shape, never their copy.
- **Hero first.** Write the nav and the hero, run `node <skill-dir>/scripts/sloplint.mjs <file> --render --stage hero`, then the hero review in fresh context (`gates.md` § 6). Build the sections once the hero ships.
-- **One idea per screen, set big.** Hero: a headline of seven words or fewer (50 characters), one sentence of twelve words or fewer, one or two actions. Six to nine sections, hero and footer included (five on a thin brief), 450 visible words at most, each a head block and a composition with mass (`layout.md` § 4 and § 5). The hero is the first screen and only the first screen, its visual beside the text (`layout.md` § 6). Fullness comes from scale and pictures, never from more words (77 to 79).
+- **One idea per screen, set big.** Hero: a headline of seven words or fewer (50 characters), one sentence of twelve words or fewer, one or two actions. Six to nine sections, hero and footer included (five on a thin brief), 450 visible words at most, each a piece of the category's own content in a composition with mass (`layout.md` § 4 and § 5). The hero is the first screen and only the first screen, its posture taken from the job (`layout.md` § 6). Fullness comes from scale and pictures, never from more words (77 to 79).
- **Show, do not describe** (`imagery.md`). The page shows the real thing: the user's pictures, screenshots of the real product taken with `scripts/capture.mjs` whenever it can be reached, the product built at full fidelity only when it cannot, or library photographs (`node <skill-dir>/scripts/theme.mjs photos "<subject>" --theme <slug>`), big, in the theme's treatment, in slots the user's files replace, each library photo credited in the footer. Pictures take at most a third of the page below the hero, never two photograph-led sections in a row, and the theme's Range carries the rest (83). Never a stock-site URL, a drawn illustration (80), an empty wash (81), a row of counting marks (82) or an invented figure.
- **Page invariants** (F15): one primary button style, one container width, one column gap below the hero, one radius per nesting level, never more centred heading groups than left-aligned ones.
- **Type and motion** (`craft.md` § 1 and § 5). The theme's faces, two families at most (three with one outlier role); body 16px or more; heads one weight and one colour (38iii); labels never mono unless mono is the material (64). Eight states on every control; `transform` and `opacity` only; one reveal at most, none where the theme keeps still, visible by default.
diff --git a/skills/hallmark/references/anatomy.md b/skills/hallmark/references/anatomy.md
new file mode 100644
index 0000000..1c761cf
--- /dev/null
+++ b/skills/hallmark/references/anatomy.md
@@ -0,0 +1,71 @@
+# Anatomy
+
+What a page is built around, by the visitor's job. Read the one job the brief names at Step 2, before the shape: it sets where the action lives, which sections are the category's own, and how the page ends. The theme dresses this anatomy; the shape orders it; neither replaces it. Drawn from the homepages of about fifty real independent sites across these jobs; the pattern Hallmark slipped into (text beside a picture, a figure row, three steps, an email band) is how software pages look and almost nothing else.
+
+**When the brief gives none of a section's content,** build it as a sample the user replaces, the way the product is built when it cannot be captured (`imagery.md` § 4): an example issue with its parts, dishes typical of the cuisine, three candles named plainly, track titles as placeholders, each marked in the handoff. A sample shows the shape of the real thing; it never states a fact a visitor could take as true (a price, a date, a person's name, a count, a review). A section whose whole content would be facts nobody gave (a lineup, a tour) is one line and a text slot, or it waits.
+
+Every job: the nav carries the job's own action word (Book, Tickets, Shop, Listen, Start free), the hero shows the thing itself (the room, the cover, the dates, the screen), and proof comes in the category's own form, never a generic band of numbers.
+
+## subscribe (a newsletter, a waitlist, a podcast)
+
+- **Action:** in the hero, and often it is the hero: the name, one line, the email field. A podcast puts the latest episode with its play control under it.
+- **Sections:** a sample issue or the latest one, set as it arrives; who writes it; the archive as an Index of issues or episodes with dates; the reader count only if given, set like a circulation figure under the masthead.
+- **Ends:** a second field under the archive, or the archive itself. The one job whose close may be an email field.
+
+## book (a restaurant, a class, a clinic, a studio)
+
+- **Action:** a booking picker (party, date, time) opened from the nav and the hero, or the next free times as buttons; repeated beside the menu or the classes, never only at the foot.
+- **Sections:** the room or the food as a photograph with little or no head; the menu (a Switcher by lunch and dinner, or rows with prices); for classes the timetable as a Schedule; how to find it; hours and address as a section of their own.
+- **Ends:** hours, address and the booking again. A fine room may have almost nothing: one photograph, the menu, the booking.
+
+## visit (a shop, a gallery, a venue, a place)
+
+- **Action:** today's hours and the address, in the nav or the hero; tickets or donate only if the brief has them.
+- **Sections:** what is on now as the lead picture; what is coming as dated rows (an Index or a Schedule, a This week and Next week switch); for a shop, the shelves (a Rail or a Grid of the brief's own things); getting there.
+- **Ends:** visit information and the address, or the mailing list for what is on next.
+
+## attend (an event, a festival, a race, a conference)
+
+- **Action:** tickets in the nav from the first screen; the date and the place are the headline.
+- **Sections:** the lineup or the speakers (an Index or a dense Grid, the names set large); the days as a Schedule; ticket tiers with prices; the venue and travel; questions. Figures (stages, acts, miles) only when the brief gives them.
+- **Ends:** tickets again, the questions, or the mailing list for the next edition. Between editions the whole page is the date, the place and the list.
+
+## buy (a physical product, a small shop)
+
+- **Action:** the product with its price and options (an Offer), often as the hero; a buy action after the sections that earn it, or a sticky bar with the price.
+- **Sections:** the range as tiles or a Rail with prices; the product in use, close; how it is made; delivery and the guarantee as plain facts; reviews only if given.
+- **Ends:** the offer again, new arrivals, or the guarantee. An email field belongs in the footer, not as the close.
+
+## try (an app, a game, a desktop tool)
+
+- **Action:** the store or download buttons right under the head, one per platform the brief names.
+- **Sections:** the key art, trailer or main screen captured from the product (`imagery.md` § 4); features as named moments shown in screens (a Pinned run or a Switcher), not icon tiles; a before and after where the product changes something; platforms.
+- **Ends:** the download again beside one last screen. Games are short: five or six blocks is a full page.
+
+## sign up (software, an API, a developer tool)
+
+- **Action:** start free in the nav and the hero with its terms in one line under it; for a developer tool the install command may be the action.
+- **Sections:** the product at work (captured or built); what it does as named moments; a code sample or the integration; the pricing table with its period switch; questions.
+- **Ends:** the hero's action again in a short band, or the code sample. Never a newsletter.
+
+## hire (a studio, a freelancer, an architect)
+
+- **Action:** a plain contact (an email, a phone, "Talk to us") in the nav and once more after the work; no form needed.
+- **Sections:** the work as the page: a list or Index of projects (name, client, year, place) with pictures, one opened as a case; what the studio does as a short list; where it is.
+- **Ends:** contact details, per office if there are several.
+
+## join (a club, a community, a membership)
+
+- **Action:** join or "your first visit" in the hero.
+- **Sections:** what a session is like, shown; when and where as a Schedule or a list of places; membership options as rows with prices; first-visit guidance; people in the brief's own pictures only.
+- **Ends:** the first visit, the membership options, or a sign-up field.
+
+## listen (a band, a film, a podcast, a publication)
+
+- **Action:** the new release or current issue with its listen, watch or order buttons side by side.
+- **Sections:** the record, film or issue (its cover, its tracks or contents as an Index); dates (tour, screenings) as rows with ticket links; earlier work as covers in a Rail or Grid; videos.
+- **Ends:** the dates, more of the catalogue, or the mailing list. Artist pages can be very short: one picture, the release, the dates.
+
+## How pages end
+
+In the order real sites use them: the hero's action again in a short band; practical details (hours, address, contacts); more of the catalogue (the archive, new arrivals, more work); a short trust tail (a guarantee, press, awards the brief gives); a mailing list, for things that recur (issues, editions, releases, events). The last is one close in five, never the default (85).
diff --git a/skills/hallmark/references/gates.md b/skills/hallmark/references/gates.md
index aaee761..a62ec82 100644
--- a/skills/hallmark/references/gates.md
+++ b/skills/hallmark/references/gates.md
@@ -112,6 +112,7 @@ One line each. `a`/`b` clauses share a number and carry their own tier. Genre no
| 82 | Reflex | R | The counting device: 24 or more identical marks (ticks, dots, bars, squares) standing for a quantity, one for each bottle, identity or day. Guard: a chart whose marks differ in value or colour | set the number in type |
| 83 | Reflex | R | The photo wall: below the hero, photographs cover more than about a third of the page at 1440 (45% on a Photographic or Portfolio Grid shape), so it reads as a stock gallery. Guard: a gallery or portfolio of the user's own work | keep the strongest pictures, set big; carry the rest in the theme's material: type, figures, the product, a table (`imagery.md` § 5) |
| 84 | Reflex | J | The fake product: the page shows a built mock of a product that exists and could be reached (a URL, a running dev server, a project in the folder, an app on the machine), or a drawn interface where a screenshot belonged. Guard: the product does not run yet, or capturing it would show private data | run it, put it in a telling state and capture it with `scripts/capture.mjs` or the OS; frame the captures in the theme (`imagery.md` § 4) |
+| 85 | Reflex | R | The stock close: the last section before the footer, or the footer, is an email sign-up (a form of one or two fields, one an email) on a page whose job is not one where a mailing list is native (subscribe, join, attend, listen, visit), or whose stamp names no `job:`. Guard: the user asked for a sign-up | end on what the visitor came to do, in the form the job takes (the booking, the buy box, the download, the next date and the address, the latest issue), or on the last strong section (`anatomy.md`) |
### Chrome and copy
@@ -231,6 +232,8 @@ The gates above that a script cannot settle, with enough to judge them well.
**84, the fake product.** Ask where the product is before building one. A brief that names an app, a site or a tool that exists, a folder holding its code, or a URL means the page shows captures of it: the main screen, a detail, a second screen, the phone view. A built mock is right only for a product not built yet, and its handoff names the screens to capture later.
+**85 and the stock anatomy.** The close is the visible part of a deeper habit: hero beside a picture, a figure row, three steps, a split, a showcase, an email band. Judge the whole page against `anatomy.md`: is the job's action where real sites in the category put it, are the category's own sections here (the menu, the lineup, the issues, the record), and could this exact sequence of sections sit under a different business's name? If it could, the page has no anatomy of its own yet.
+
## 6. The reviews, in fresh context
The thread that built the page is its weakest reviewer. Two reviews run with no inherited transcript (a subagent in Claude Code): the **hero review** once at Step 6, before any section below the fold exists, and the **finish review** at Step 7. When a subagent can run them, do not read their briefs yourself: start the reviewer with *Read `<skill-dir>/references/review-hero.md` (or `review-finish.md`) and follow it* and pass these, files as paths and lines as quoted text. The hero review: the four `hero-*` screenshots, the stamp's first two lines, the Picks block's Material and Signature rows, the theme's picture. The finish review: the render tier's screenshots, the page's HTML or component source, the stamp's theme or idea line, the theme file and its picture, the hero review's findings with how each was settled, `gates.md` § 4, and on a redesign the `before` screenshots. Run it in the foreground, since the build waits on its first word (in Claude Code, `run_in_background: false`), never behind a timer or a wake-up.
diff --git a/skills/hallmark/references/layout.md b/skills/hallmark/references/layout.md
index 81a6c9d..ab3132f 100644
--- a/skills/hallmark/references/layout.md
+++ b/skills/hallmark/references/layout.md
@@ -34,11 +34,11 @@ The scaffold writes these tokens and `base.css` sets them on the elements. A the
## 4. A section
-Every section below the hero is a **head block** and a **body**, the body one of the compositions in § 5. The head block sits above the body, inside a split's text column, or beside rows.
+A section is one piece of the page's content shown at its best: the menu, the lineup, the latest issue, the product at work, the room, the price. Decide the content first, then the composition that shows it best. Most sections carry a **head block** above or beside a **body** from § 5; a section whose content names itself (a menu, a timetable, a track list, a list of issues, the product's own screen) may go without one, or carry its head inside the content (the menu's own title, the date over the lineup). Never more than two neighbours with the same skeleton: a page of head-then-block, head-then-block reads as a template however good each block is. What real sites in each category are built around is in `anatomy.md`.
- **The head block:** an `h2` of six words or fewer at `--text-section` (a staged shape may head each stage with its one-word name), at most one line at `--text-lead` beneath it, on columns 1 to 6 or 1 to 7, or split (head on 1 to 5, the line on 7 to 12, baselines aligned). Centred only over a symmetric body, and never more centred head blocks than left-aligned ones.
- **The body fills the width:** its widest row reaches ten of the twelve columns (77). A narrow text block with the right half empty is the sparse page's signature; pair it with a visual, split it, or set it as a statement.
-- **The body has mass:** a visual 360px tall or more; a set of three or four items across the width; a list or table of three or more rows across ten columns; or a statement at `--text-section` or larger. A head and a paragraph are a head block, never a section.
+- **The body has mass:** a visual 360px tall or more; a set of three or four items across the width; a list or table of three or more rows across ten columns; a working control on the brief's own facts; or a statement at `--text-section` or larger. A head and a paragraph are a head block, never a section.
- **A split balances:** text and visual centre on each other within 60px, and neither column leaves more than a fifth of the row empty.
- **Content sets the height:** usually 520 to 900px; under 360px only for a band (a call to action, a logo row, a statement), at most twice a page.
@@ -55,23 +55,31 @@ Layouts, not components: build each in the theme's material and the brief's cont
7. **Figures.** Three or four real numbers at `--text-display-s`, labels beneath, across the twelve columns, parted by vertical hairlines. Only figures the user gave (46a).
8. **Steps.** Three or four stages across, each a numeral (a real `<ol>`, never a `01` label over a head, 54), a title and a line, with a visual beneath or beside where the material has one; or a vertical run with a visual per stage on a fixed side.
9. **Statement.** One sentence filling eight to ten columns in two or three lines, from `--text-section` up to `--text-display` (a condensed or light face takes the larger step), with its attribution or one action; once a page.
-10. **Band.** A change of paper (`--color-paper-2`, the ink, or a field of the accent where the posture allows) edge to edge, the container inside: a head at `--text-section` with one line on columns 1 to 7, the action or a form on 8 to 12. The close of most pages.
+10. **Band.** A change of paper (`--color-paper-2`, the ink, or a field of the accent where the posture allows) edge to edge, the container inside, holding whatever the page's job wants there: the next free table times, the buy box, the store buttons beside a screen, the next date and the address. Never an email field by default (85).
11. **Form.** The fields on six or seven columns beside the head block and two to four facts, inputs 48 to 56px tall, one primary action.
+12. **Rail.** A horizontal run past the container's edge (dates, issues, products, rooms, episodes), five or more items with the next one cut by the edge, scrollable by touch and keyboard, snap points, no arrows needed past two.
+13. **Pinned.** One visual held sticky on six or seven columns while three or four short panels scroll past it on the other side, each changing what the visual shows (a state, a crop, a step); static under 60rem.
+14. **Switcher.** One area with two to five states behind a segmented control: the menu by lunch and dinner, the plans by month and year, the app on phone and watch, the schedule by day. Every state real; the first visible without script.
+15. **Index.** A dense, scannable list of the brief's own items with their facts in columns (issues with dates and topics, projects with year and client, episodes with length, lots with estimates), optionally filtered; 6 to 20 rows, the lead row larger.
+16. **Schedule.** Time against place or day: a two-day festival as two columns of acts and times, a week of classes, opening hours as a strip; the current or next slot marked.
+17. **Offer.** The thing for sale with what a buyer needs at the moment of buying: the photograph or screen, the options (size, scent, plan), the price, the action and one line of delivery or terms. On a buy page it is often the hero.
-Under 60rem every composition stacks in reading order: the head block, then the body; a split's visual after its text; a grid two across, then one under 40rem; a bento's lead tile first. Visuals keep their aspect ratio and lose their minimum height; nothing scrolls sideways except a table that says so (`responsive.md`).
+Under 60rem every composition stacks in reading order: the head block, then the body; a split's visual after its text; a grid two across, then one under 40rem; a bento's lead tile first; a rail stays a rail; a pinned pair unpins; a schedule turns into one column per day. Visuals keep their aspect ratio and lose their minimum height; nothing scrolls sideways except a rail or a table that says so (`responsive.md`).
## 6. The hero
-The first screen at 1440 x 900 and 1920 x 1080, and only the first screen (44c). Pick a posture at Step 2, stamp it, and vary it run to run.
+The first screen at 1440 x 900 and 1920 x 1080, and only the first screen (44c). Pick a posture at Step 2 from the job (`anatomy.md`), stamp it, and vary it run to run; text beside a picture (Settled, Stage) is the most common generated hero, so take it only when the picture is the strongest thing the brief has.
| Posture | Height | Content |
| --- | --- | --- |
-| **Settled** (default) | fills the screen under the nav | centred in the screen; the text on six columns, the visual on the other six |
+| **Settled** | fills the screen under the nav | centred in the screen; the text on six columns, the visual on the other six |
| **Stage** | fills the screen under the nav | the text on five columns, a visual on seven at 60 to 75% of the screen tall (reversed when a poster-size head needs the width); it may bleed off the outer edge |
| **Banner** | 50 to 60% of the screen | the first section shows above the fold; for references, docs, utilities |
| **Ledge** | fills the screen | a tall field above, the head resting at the base; at 1920 the head grows to its cap first |
| **Corridor** | fills the screen | one centred column of 44ch or less, the head larger than usual |
| **Poster** | 92 to 100dvh | a full-bleed photograph or canvas, the content on its calmest part with room around it, low and left or centred, never squeezed into a corner |
+| **Counter** | fills the screen under the nav | the action is the visual: the subscribe field with the latest issue, the booking times, the buy box with its options, the download with the screen, set large beside or under a shorter head |
+| **Index** | fills the screen under the nav | the content is the visual: the lineup, the menu, the list of issues or projects, set as the page's lead with the head small above it; for pages whose list is the reason to come |
- **Centred in its screen.** For Settled, Stage, Banner and Corridor the space under the content is 1.0 to 1.5 times the space above it (44a), and the lowest content sits within 160px of the fold (79). Spend spare height on a larger visual or larger type, never on copy.
- **The visual is big:** six or seven columns wide and 60% of the screen tall or more (520px at 1440 x 900), or a portrait object (a cover, a phone, a bottle) at 75% tall on four or five columns; its centre within 60px of the text block's. The hero grid is two tracks (`6fr 5fr`, `5fr 7fr`) with its own gap of `--space-2xl` to `--space-3xl`, so text and visual stand 48 to 120px apart; spans on the twelve columns leave an empty column between them. Under 60rem the gap becomes a row gap of `--space-xl`. What it shows is `imagery.md` § 1; a working form is a section or a close, not the default hero.
@@ -80,13 +88,16 @@ The first screen at 1440 x 900 and 1920 x 1080, and only the first screen (44c).
## 7. The page
+- **The job decides the anatomy** (`anatomy.md`): where the action lives (in the hero, sticky, repeated beside the content, at the close), and which category-native sections the page is built around. A newsletter puts the subscribe field in the hero and shows the issues; a restaurant shows the menu and the booking; a band shows the record and the dates. The theme dresses that anatomy; it never replaces it.
- **Order follows the argument the shape makes** (`macrostructures.md`), never hero, three features, a call to action and a footer (8). Lead with the strongest real thing after the hero; put each fact where it does work.
-- **Variety:** never the same composition in neighbouring sections (a one-composition shape aside); mirror a split once at most, never a zigzag; one full-width visual at least on a product page; one or two bands. Read the log's `sections`: a Statement and a closing Band are the easiest reaches, so when the last build used either, make that beat another way.
+- **Not every page has steps or figures.** Steps only for a process the visitor really goes through (booking, joining, getting a festival ticket); a figure row only for three numbers the brief states outright, never one derived from it (365 mornings from "every day"). Together they appear on most generated pages; on a made page they are a choice.
+- **Variety:** never the same composition in neighbouring sections (a one-composition shape aside); mirror a split once at most, never a zigzag; one full-width visual at least on a product page; one or two bands. Read the log's `sections`: a Statement, Steps, Figures and a closing Band are the easiest reaches, so when the last build used one, make that beat another way.
- **Balance:** photographs take a quarter to a third of the page below the hero (83), and never lead two sections in a row; the sections between are built from the theme's material (its Range: type, figures, rules, the product, a table, a form). `imagery.md` § 5 has the counts.
-- **Pace:** a dense section (a grid, a table, a bento) is followed by a quiet one (a statement, a showcase); the page ends on a real close.
+- **Pace:** a dense section (a grid, a table, a bento, an index) is followed by a quiet one (a statement, a showcase); the page ends on a real close.
+- **The close is the job, not a form.** End on what the visitor came to do, in the form the job takes (the next times to book, the buy box, the store buttons, the next date and the address, the latest issue), or simply on the last strong section and the footer. An email field closes a page only when the job is one where a mailing list is native (subscribe, join, attend, listen, visit) and the anatomy calls for it, or the user asked for one (85); a page whose action already sits in the hero or a sticky bar need not repeat it at the foot.
- **The footer closes the page:** 200 to 400px: the wordmark or one closing line, the page's real links, the legal line. A single line under a hairline is a colophon, right for a letter, a document or a manifesto.
- **The nav is one line, 56 to 80px tall**, sized to the page's real destinations. Vary it against the log: edge-aligned (wordmark and one or two links or an action at opposite edges), a floating pill, a masthead (a large centred wordmark over a rule), a slab (a heavy full-width bar), a search-led bar with a visible command pill, a banner over a bar that retracts on scroll, a three-part bar only for four or more real destinations (42). A side rail only where a sticky object earns it.
-- **Footers:** a mast (the wordmark large over the links), a statement (one closing sentence large, the links beneath), a colophon block (credits and address as one paragraph), newsletter-first (the form leads), a letter close (a sign-off and a date), index columns only for a hub with a real sitemap.
+- **Footers:** a mast (the wordmark large over the links), a statement (one closing sentence large, the links beneath), a colophon block (credits and address as one paragraph), newsletter-first (the form leads; only for a subscribe page), a letter close (a sign-off and a date), index columns only for a hub with a real sitemap.
## 8. Before shipping
diff --git a/skills/hallmark/references/patterns.md b/skills/hallmark/references/patterns.md
index 91812a0..c2144d4 100644
--- a/skills/hallmark/references/patterns.md
+++ b/skills/hallmark/references/patterns.md
@@ -55,6 +55,28 @@ The `<img>` comes from `theme.mjs photos`; `base.css` supplies the cover fit, th
The radios stay in the flow at one pixel (53); the label carries the state and the ring, in the body face, sentence case.
+## A rail and a switcher
+
+```html
+<ul class="rail" tabindex="0" aria-label="Upcoming dates">
+ <li><time datetime="2027-06-12">12 June</time> Whitby</li>
+ <!-- five or more items; the next one cut by the edge -->
+</ul>
+<div class="switch" data-switch>
+ <div class="seg" role="tablist" aria-label="Menu"><button role="tab" aria-selected="true" aria-controls="m1" id="t1">Lunch</button><button role="tab" aria-selected="false" aria-controls="m2" id="t2" tabindex="-1">Dinner</button></div>
+ <section role="tabpanel" id="m1" aria-labelledby="t1">...</section>
+ <section role="tabpanel" id="m2" aria-labelledby="t2" hidden>...</section>
+</div>
+```
+
+```css
+.rail { display: grid; grid-auto-flow: column; grid-auto-columns: minmax(16rem, 22%); gap: var(--gap-columns); overflow-x: auto; scroll-snap-type: x mandatory; scroll-padding-inline: var(--gutter); padding-inline: var(--gutter); overscroll-behavior-x: contain; }
+.rail > * { scroll-snap-align: start; }
+.rail:focus-visible { outline: 2px solid var(--color-focus); outline-offset: 4px; }
+```
+
+The rail scrolls by touch, wheel and arrow keys once focused, and sits outside the container's padding so its edge cuts the next item. The switcher's tabs move with the arrow keys (a few lines of script set `aria-selected`, `tabindex` and `hidden`); without script every panel shows in order. A pinned pair is `position: sticky; top: var(--space-2xl)` on the visual's column, released under 60rem.
+
## A fact the brief did not give
```html
diff --git a/skills/hallmark/scripts/sloplint-render.mjs b/skills/hallmark/scripts/sloplint-render.mjs
index 0fb35a1..a72b779 100644
--- a/skills/hallmark/scripts/sloplint-render.mjs
+++ b/skills/hallmark/scripts/sloplint-render.mjs
@@ -70,7 +70,7 @@ async function shoot(page, file, tag, fullPage) {
export async function renderCheck(htmlFiles, metaIn) {
const failed = [];
- const meta = { genre: null, postureByFile: {}, heroPostureByFile: {}, photoShapeByFile: {}, stage: 'page', scope: 'page', before: false, ...(metaIn || {}) };
+ const meta = { genre: null, postureByFile: {}, heroPostureByFile: {}, photoShapeByFile: {}, jobByFile: {}, stage: 'page', scope: 'page', before: false, ...(metaIn || {}) };
const heroOnly = meta.stage === 'hero';
SHOT_DIR = meta.before ? 'before' : 'shots';
const inventories = {};
@@ -140,9 +140,10 @@ export async function renderCheck(htmlFiles, metaIn) {
meta.postureByFile[file] = (/posture:\s*(restrained|committed|full-palette|drenched)/i.exec(stamp)?.[1] || 'restrained').toLowerCase();
const field = (/hero:\s*([^·*\n]+)/i.exec(stamp) || [])[1] || '';
let route = ''; try { route = new URL(file).pathname.replace(/\/$/, '') || '/'; } catch {}
- const own = new RegExp(`(settled|banner|poster|ledge|corridor|stage)\\s*\\(${route.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\)`, 'i').exec(field);
+ const own = new RegExp(`(settled|banner|poster|ledge|corridor|stage|counter|index)\\s*\\(${route.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\)`, 'i').exec(field);
meta.photoShapeByFile[file] = /shape:\s*(photographic|portfolio)/i.test(stamp);
- meta.heroPostureByFile[file] = /theme:\s*custom\b/i.test(stamp) ? 'custom' : ((own || /(settled|banner|poster|ledge|corridor|stage)\b/i.exec(field) || [])[1] || '').toLowerCase();
+ meta.jobByFile[file] = ((/\bjob:\s*([a-z][a-z /-]*)/i.exec(stamp) || [])[1] || '').trim().toLowerCase();
+ meta.heroPostureByFile[file] = /theme:\s*custom\b/i.test(stamp) ? 'custom' : ((own || /(settled|banner|poster|ledge|corridor|stage|counter|index)\b/i.exec(field) || [])[1] || '').toLowerCase();
}
const pageMeta = { genre: meta.genre, posture: meta.postureByFile[file] || 'restrained' };
const prefix = heroOnly ? 'hero-' : '';
@@ -177,7 +178,7 @@ export async function renderCheck(htmlFiles, metaIn) {
await shoot(page, file, '1440-full', true);
}
await frames(page);
- const res = await page.evaluate(observeSpace, w === 1440, heroOnly, meta.heroPostureByFile[file] || '', !!meta.photoShapeByFile[file]);
+ const res = await page.evaluate(observeSpace, w === 1440, heroOnly, meta.heroPostureByFile[file] || '', !!meta.photoShapeByFile[file], meta.jobByFile[file] || '');
for (const f of res) findings.push({ ...f, file, line: 1, evidence: `[${w}px] ${f.evidence}` });
}
if (!heroOnly) {
@@ -705,7 +706,7 @@ function lineBreaks() {
return out;
}
-function observeSpace(atLaptop, heroOnly, heroPosture, photoShape) {
+function observeSpace(atLaptop, heroOnly, heroPosture, photoShape, job) {
const freeFold = /^(poster|ledge|banner|custom)$/.test(heroPosture || '');
const out = [];
const push = (gate, grade, evidence, fix) => out.push({ gate: String(gate), grade, evidence, fix });
@@ -883,6 +884,13 @@ function observeSpace(atLaptop, heroOnly, heroPosture, photoShape) {
const share = area / Math.max(1, (docH - from) * cw);
if (share > (photoShape ? 0.45 : 0.36) && n >= 3) push(83, 'REFLEX', `photographs cover ${Math.round(share * 100)}% of the page below the hero (${n} pictures${photoShape ? ', a photograph-led shape' : ''})`, 'Balance the page: cut or shrink pictures until they cover a quarter to a third of it, and carry the freed sections in type, figures, the product or a list (imagery.md § 5)');
}
+ if (heroEnd != null && !/subscribe|join|attend|listen|visit|newsletter|waitlist/.test(job || '')) {
+ const foot = [...document.querySelectorAll('body footer, [role="contentinfo"]')].filter(vis).pop();
+ const before = foot ? secs.filter((x) => x !== foot && abs(x).bottom <= abs(foot).top + 2).pop() : secs[secs.length - 1];
+ const signup = (box) => box && [...box.querySelectorAll('form, [role="form"]')].find((f) => { const fields = [...f.querySelectorAll('input:not([type=hidden]):not([type=submit]):not([type=checkbox]):not([type=radio]), textarea, select')].filter(vis); return fields.length >= 1 && fields.length <= 2 && fields.some((x) => x.type === 'email' || /e-?mail/i.test(`${x.name} ${x.id} ${x.placeholder} ${x.getAttribute('autocomplete') || ''}`)); });
+ const hit = signup(before) || signup(foot);
+ if (hit) push(85, 'REFLEX', `the page closes on an email sign-up${job ? ` on a ${job} page` : ' and the stamp names no job'}`, 'End on what the visitor came to do (the booking, the buy box, the download, the next date, the latest issue) or on the last strong section; an email close is for a subscribe or join page, and the stamp says job: (anatomy.md)');
+ }
let heroFoot = null;
if (hero && !/^(poster|ledge)$/.test(heroPosture || '')) {
diff --git a/skills/hallmark/scripts/sloplint.mjs b/skills/hallmark/scripts/sloplint.mjs
index 7beb86f..12d7629 100644
--- a/skills/hallmark/scripts/sloplint.mjs
+++ b/skills/hallmark/scripts/sloplint.mjs
@@ -791,7 +791,7 @@ const trunc = (s, n = 72) => (s.length > n ? s.slice(0, n - 1) + '…' : s);
const PAGE_ONLY = new Set(['3', '8', '9', '25', '28', '32', '34', '42', '44', '46b', '47b', '47c', '49', '50', '54', '55', '56', '58', '59', '65', '66', '68', '69', '71', '77', '78', '79', '80', '81', '82', '83', 'F7', 'F8', 'F15', 'F16', 'F20']);
const gateNumber = (id) => (/^(\d{1,2})/.exec(String(id)) || [])[1] || null;
const pageOnly = (id) => PAGE_ONLY.has(String(id)) || PAGE_ONLY.has(gateNumber(id));
-const APP_SKIP = new Set(['1', '6', '8', '9', '32', '42', '44', '46b', '58', '59', '66', '68', '77', '78', '79', '81', '82', '83', 'F8', 'F15', 'F20']);
+const APP_SKIP = new Set(['1', '6', '8', '9', '32', '42', '44', '46b', '58', '59', '66', '68', '77', '78', '79', '81', '82', '83', '85', 'F8', 'F15', 'F20']);
const appSkip = (id) => APP_SKIP.has(String(id)) || APP_SKIP.has(gateNumber(id));
const TIERS = new Map(Object.entries({
@@ -810,7 +810,7 @@ const TIERS = new Map(Object.entries({
'39a': 'floor', '39b': 'reflex', '44a': 'reflex', '44b': 'floor', '44c': 'reflex', '44d': 'floor',
'46a': 'floor', '46b': 'reflex', '47a': 'floor', '47b': 'reflex', '47c': 'reflex', '49a': 'floor', '49b': 'reflex',
'55a': 'floor', '55b': 'reflex', '71': 'reflex', '72': 'reflex', '73': 'floor', '74': 'reflex', '75': 'reflex', '76': 'floor',
- '77': 'reflex', '78': 'reflex', '79': 'reflex', '80': 'reflex', '81': 'reflex', '82': 'reflex', '83': 'reflex', '84': 'reflex',
+ '77': 'reflex', '78': 'reflex', '79': 'reflex', '80': 'reflex', '81': 'reflex', '82': 'reflex', '83': 'reflex', '84': 'reflex', '85': 'reflex',
}));
const HERO_SKIP = new Set(['8', '9', '32', '59', '77', '78', 'F8', 'F15']);
@@ -4045,6 +4045,7 @@ const waiversByKey = new Map();
const postureByFile = {};
const heroPostureByFile = {};
const photoShapeByFile = {};
+const jobByFile = {};
const contexts = [];
const parsedDocs = new Map();
const docOf = (f) => {
@@ -4093,9 +4094,10 @@ function buildContext(key, cssList, docList) {
].join('\n');
const posture = (/posture:\s*(restrained|committed|full-palette|drenched)/i.exec(stampText)?.[1] || 'restrained').toLowerCase();
// a custom page designs its own hero: 44a and 44c read it as free
- const heroPosture = /theme:\s*custom\b/i.test(stampText) ? 'custom' : (/hero:\s*(settled|banner|poster|ledge|corridor|stage)\b/i.exec(stampText)?.[1] || '').toLowerCase();
+ const heroPosture = /theme:\s*custom\b/i.test(stampText) ? 'custom' : (/hero:\s*(settled|banner|poster|ledge|corridor|stage|counter|index)\b/i.exec(stampText)?.[1] || '').toLowerCase();
const photoShape = /shape:\s*(photographic|portfolio)/i.test(stampText);
- for (const d of docs) { postureByFile[d.file] = posture; heroPostureByFile[d.file] = heroPosture; photoShapeByFile[d.file] = photoShape; }
+ const job = ((/\bjob:\s*([a-z][a-z /-]*)/i.exec(stampText) || [])[1] || '').trim().toLowerCase();
+ for (const d of docs) { postureByFile[d.file] = posture; heroPostureByFile[d.file] = heroPosture; photoShapeByFile[d.file] = photoShape; jobByFile[d.file] = job; }
const allCss = cssFiles.map((c) => c.raw).join('\n') + '\n'
+ docs.map((d) => d.styles.map((st) => st.css).join('\n')).join('\n');
const tokensOnly = !docs.length && rules.length > 0 && rules.every(isTokenRule);
@@ -4144,7 +4146,7 @@ if (opts.render) {
if (!htmlFiles.length && !opts.urls.length) renderNotRun = 'no HTML page to render; pass --url for a running dev server';
else try {
const mod = await import(new URL('./sloplint-render.mjs', import.meta.url).href);
- const extra = await mod.renderCheck([...htmlFiles, ...opts.urls], { genre: opts.genre, postureByFile, heroPostureByFile, photoShapeByFile, stage: opts.stage, selectors: opts.before || opts.kept ? Object.fromEntries([...new Set(contexts.flatMap(([, c]) => c.docs))].filter((d) => d.kind === 'html').map((d) => [d.file, scriptSelectors(d)])) : {}, scope: opts.scope === 'app' || [...waiversByKey.values()].some((x) => x.APPSCREEN) ? 'app' : opts.scope, before: opts.before });
+ const extra = await mod.renderCheck([...htmlFiles, ...opts.urls], { genre: opts.genre, postureByFile, heroPostureByFile, photoShapeByFile, jobByFile, stage: opts.stage, selectors: opts.before || opts.kept ? Object.fromEntries([...new Set(contexts.flatMap(([, c]) => c.docs))].filter((d) => d.kind === 'html').map((d) => [d.file, scriptSelectors(d)])) : {}, scope: opts.scope === 'app' || [...waiversByKey.values()].some((x) => x.APPSCREEN) ? 'app' : opts.scope, before: opts.before });
domInventories = extra.inventories || {};
const allWaivers = { WAIVED: new Set([...waiversByKey.values()].flatMap((x) => [...x.WAIVED])), ANSWERED: new Set([...waiversByKey.values()].flatMap((x) => [...x.ANSWERED])), DISMISSED: new Set([...waiversByKey.values()].flatMap((x) => [...(x.DISMISSED || [])])), VERBATIM: [...waiversByKey.values()].some((x) => x.VERBATIM), APPSCREEN: [...waiversByKey.values()].some((x) => x.APPSCREEN), LAYOUT_KEPT: [...waiversByKey.values()].map((x) => x.LAYOUT_KEPT).find(Boolean) || false };
for (const f of extra) {
diff --git a/skills/hallmark/scripts/theme.mjs b/skills/hallmark/scripts/theme.mjs
index 90c5287..cd1da66 100644
--- a/skills/hallmark/scripts/theme.mjs
+++ b/skills/hallmark/scripts/theme.mjs
@@ -13,7 +13,7 @@ const args = process.argv.slice(2);
const cmd = args[0];
const flag = (k, d = null) => { const i = args.indexOf('--' + k); const v = i >= 0 ? args[i + 1] : undefined; return v !== undefined && !String(v).startsWith('--') ? v : d; };
const has = (k) => args.includes('--' + k);
-const VALUED = new Set(['genre', 'brief', 'log', 'n', 'reroll', 'dealt', 'dir', 'axes', 'face', 'hue', 'entry', 'redesign', 'theme', 'orient', 'save', 'avoid', 'material', 'seed']);
+const VALUED = new Set(['genre', 'brief', 'log', 'n', 'reroll', 'dealt', 'dir', 'axes', 'face', 'hue', 'entry', 'redesign', 'theme', 'orient', 'save', 'avoid', 'material', 'seed', 'job']);
const positional = () => { const out = []; for (let i = 1; i < args.length; i++) { const a = args[i]; if (a.startsWith('--')) { if (VALUED.has(a.slice(2))) i++; continue; } out.push(a); } return out; };
const GENRES = ['editorial', 'modern-minimal', 'atmospheric', 'playful'];
// A theme slug names a file in references/themes, so it is a plain name, never a path.
@@ -25,7 +25,7 @@ function usage() {
node theme.mjs scaffold <slug> [--dealt "<n>/3, seed <seed>"] [--redesign polish|restyle|full] [--scope app] [--dir <beside the stylesheet>] [--force]
node theme.mjs scaffold --custom | --brand [--redesign polish|restyle|full] [--scope app] [--dir <beside the stylesheet>] [--force]
node theme.mjs check [--axes "<paper>/<display>/<accent>"] [--face "<display face>"] [--hue <accent hue>] [--log .hallmark/log.json]
- node theme.mjs draw --material photo|product|words [--theme <slug>] [--log .hallmark/log.json] [--seed <hex>]
+ node theme.mjs draw --material photo|product|words --job <subscribe|book|visit|attend|buy|try|sign up|hire|join|listen> [--theme <slug>] [--log .hallmark/log.json] [--seed <hex>]
node theme.mjs photos "<subject>" ["<subject>" ...] [--theme <slug>] [--n 3] [--orient landscape|portrait|square] [--log .hallmark/log.json] [--avoid <file naming photos>] [--save <dir>] [--json]
node theme.mjs log --entry '<one JSON object>' [--log .hallmark/log.json]
node theme.mjs index
@@ -161,7 +161,19 @@ const DRAW = {
heroes: { photo: ['Poster', 'Stage', 'Ledge', 'Settled', 'Poster', 'Stage'], product: ['Stage', 'Settled', 'Banner', 'Corridor', 'Stage'], words: ['Corridor', 'Ledge', 'Banner', 'Settled'] },
navs: ['edge-aligned', 'floating pill', 'masthead', 'slab', 'search-led bar', 'banner over a retracting bar'],
footers: ['mast', 'statement', 'colophon block', 'newsletter-first', 'letter close', 'index columns'],
- openers: ['Split', 'Showcase', 'Grid', 'Bento', 'Rows', 'Table', 'Steps', 'Statement'],
+ openers: ['Split', 'Showcase', 'Grid', 'Bento', 'Rows', 'Table', 'Steps', 'Statement', 'Rail', 'Pinned', 'Switcher', 'Index', 'Schedule', 'Offer'],
+ jobs: {
+ subscribe: { sections: ['an example issue set as it arrives (a sample)', 'the archive as an Index of past issues (sample titles)', 'who writes it, with a picture slot', 'the contents of one issue, as rows'], close: ['a second subscribe field under the archive', 'the archive itself, ending on the latest issue'], open: ['Index', 'Rail', 'Statement', 'Split'], heroes: ['Counter', 'Corridor', 'Index', 'Banner'], action: ['the subscribe field in the hero, beside the latest issue', 'the subscribe field in the hero and once more under the issues'] },
+ book: { sections: ['the menu as a Switcher by lunch and dinner (sample dishes, no prices unless given)', 'the room as a full-bleed photograph with no head', 'hours and the address as a section of their own', 'the next free times as buttons'], close: ['hours, the address and the booking again', 'the booking beside one last photograph'], open: ['Switcher', 'Index', 'Schedule', 'Split', 'Showcase'], heroes: ['Counter', 'Poster', 'Stage', 'Index'], action: ['a sticky booking bar', 'the booking times in the hero', 'the booking beside the menu or the rooms'] },
+ visit: { sections: ['what is on now as the lead picture', 'what is coming as dated rows', 'the shelves or the rooms as a Rail', 'getting there, with the hours'], close: ['visit information and the address', 'what is on next'], open: ['Showcase', 'Schedule', 'Rail', 'Split'], heroes: ['Poster', 'Ledge', 'Stage'], action: ['hours and the address in the hero', 'hours, the map and the way in at the close', 'a sticky bar with today\'s hours'] },
+ attend: { sections: ['the days as a Schedule', 'the lineup as an Index, set large', 'ticket tiers as rows', 'the place and how to get there', 'questions as rows'], close: ['tickets again', 'the questions', 'the mailing list for the next edition'], open: ['Schedule', 'Index', 'Rail', 'Showcase'], heroes: ['Index', 'Poster', 'Counter', 'Ledge'], action: ['tickets in the hero', 'tickets beside the lineup', 'a sticky ticket bar'] },
+ buy: { sections: ['the range as an Offer or a Rail (sample names; no prices unless given)', 'the thing in use, close and large', 'how it is made, as a Pinned run', 'delivery and care as plain facts'], close: ['the offer again', 'delivery and the guarantee as plain facts'], open: ['Offer', 'Rail', 'Showcase', 'Switcher'], heroes: ['Counter', 'Stage', 'Poster'], action: ['the offer as the hero', 'a sticky buy bar', 'the offer after the product close up'] },
+ try: { sections: ['features as named moments in screens (Pinned or Switcher)', 'a before and after', 'the platforms and what it needs'], close: ['the download beside one last screen'], open: ['Pinned', 'Switcher', 'Showcase', 'Rail'], heroes: ['Counter', 'Stage', 'Settled'], action: ['the download beside the screen in the hero', 'the download in the hero and at the close'] },
+ 'sign up': { sections: ['the product at work as a Pinned run', 'a code sample or the integration', 'pricing as a table with its period switch', 'questions as rows'], close: ['the hero\'s action in a short band', 'the code sample'], open: ['Pinned', 'Switcher', 'Showcase', 'Bento', 'Table'], heroes: ['Stage', 'Settled', 'Banner', 'Counter'], action: ['sign up in the hero', 'sign up in the hero and beside the price'] },
+ hire: { sections: ['the work as an Index of projects with pictures', 'one project opened as a case', 'what the studio does, as a short list', 'where it is'], close: ['contact details per office', 'a plain email and phone'], open: ['Index', 'Rail', 'Showcase', 'Statement'], heroes: ['Index', 'Poster', 'Corridor', 'Ledge'], action: ['the enquiry after the work', 'a contact line in the nav and at the close'] },
+ join: { sections: ['what a session is like, shown', 'when and where as a Schedule', 'membership options as rows', 'first-visit guidance'], close: ['the first visit', 'the membership options'], open: ['Schedule', 'Grid', 'Split', 'Showcase'], heroes: ['Counter', 'Poster', 'Corridor'], action: ['join in the hero', 'join beside the schedule'] },
+ listen: { sections: ['the record with its tracks as an Index (sample titles unless given)', 'dates as rows with ticket links', 'earlier work as covers in a Rail', 'a live photograph or the video'], close: ['the dates', 'more of the catalogue', 'the mailing list'], open: ['Index', 'Rail', 'Showcase', 'Schedule'], heroes: ['Poster', 'Index', 'Counter', 'Ledge'], action: ['the player or the record in the hero', 'listen in the hero and the dates beside it'] },
+ },
leads: { photo: ['the place', 'the thing itself, close', 'the making', 'the offer and its price', 'the season or the date', 'the people at work'], product: ['the job it does', 'the screen at work', 'the speed or the limit', 'the material it handles', 'the price', 'the before and after'], words: ['the claim', 'the question', 'the first line of the argument', 'the date and the place', 'the list itself'] },
};
function draw() {
@@ -178,17 +190,23 @@ function draw() {
const near = (opts, n, k, extra = []) => { const bad = new Set([...recent(k, n), ...extra]); const ok = opts.filter((o) => ![...bad].some((b) => b && b.includes(low(o)))); return ok.length ? ok : opts; };
const take = (opts, m = 1) => { const pool = [...new Set(opts)]; const out = []; while (out.length < m && pool.length) out.push(pool.splice(Math.floor(rand() * pool.length), 1)[0]); return out; };
const shapes = take(near(DRAW.shapes[material], 3, 'shape', pictured), 1);
- const [hero] = take(near(DRAW.heroes[material], 1, 'hero', pictured));
+ const jobName = low(flag('job', '')).replace(/download|app/, 'try').replace(/software|saas/, 'sign up').replace(/newsletter|waitlist/, 'subscribe').replace(/watch|read/, 'listen');
+ const job = DRAW.jobs[jobName] || null;
+ const [hero] = take(near(job ? [...job.heroes, ...job.heroes, ...DRAW.heroes[material].filter((h) => !/settled|stage/i.test(h) || job.heroes.includes(h))] : DRAW.heroes[material], 1, 'hero', pictured));
const [nav] = take(near(DRAW.navs, 3, 'nav'));
- const [footer] = take(near(DRAW.footers, 3, 'footer'));
+ const [footer] = take(near(DRAW.footers.filter((f) => f !== 'newsletter-first' || /subscribe/.test(jobName)), 3, 'footer'));
+ const [action] = job ? take(job.action) : [null];
+ const native = job ? take(job.sections, 3) : [];
+ const [close] = job ? take(job.close) : [null];
const lastOpen = low((log[0] && (Array.isArray(log[0].sections) ? log[0].sections[0] : String(log[0].sections || '').split(/[,>·]/)[0])) || '');
- const [opener] = take(DRAW.openers.filter((o) => !lastOpen.includes(low(o))));
- const skip = take(['Split', 'Grid', 'Band', 'Statement', 'Steps'].filter((o) => o !== opener), 2);
+ const [opener] = take((job ? job.open : DRAW.openers).filter((o) => !lastOpen.includes(low(o))));
+ const skip = take(['Split', 'Grid', 'Band', 'Statement', 'Steps', 'Figures'].filter((o) => o !== opener), 2);
const [lead] = take(DRAW.leads[material]);
- if (has('json')) { console.log(JSON.stringify({ seed, material, shapes, hero, nav, footer, opener, skip, lead })); return; }
+ if (has('json')) { console.log(JSON.stringify({ seed, material, job: jobName || null, shapes, hero, nav, footer, opener, skip, lead, action, native, close })); return; }
console.log(`draw ${seed} (fresh each build; --seed ${seed} repeats it)${pictured.length ? ` · clear of the theme picture's ${pictured.join(' and ')}` : ''}`);
console.log(`shape: ${shapes[0]} · hero: ${hero} · nav: ${nav} · footer: ${footer}`);
- console.log(`first section after the hero: ${opener} · leave out this time: ${skip.join(' and ')} · the hero leads with ${lead}, if the brief has it`);
+ console.log(`${job ? '' : `first section after the hero: ${opener} · `}leave out this time: ${skip.join(' and ')} · the hero leads with ${lead}, if the brief has it`);
+ console.log(job ? `job: ${jobName} · the action: ${action}\nbuild these, in the order the shape suits (the first right after the hero): ${native.join('; ')} · close on: ${close} (anatomy.md § ${jobName})` : 'no --job given: name the page\'s job (subscribe, book, visit, attend, buy, try, sign up, hire, join, listen) and draw again with --job');
console.log(`photos: pass --seed ${seed} to every theme.mjs photos call, so this build's picks are its own, and take its first fitting pick for the hero rather than hunting for the library's single best frame`);
console.log('take the draw unless the brief\'s material refuses a pick; name any swap in the Picks block, and stamp draw: ' + seed);
}
@@ -527,8 +545,8 @@ function scaffold() {
: brand
? `/* Hallmark · shape: <shape, or kept> · genre: <genre> · theme: brand${tail}${made} · hero: <posture, or kept> · nav: <shape, or kept> · footer: <shape, or kept> · signature: <the one move, or kept>\n * axes: ${axes} · contrast: pass · fold: pass · v${VERSION} */`
: custom
- ? `/* Hallmark · shape: <your name for the structure> · genre: <genre> · theme: custom${tail} · idea: "<one sentence>" · vibe: "<4 to 8 words>"${made} · hero: <in your own words> · nav: <shape> · footer: <shape> · imagery: <photographs, the product, or none> · signature: <the one thing a visitor remembers>\n * axes: ${axes} · contrast: pass · fold: pass · v${VERSION} */`
- : `/* Hallmark · shape: <shape${kept}> · genre: ${header.genre} · theme: ${theme}${tail}${depth ? '' : ' · draw: <seed>'}\n * hero: <posture${kept}> · nav: <shape${kept}> · footer: <shape${kept}> · imagery: <photographs, the product, or none> · signature: <the one move>${dial ? ` · ${dial[1]}: <the dials>` : ''}\n * axes: ${axes} · contrast: pass · fold: pass · v${VERSION} */`;
+ ? `/* Hallmark · shape: <your name for the structure> · genre: <genre> · theme: custom${tail} · job: <subscribe|book|visit|attend|buy|try|sign up|hire|join|listen> · idea: "<one sentence>" · vibe: "<4 to 8 words>"${made} · hero: <in your own words> · nav: <shape> · footer: <shape> · imagery: <photographs, the product, or none> · signature: <the one thing a visitor remembers>\n * axes: ${axes} · contrast: pass · fold: pass · v${VERSION} */`
+ : `/* Hallmark · shape: <shape${kept}> · genre: ${header.genre} · theme: ${theme}${tail}${depth ? '' : ' · job: <subscribe|book|visit|attend|buy|try|sign up|hire|join|listen> · draw: <seed>'}\n * hero: <posture${kept}> · nav: <shape${kept}> · footer: <shape${kept}> · imagery: <photographs, the product, or none> · signature: <the one move>${dial ? ` · ${dial[1]}: <the dials>` : ''}\n * axes: ${axes} · contrast: pass · fold: pass · v${VERSION} */`;
console.log(`wrote ${out} (${brand ? 'the shared scale; fill every --color-* and --font-* from the palette and faces the pre-flight found' : custom ? 'a starting scale, yours to rewrite; fill every --color-* and --font-* before building' : `${name} tokens plus the shared scale`}) and ${baseOut} (the base rules the Floor already decided)${sheet && !flag('dir', '') ? `, beside ${sheet}` : ''}`);
if (!custom && !flag('dealt', '')) {
const pic = join(THEMES, `${slug}.jpg`);