Skip to content

docs(feat): add "Use your first block" walkthrough#151

Open
Ducksss wants to merge 1 commit into
devfrom
claude/elegant-curie-296fbb
Open

docs(feat): add "Use your first block" walkthrough#151
Ducksss wants to merge 1 commit into
devfrom
claude/elegant-curie-296fbb

Conversation

@Ducksss

@Ducksss Ducksss commented Jun 19, 2026

Copy link
Copy Markdown
Owner

What

A Get Started walkthrough — "Use your first block" — bridging what payload-components add does to your files and what an editor actually does in the Payload admin. The gap it fills: nothing previously showed the payoff that after add, the block is already in the admin block picker, wired and ready.

  • content/docs/first-block.mdx — install → admin → live, using Feature Grid Basic: a "why it's already wired" callout, 5 steps (admin → Add Block → fill → publish → live), real admin screenshots for the picker + fields, and the live <ComponentPreview> for the result.
  • content/docs/meta.json — slotted into Get Started, right after Installation.
  • tools/payload-components/commands/add.ts — post-install "next steps" hint pointing to the admin and the walkthrough (block name derived from the manifest's pagesLayout fragment).
  • public/docs/admin/*.png — captured from a real Payload admin.

Verification

  • Integration: 16 passed (fumadocs-site, payload-components-add-command).
  • GEO/llms e2e: 11 passed (/llms.txt, /llms-full.txt, per-page markdown, structured data) — new page is additive, contract intact.
  • Previewed /docs/first-block: renders with both screenshots, the live component preview, and the sidebar entry after Installation; no console errors.

🤖 Generated with Claude Code

A Get Started page bridging install → admin → live: shows the block already in the Payload admin picker after `add`, with captured admin screenshots (picker + fields) and the live component preview. Also prints a post-install "next steps" hint in the CLI pointing to the admin and the walkthrough.

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

vercel Bot commented Jun 19, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
payload-components Ready Ready Preview, Comment Jun 19, 2026 11:02am
payload-components-97bf Ready Ready Preview, Comment Jun 19, 2026 11:02am

@Ducksss

Ducksss commented Jun 23, 2026

Copy link
Copy Markdown
Owner Author

Current action: keep open on dev, but refresh against current docs before review. This overlaps the visual walkthrough/docs work tracked in #23.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant