Skip to content

Fix install path, block contracts, and agent-facing docs - #186

Merged
silveltman merged 5 commits into
previewfrom
improvements/agentic-review
Sep 12, 2026
Merged

silveltman merged 5 commits into
previewfrom
improvements/agentic-review

Conversation

@silveltman

Copy link
Copy Markdown
Collaborator

Summary

Follow-up from a full project review. Also carries the earlier "Remove redundant project agent skills" commit that was not yet on origin/preview.

Consumer install path

  • @fulldev/init stylesheet now imports tw-animate-css and shadcn/tailwind.css and installs both. Overlay animations and data-state variants were silently dead in consumer projects. The site stylesheet now imports the registry stylesheet so they cannot drift again.
  • @fulldev/components includes breadcrumb, carousel, icon, and kbd. Bundles are kept complete by the new registry:meta script.
  • Registry items carry title, description, categories, and docs, generated from page frontmatter, so the shadcn CLI and MCP server can search them.

Components and blocks

  • Header blocks render children once and expose a mobile slot. Mobile navigation entries are real links.
  • Contact blocks render a <form> with names, unique ids, and action / method / id props.
  • Blocks accept and forward any HTML attribute on their root.
  • New SectionTitle and SectionDescription in @fulldev/section, used across blocks.
  • Icon loads lazily, supports lucide: / simple: prefixes, and is aria-hidden unless labelled.
  • Interactive components re-initialize on astro:page-load.
  • Sidebar outline variant border fixed; GitHub star count is a prop.
  • "Open in ChatGPT / Claude / Cursor" now sends an absolute URL.

Docs and agents

  • llms.txt and llms-full.txt; Markdown routes served as text/markdown; overview Markdown lists pages; block Markdown includes the install command.
  • Sidebar component and block navigation derived from the content collection. Deprecated image page hidden.
  • Rewritten MCP, theming, and dark mode guides. README shows how to add the registry. Skill fixes for init and stale file references.

Repo

  • Docs tooling moved to devDependencies, unused packages dropped, pnpm 11.
  • CI runs on preview, restricts token permissions, and adds an install smoke test that scaffolds a fresh Astro project and installs everything from a local preview server.
  • Dependabot, issue and PR templates, changeset.

Verification

  • pnpm format:check, pnpm typecheck, pnpm registry:check, pnpm build all pass locally.
  • Built output checked for Markdown routes, llms files, OG image, mobile links, form markup, and icon attributes.
  • The CI smoke test job has not run yet; this PR is its first run.

🤖 Generated with Claude Code

silveltman and others added 4 commits September 12, 2026 11:44
- Header blocks: render children once, add mobile slot, make mobile navigation real links
- Contact blocks: render a form with names, unique ids, submit button, action and method props
- Blocks accept and forward HTML attributes on their root element
- Add SectionTitle and SectionDescription and use them for block headings
- Icon: lazy load, lucide:/simple: prefixes, deterministic resolution, aria-hidden by default
- Re-initialize interactive components on astro:page-load
- Sidebar menu button outline variant renders its border again
- Sidebar block takes githubStars as a prop
- Assistant links use absolute Markdown URLs
- Use type Props instead of interface Props in sidebar buttons

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- Add llms.txt and llms-full.txt, serve Markdown routes as text/markdown
- Overview Markdown pages list their pages, block Markdown pages include the install command
- Derive sidebar component and block navigation from the content collection
- Mark the image page deprecated and hide it from navigation and search
- Default every page to the site OG image
- Remove the orphaned init page and redirect it to installation
- Rewrite the MCP, theming, and dark mode guides with concrete setup and token tables
- Document the registry and init command in the README and the skill
- Fix skill references to a non-existent layout renderer and a removed skill
- Layouts destructure Astro.props per the skill rules

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
- Init stylesheet imports tw-animate-css and shadcn/tailwind.css, installs both, uses the shadcn dark variant, and adds a reduced-motion rule
- Site stylesheet imports the registry stylesheet so they cannot drift
- Generate registry title, description, categories, and docs from page frontmatter and keep bundle items complete
- Move docs-site tooling to devDependencies, drop unused packages, require pnpm 11
- Run CI on preview, restrict token permissions, add an install smoke test
- Add dependabot, issue and pull request templates
- Add changeset

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@netlify

netlify Bot commented Sep 12, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for fulldev-ui ready!

Name Link
🔨 Latest commit 7a27985
🔍 Latest deploy log https://app.netlify.com/projects/fulldev-ui/deploys/6aa553ce6320810008ef8511
😎 Deploy Preview https://deploy-preview-186--fulldev-ui.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
@silveltman
silveltman merged commit 2c7fbcf into preview Sep 12, 2026
6 checks passed
@silveltman
silveltman deleted the improvements/agentic-review branch September 12, 2026 13:34
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