Skip to content

docs: refresh ROADMAP.md to match current catalog count (#128)#196

Merged
Ducksss merged 2 commits into
Ducksss:devfrom
highoncomputers:docs/refresh-roadmap
Jun 23, 2026
Merged

docs: refresh ROADMAP.md to match current catalog count (#128)#196
Ducksss merged 2 commits into
Ducksss:devfrom
highoncomputers:docs/refresh-roadmap

Conversation

@highoncomputers

@highoncomputers highoncomputers commented Jun 23, 2026

Copy link
Copy Markdown
Contributor

Problem

ROADMAP.md said "The registry ships 38 installable page blocks", but the catalog now ships 58 installable page blocks across 12 families, plus 8 post components in development. The stale count misleads contributors about what is actually available.

Solution

Update the Current State section so the catalog count matches the source of truth (src/lib/site.ts, pinned by tests/int/fumadocs-site.int.spec.ts).

Changes

  • Update page block count: 38 → 58 across 12 families, plus 8 post components in development
  • Add a short, link-free note that anonymous (no-PII) analytics are collected for install-copy and primary-link intent

Refs #128


Maintainer note: tidied this description to match the current diff. An earlier revision listed 53/11, removed the waitlist funnel non-goal, and linked content/docs/analytics.mdx (which doesn't exist) — all since corrected on the branch (waitlist funnel kept, per #128's "no waitlist" framing; analytics note now link-free). Switched Closes #128Refs #128 because this is a focused count refresh while #128's broader asks remain open.

…ale references (Ducksss#128)

Updates the stale '38 installable page blocks' count to '53 page blocks
across 11 families, with 8 post components in development'. Removes the
'waitlist funnel' reference from the Not Planned section since the waitlist
was removed. Adds a note about analytics collection.

Closes Ducksss#128
@highoncomputers highoncomputers requested a review from Ducksss as a code owner June 23, 2026 14:22
@vercel

vercel Bot commented Jun 23, 2026

Copy link
Copy Markdown

@highoncomputers is attempting to deploy a commit to the ducksss' projects Team on Vercel.

A member of the Team first needs to authorize it.

- 53 -> 58 installable page blocks (registry.json ships 58; matches site copy)
- 11 -> 12 families (pricing family already shipped via Ducksss#191)
- drop link to non-existent content/docs/analytics.mdx
- restore "waitlist funnel" to Not Planned (still a documented non-goal)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

@Ducksss Ducksss left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving — but I pushed corrections first, because the refreshed count was itself already stale.

Verified against the codebase:

  • 53 → 58 page blocks. payload-components/registry.json ships 58 blocks (so does origin/dev), and the site's own canonical copy says "Fifty-eight page blocks install today" (src/lib/site.ts, src/app/about/page.tsx). The pricing family (#191, +5 blocks) already landed in dev — that's the 53→58 gap.
  • 11 → 12 families. Pricing is the 12th family (it's in the FAMILIES list in src/lib/component-page-tree.tsx).
  • "8 post components in development" ✅ — confirmed, matches the site copy.
  • Dropped the analytics-docs link. content/docs/analytics.mdx does not exist (only src/lib/analytics.ts), so it was a dead link. The prose itself is accurate, so I kept the sentence and just removed the link.
  • Restored "waitlist funnel" to Not Planned. It's still an active, documented non-goal — both CONTRIBUTING.md and AGENTS.md say "do not reintroduce … waitlist APIs" — so it belongs in the non-goals list. (The waitlist having been removed is exactly why it's not planned.)

Scope note: #128 also asked to link active GitHub issues and mark speculative items clearly — this PR doesn't do that, so I'd keep #128 open for that follow-up. (It won't auto-close on merge anyway, since the base is dev, not main.)

@Ducksss

Ducksss commented Jun 23, 2026

Copy link
Copy Markdown
Owner

Reviewed against the current head (28bf944). Your fix commit ("fix stale counts and broken analytics link") resolves the substantive issues — thanks for the quick turnaround. Confirming:

  • Count58 installable page blocks across 12 families, with 8 post components. Matches the source of truth (src/lib/site.ts:216, and componentFamilies.pages.countLabel = '58 installable'), which is pinned by tests/int/fumadocs-site.int.spec.ts:336-341 (asserts pageCount === 58).
  • Broken link — the content/docs/analytics.mdx link is gone; the note is now link-free and accurate.
  • Waitlistwaitlist funnel is back under Not Planned, which is what docs: refresh ROADMAP.md to match the current public alpha #128 asks for ("no paid roadmap, no private registry, no waitlist").

Two small follow-ups (I've handled the second):

  1. Analytics note (optional — maintainer's call). - Anonymous analytics … no PII is captured. is accurate, but docs: refresh ROADMAP.md to match the current public alpha #128 scopes this to docs cleanup ("Do not invent a new product strategy"), so a data-collection line is slightly beyond scope. Fine to keep — just flagging. If we want it long-term, a dedicated content/docs/analytics.mdx (the page the link pointed at) would be its natural home.
  2. Stale description + Closes #128. The PR body still described the pre-fix state (53/11, "removed waitlist funnel", "documented in the analytics docs"). I've tidied the description to match the current diff and switched Closes #128Refs #128, since this is a focused count refresh and docs: refresh ROADMAP.md to match the current public alpha #128's broader asks (issue-queue links, marking speculative items) remain open.

LGTM to merge into dev once you're settled on the analytics line.

@Ducksss Ducksss merged commit 8e895db into Ducksss:dev Jun 23, 2026
5 of 7 checks passed
Ducksss added a commit that referenced this pull request Jun 24, 2026
Completes the remaining acceptance items on #128 (count/link/waitlist were #196):
- point the roadmap at the live GitHub issue queue + label filters
- attach representative scoped issues to each priority (no bullets dropped)
- add an 'Exploring (not committed)' section for speculative items (#15, #16)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Ducksss added a commit that referenced this pull request Jun 24, 2026
…209)

Completes the remaining acceptance items on #128 (count/link/waitlist were #196):
- point the roadmap at the live GitHub issue queue + label filters
- attach representative scoped issues to each priority (no bullets dropped)
- add an 'Exploring (not committed)' section for speculative items (#15, #16)

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Ducksss added a commit that referenced this pull request Jun 25, 2026
* frontend(feat): add fumadocs blog with two launch posts

Adds a `blog` collection (defineCollections + author/date frontmatter) alongside
the existing docs collection, a flat `/blog/[slug]` post route and `/blog` index
card grid styled to the shadcn + emerald brand, RootProvider/SiteHeader layout,
and Blog nav links. Seeds two real posts bylined Ducksss: a friendly "Hello"
welcome and an "Anatomy of an install" deep-dive.

zod is promoted to a direct devDependency (4.4.3, the version fumadocs-core
already resolves) so the blog frontmatter schema can extend pageSchema. The blog
is independent of the docs llms.txt/geo contract.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* build(chore): bump dependency maintenance updates (#146)

Summary:
- Bump TypeScript from 5.7.3 to 5.9.3 and refresh pnpm lock.
- Bump registry verification failure artifact uploads to v7.

Rationale:
- Keep Dependabot maintenance updates on dev with a small scoped diff.
- Next is already at 16.2.6 on dev, so no package diff was needed.

Tests:
- pnpm install --frozen-lockfile
- pnpm build
- E2E_PORT=3100 pnpm test:release (fails locally: e2e route sweep
  timeout and Darwin homepage snapshot delta; lint, source build,
  typecheck, registry check, and integration tests passed before e2e)
- E2E_PORT=3100 pnpm exec cross-env NODE_OPTIONS="--no-deprecation
  --import=tsx/esm" playwright test --config=playwright.config.ts
  tests/e2e/frontend.e2e.spec.ts -g "landing page keeps its desktop
  and mobile visual contract" (fails locally: same Darwin snapshot delta)

* components(feat): add FAQ family (6 tailark-derived blocks) (#148)

Import the tailark "faqs" category as Payload Components, adapted to the
site's light/emerald token system. Ships 6 distinct structural variants —
faq-accordion, faq-split, faq-card, faq-icons, faq-grouped, faq-grid —
each with source config + Component, manifest, registry entry, docs page,
and demo twin. Shared family code: faqFields.ts and faqIcons.ts (icon-name
select → lucide map, mirroring the Content family's contentIcons pattern).

Activates the previously-empty `faq` catalog category, registers the FAQ
docs sidebar family, and bumps the page-block count 38 → 44 (copy + guard).
Adds `accordion` to the public shadcn dependency allowlist so the accordion
variants pass the registry import-derivation test.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* docs(chore): remove alpha messaging

Summary:
- Replace public alpha labels with neutral open-source and MIT copy.
- Rename the internal alpha component template to component-template.
- Refresh homepage screenshots for the visible copy changes.

Rationale:
- The site, CLI, docs, and package metadata should not present the
  project as alpha.
- The template rename prevents future component docs from reintroducing
  alpha language.

Tests:
- rg -n -i "\\balpha\\b|alpha-" --glob '!node_modules/**' --glob '!public/r/**' --glob '!.next/**' --glob '!test-results/**'
- git diff --check
- pnpm lint
- pnpm exec tsc --noEmit
- pnpm run test:int
- pnpm run test:e2e
- pnpm test:registry
- pnpm build

* registry(feat): prep registry for shadcn directory submission (#150)

Make the @payload-components registry submission-ready for the official shadcn
registry directory — all 44 items, including the FAQ family merged from dev.

- Replace the <your-domain> placeholder with https://www.payload-components.xyz
  across every item's docs URL; point registry.json homepage at the live site.
- Add a registry:validate gate (ajv + vendored shadcn draft-07 schemas) folded
  into test:registry, since shadcn@4.7.0 has no validate command.
- Document the @payload-components namespace install path in the install/registry
  docs and README.
- Stage the shadcn-ui/ui directory entry + submission steps in AGENTS.md.

Verified locally: registry reproducible + schema-valid (44 items), lint, tsc,
test:int (68 passed). Landed via admin merge (dev's review gate is
unsatisfiable for the sole owner; the Registry Verification workflow
startup-fails repo-wide and Vercel was rate-limited).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs(docs): polish README for community launch

Summary:
- Rework the README around open-source SaaS-style positioning.
- Add the existing social card, contributor links, and community framing.
- Split consumer install guidance from local repository setup.

Rationale:
- The README is the front door for contributors and early adopters.
- Keeping the content MIT-first and community-first avoids stale commercial
  framing while making the install contract easier to scan.

Tests:
- pnpm lint
- git diff --check -- README.md
- curl -fsSI https://www.payload-components.xyz/opengraph-image
- rg stale commercial framing scan

* fullstack(fix): clear release gate review findings

Summary:
- Update FAQ registry, manifest, and installed Payload labels to use the
  proper acronym capitalization.
- Add the new FAQ slugs to CLI help and correct the blog component count.
- Clip page-level horizontal overflow and refresh the stale Linux landing
  desktop screenshot baseline.
- Document why TypeScript remains pinned to 5.x until the tsconfck peer
  range supports TypeScript 6.

Rationale:
- The PR was fast-forwardable but blocked by release-gate visual and
  overflow failures plus review metadata drift.
- Keeping TypeScript 5.x avoids shipping an unmet peer dependency from
  vite-tsconfig-paths through tsconfck.

Tests:
- pnpm test:release

* tests(fix): refresh linux mobile landing baseline

Summary:
- Replace the stale Linux mobile landing screenshot baseline with the
  release-gate actual image from PR #152.

Rationale:
- The Linux mobile baseline was still taller than the current rendered
  landing page, matching the same stale-baseline issue fixed for desktop.
- The actual image was stable across CI retries.

Tests:
- pnpm test:release
- verified CI artifact actual image was stable across retries

* repo(chore): close CI visual-regression gap and clear review bloat/drift (#153)

* repo(chore): close CI visual-regression gap and clear review bloat/drift

Repo review follow-ups (no behavior change to the shipped site or CLI):

- CI visual gap: the components-visual suite silently skipped on every CI
  run (only darwin baselines existed; CI is linux). Add a visual-baselines
  workflow_dispatch that mints per-platform baselines in the CI renderer and
  opens a PR, plus a coverage guard that fails loudly once a platform is
  minted but a component lacks a baseline (instead of silently skipping).
- Drop 3 dead pnpm.overrides (dompurify, drizzle-orm, uuid): Payload-runtime
  residue with no package in the lockfile.
- Remove the unreachable layout='stack' branch in ComponentFamilyHeader.
- Derive the not-found 'Known components' list from componentEntries.
- Guard componentFamilies.posts.countLabel (the one unguarded catalog count).
- Hoist the duplicated baseManifest into a dependency-free manifest-factory
  module (the two copies had drifted; import-light so it can't defeat the
  manifest spec's mock).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* ci(fix): restore actions/upload-artifact@v4 (v7 doesn't exist)

PR #146 bumped upload-artifact v4→v7, but that major doesn't exist. An
unresolvable action reference makes the workflow fail at startup
(startup_failure, 0s), which has blocked every dev push and PR gate since
that merge. Restore the known-good v4.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* Revert "ci(fix): restore actions/upload-artifact@v4 (v7 doesn't exist)"

This reverts commit d1392ea.

* test(ci): refresh stale linux landing baseline (desktop)

The linux landing baselines went stale during the day the CI gate was down
(broken allowlist): the family-teaser landing change shrank the page, the
darwin baseline was refreshed but linux never was. This restores the desktop
linux baseline from the gate's own actual render; mobile follows.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* test(ci): refresh stale linux landing baseline (mobile)

Companion to the desktop refresh: restores the mobile linux landing baseline
from the gate's own actual render (390x14444, matching the current darwin
baseline). Both linux landing baselines now reflect the family-teaser landing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* cli(fix): unify fragment writer/verifier dedup matchers (#157)

The renderBlocks/pagesLayout patcher deduped on exact full lines while the
verifier checked loose substrings, so the two could disagree. A consumer whose
anchor region was reformatted (Prettier reflow, hand-edit, double quotes, no
trailing comma) could slip past the writer's exact-line dedup — appending a
duplicate object key / import — while the verifier still reported it present,
so 'add' wrote a broken RenderBlocks.tsx and 'doctor' called it healthy.

Give apply (dedup) and verify one shared structural matcher per fragment
(tolerant of quote style, trailing semicolons, indentation, spacing) so they
can't disagree. Adds a regression test that pre-seeds a reformatted
registration and asserts apply doesn't duplicate it and verify reads it present.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* cli(refactor): drop the redundant installedFiles install-state field (#160)

installedFiles was recorded in .payload-components/state.json but never read
for any decision — add/doctor re-derive install validity from the manifest, so
the stored copy was just a duplicate of manifest.files that could only drift.
Remove it from the state entry type, the three record functions, the v1->v2
migration, normalizeState, and the install assertions/specs.

Backward-compatible: normalizeState no longer reads the field, so existing v2
state files that still carry it load fine (the dead field is ignored on read).
No state version bump.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* components(feat): add Comparator family (3 tailark-derived blocks) (#158)

Ports tailark's MIT comparator category as comparator-table, comparator-grid, and comparator-stack — new comparator page-family, page-block count 44 to 47.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* fix(comparator): canonical install URLs, icon a11y labels, and block count (#172)

* registry(fix): use canonical www URL for comparator install commands

The Comparator family (#158) shipped its three registry-item docs with the
literal https://<your-domain>/r/comparator-*.json placeholder, and its three
MDX manual-install snippets used the bare apex https://payload-components.xyz
(no www). Every other one of the 44 published items uses the canonical
https://www.payload-components.xyz that #150/#155 standardized on; the
placeholder is a copy-pasteable-but-broken install command and the bare apex
is inconsistent.

Replace both with https://www.payload-components.xyz in the three comparator
entries of payload-components/registry.json and the three comparator docs
pages. Source-only change; public/r/*.json is gitignored and rebuilt from this
source by registry:build.

Found during the dev->main promote review (PR #162).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* a11y(comparator): label state icons + table headers, refresh blog count

- Add role="img" + aria-label ("Included"/"Not included") to the Check/Minus
  state icons in all three Comparator blocks so screen readers announce the
  yes/no meaning of each matrix cell (previously icon-only).
- Add scope="col" to the ComparatorTable plan header cells.
- Bump the (non-test-pinned) blog copy "About 44" -> "About 47" page blocks to
  match the count now installable after the Comparator family.

Attribute-only on the block source (no className change), so the demo-twin
class-mirror guard is unaffected and the visual baselines are unchanged; the
blog count is prose, not a pinned assertion.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* repo(chore): review follow-ups — a11y gate, CLI hardening, CI trims (#163)

Code-review remediation (P1 hardening + P2 trims + a11y gate):

- a11y: add tests/e2e/a11y.e2e.spec.ts (axe-core WCAG 2.1 A/AA over
  /, /docs, /components; serious+critical). Fixes it surfaced: darken
  --muted-foreground 50%->46% (was 4.41:1, sub-AA), text-brand-600 on
  light-emerald catalog pills, raise reduced-opacity small labels to full
  opacity, logo placeholders /55->/70, tabIndex on scrollable code blocks.
- cli: atomic state writes (temp+rename) + corrupt-state fallback in
  loadState; fix latent shared-defaultState mutation (createDefaultState
  factory). Add fragment-patching failure-mode tests.
- ci: unify GitHub Action versions across workflows; main-only push gate;
  add fast-fail quick-checks (lint+tsc) job.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* components(feat): add testimonials family (6 tailark-derived blocks) (#159)

* components(feat): add testimonials family (6 tailark-derived blocks)

Imports the distinct testimonial layouts from tailark/blocks (MIT),
re-implemented as wired Payload blocks in this repo's idiom (Media
avatars, editable fields, light tokens): testimonials-quote, -spotlight,
-grid, -rating, -bento, -wall. Full contract each — source, manifest,
registry entry, demo twin, docs — plus catalog, count (38->44),
family-teaser, and enumeration wiring.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* test(ci): raise e2e dev-server heap to clear route-loop OOM

The frontend route-loop (frontend.e2e:159) visits every component doc
page against `next dev`; at 50 routes the dev server hit its memory
threshold and restarted mid-test (ERR_CONNECTION_RESET on the last
routes), failing the linux release gate even through retries:2. Bump
--max-old-space-size to 8192 for the dev server so it doesn't restart
while compiling all routes in one pass.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* test(chore): mint darwin landing baseline for testimonials teaser

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* test(ci): mint linux landing baseline for testimonials teaser

Rendered on the ubuntu gate via the visual-baselines workflow so the
landing visual test compares (not fails) on the linux release gate.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* test(ci): raise e2e dev-server heap to 12GB for the 53-route loop

8192MB held at 50 routes but the dev server still hit its memory
threshold and restarted at 53 (faq+comparator+testimonials), resetting
mid-route-loop. Give real headroom on the 16GB CI runner.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* chore(seo): add Google Search Console verification file (#180)

Serves /google44d8f9f26e2e2367.html for the new GSC property,
alongside the existing googleda94848bf7de62aa.html and BingSiteAuth.xml.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* catalog(chore): reorder /components to showcase best components first (#181)

* catalog(chore): reorder /components to showcase best components first

Lead the catalog with the most-wanted, most visually striking blocks.
Categories now rank landing-page essentials first: Hero, Features,
Comparator (pricing), Call to action, then social proof (Integration,
Logo cloud, Testimonials), then FAQ, then the deep Content set,
trailing Team and Embed. Within each category the showpiece variant
(per familyRepresentatives) leads.

Applied consistently across the wall + sidebar (componentEntries,
componentCategories) and the docs nav (FAMILIES); the landing teaser
inherits componentCategories order automatically. Pure data reorder of
all 53 page blocks — no schema/logic change. Fixes the prior
wall/sidebar disagreement, surfaces Comparator (was last) and
Testimonials, and de-emphasizes the single-purpose Embed (was 3rd).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* test(chore): mint Linux visual baselines (frontend)

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* repo(deps): bump actions/checkout to v7 and cross-env to v10 (#183)

Applies the genuinely-new increments from the four Dependabot PRs (#167-#170)
directly on dev, the integration branch, since merging them into main would be
reverted by the next dev->main promote.

- actions/checkout v6 -> v7 across all workflows (lockstep, allowlist admits v7)
- cross-env ^7.0.3 -> ^10.1.0 (minimal lockfile delta: +@epic-web/invariant)

setup-node@v6 and pnpm/action-setup@v6 (#168, #169) were already on dev, so
those PRs are redundant. Also points Dependabot at dev (target-branch) so future
bumps land on the integration branch instead of main.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* repo(deps): bump undici to 7.28.0 to clear 6 security advisories (#184)

Resolves all six open Dependabot security alerts (undici < 7.28.0):
- CVE-2026-6734, CVE-2026-9697 (high)
- CVE-2026-9679, CVE-2026-9678 (medium)
- CVE-2026-11525, CVE-2026-6733 (low)

undici is an optional transitive of the jsdom/test chain; the parent range
already admits 7.28.0, so a plain re-resolve picks it up (no override needed).
The sibling bumps are all within that same optional cluster.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* docs: add security reporting contact link to issue chooser (#185)

Lands @highoncomputers' #173 onto dev. Resolves #138.

Co-authored-by: highoncomputers <highoncomputers@users.noreply.github.com>

* cli(feat): harden partial install recovery (#188)

Print stage-specific recovery guidance when `payload-components add` fails
mid-install, a "retrying partial install" notice when re-running a partial
entry, and owned/patched file detail in `payload-components doctor`. Docs in
both READMEs cover fix-and-retry without deleting patched host files.

Rebuilds the intent of #94 on the current install-state model: owned files
come from `manifest.files` and patched files from the existing patchedFiles
var / `entry.patchedFiles` (the `installedFiles` field #94 relied on was
removed from the state model).

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* docs: clarify payload-components init behavior (#187)

Clarify that `payload-components init` delegates to `shadcn init` to create the `components.json` baseline, and that `payload-components add` expects that baseline and does not run init automatically as a side effect.

Lands the docs fix from #165 with authorship preserved for @tysoul574-spec.

Closes #104

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* test(chore): mint Linux visual baselines (components-visual) (#186)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* frontend(feat): redesign logo as terminal prompt + block-cursor mark (#190)

* frontend(feat): redesign logo as terminal prompt + block-cursor mark

Replace the bare > glyph with a geometric prompt chevron + block cursor,
drawn as a real SVG so the header, favicon, and OG image share one mark.
Retires the Payload-CMS-style favicon.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* test(chore): mint Linux visual baselines (frontend.e2e) (#189)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* components(feat): add pricing family (5 tailark-derived blocks) (#191)

Fills the previously-empty Pricing catalog family with five field-driven
Payload blocks, retokenized from tailark/blocks (MIT) onto the light
monochrome + emerald system: pricing-cards (showpiece), pricing-cards-muted,
pricing-cards-cta, pricing-split, and pricing-enterprise (editable Media
logo wall). Shared pricingFields/planFields keep the family from drifting.

Wires the full add-a-family contract against current dev (58 page blocks):
5 block sources + shared fields, 5 manifests, 5 registry.json items
(registryDeps matched to imports), 5 class-mirrored demo twins + demo
content, catalog entries inserted at the curated rank (after Comparator),
FAMILIES docs-nav entry, count pins (53->58) across site.ts/about/tests,
cli + smoke lists, and 5 docs pages with tailark MIT attribution.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* test(chore): mint Linux visual baselines (components-visual frontend) (#193)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* fix(pricing): review-nit polish — link validation, decorative icons, split highlight (#194)

Three polish fixes from the pricing-family code review. All visually neutral,
so the just-minted (#193) Linux baselines stay valid.

- PricingEnterprise: validate the logo `href` so non-http(s) values (e.g. a
  `javascript:` payload) are rejected. Inlined rather than reusing
  shared/safeUrls — the embed/form validators there would wrongly reject
  arbitrary customer URLs.
- Mark the decorative feature-list `<Check>` icons aria-hidden across all five
  variants so screen readers don't announce them.
- PricingSplit: derive the highlighted (right) plan from the `featured` flag
  instead of hard-coding plans[1], so marking either plan featured works.
  Mirrored in the PricingSplitDemo twin.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* PinZheng(config): harden sitemap crawling (#198)

Add stable edge cache headers for crawl metadata and tighten sitemap coverage.

* docs(roadmap): correct catalog counts and drop dead link (#196)

* docs: refresh ROADMAP.md to match current catalog count and remove stale references (#128)

Updates the stale '38 installable page blocks' count to '53 page blocks
across 11 families, with 8 post components in development'. Removes the
'waitlist funnel' reference from the Not Planned section since the waitlist
was removed. Adds a note about analytics collection.

Closes #128

* docs(roadmap): fix stale counts and broken analytics link

- 53 -> 58 installable page blocks (registry.json ships 58; matches site copy)
- 11 -> 12 families (pricing family already shipped via #191)
- drop link to non-existent content/docs/analytics.mdx
- restore "waitlist funnel" to Not Planned (still a documented non-goal)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: highoncomputers <highoncomputers@users.noreply.github.com>
Co-authored-by: Chai Pin Zheng <chaipinzheng@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* docs(operations): replace stale kit language in runbook (#197)

* docs: replace stale 'kit' language in operations runbook (#129)

Replaces 'blog card kit' and 'Kit request' with 'blog card component' and
'Component request' to match the current project naming. The project was
renamed from Payload Kits to Payload Components but the operations runbook
still had one stale phrase in the feedback routing table.

Closes #129

* docs(operations): realign feedback-routing table row

Trim 2 spaces so the edited row's pipes match the rest of the table.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: highoncomputers <highoncomputers@users.noreply.github.com>
Co-authored-by: Chai Pin Zheng <chaipinzheng@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* frontend(feat): graphics-forward landing redesign — node maps, merged install-boundary section, full-width FAQ (#207)

* frontend(feat): graphics-forward landing redesign — node maps, merged install-boundary section, full-width FAQ

Replace the word-heavy landing with a graphics-led narrative:
- New graphics/ primitives: WiringNodeMap (unwired/wired/boundary states,
  reads wiringLedger.rows) and PreviewSurface (framed live demo-twin).
- Merge the duplicate Tax + Wiring beats into one "install boundary" section
  ("A block isn't live until it's wired.") with a single boundary node map +
  the shadcn-vs-payload-components ledger; delete TaxSection.
- Clarify the hero install replay: clean terminal copy, relabeled output
  ("The block, rendered" / "Files the install wrote"), remove arbitrary traces.
- StackBand → support-matrix pill row; Workflow → vertical timeline + live
  feature-split preview; FAQ → full width with readable answer measure +
  dogfood caption; Community decluttered (releases moved to footer).
- Cut word-heavy copy in site.ts; add .wire-draw-scroll util (reduced-motion
  safe). Regenerate darwin landing baselines (linux via CI visual-baselines).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* test(chore): mint darwin landing baselines for the redesign

The landing layout changed (merged install-boundary section, full-width FAQ,
workflow timeline). Regenerate the darwin landing-home snapshots so local macOS
runs compare cleanly; linux baselines are minted by the visual-baselines CI
workflow.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* test(chore): mint Linux visual baselines (frontend) (#210)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* docs(roadmap): link the live issue queue and mark exploratory items (#209)

Completes the remaining acceptance items on #128 (count/link/waitlist were #196):
- point the roadmap at the live GitHub issue queue + label filters
- attach representative scoped issues to each priority (no bullets dropped)
- add an 'Exploring (not committed)' section for speculative items (#15, #16)

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* frontend(feat): landing motion — auto-replaying hero + hover-lift micro-interactions (#211)

- HeroInstallReplay: auto-replay the install choreography when the frame
  re-enters the viewport (IntersectionObserver). Plays once on load, replays
  on a fresh re-entry, idle while sitting still or off-screen, and disabled
  under prefers-reduced-motion — a perf-safe "product loop", not an always-on
  hero animation.
- Add a .hover-lift utility (transform + shadow, transition only) and apply it
  to the framed preview surface and the maintainer-note card for tactile
  micro-interactions.

Layers on top of the existing scroll-reveal + wire-draw scroll animations.
No visual-baseline change: every effect is hover-only or reduced-motion-off,
so the reduced-motion snapshots are untouched.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

* frontend(feat): scroll parallax on decorative layers (#212)

Add a lightweight ParallaxController (one passive, rAF-throttled scroll
handler) that drifts decorative layers — the hero bloom and the community
dot field — by a clamped fraction of their distance from the viewport
centre. CSS view() timelines can't drive these (they sit inside
overflow-hidden sections that become degenerate scroll containers), so a
minimal JS handler does it: transform-only via translate3d, coalesced to one
rAF per frame, idle when not scrolling, guarded against a zero viewport, and
disabled entirely under prefers-reduced-motion.

Verified the transform varies across a real wheel scroll; reduced-motion
snapshots are unchanged (effect is RM-off), so no baseline regeneration.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: highoncomputers <highoncomputers@users.noreply.github.com>
Co-authored-by: highoncomputers <manuelxmarandi@gmail.com>
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.

2 participants