Skip to content

chore: shadcn MCP + Tailark Pro registry + remove 6 internal docs - #17

Merged
Codehagen merged 1 commit into
mainfrom
chore/internal-md-cleanup-plus-tailark
Apr 19, 2026
Merged

Codehagen merged 1 commit into
mainfrom
chore/internal-md-cleanup-plus-tailark

Conversation

@Codehagen

@Codehagen Codehagen commented Apr 19, 2026 •

Copy link
Copy Markdown
Owner

Summary

Dev-environment plumbing only — no scaffold/template impact, verified safe (the template components.json is generated from a hardcoded literal in scripts/sync-templates.mjs line ~370, not copied from apps/web/).

Config

  • .mcp.json (repo root): add shadcn MCP server next to supabase. Claude Code now has the shadcn registry tools available when working in this repo.
  • apps/web/components.json: add @tailark-pro registry block per shadcn registry docs. Auth via TAILARK_API_KEY env var. Key lives in apps/web/.env.local (gitignored, not committed).

Usage from apps/web/:

pnpm dlx shadcn@latest add @tailark-pro/<name>

Repo cleanup

Remove 6 internal docs that don't belong in a public repo (-1,478 lines):

File Why
CLI_DX_PLAN.md Delivery plan, work shipped
DEVICE_FLOW_PLAN.md Delivery plan, device flow live
UNIFIED_SCAFFOLDER_PLAN.md Delivery plan, scaffolder shipped
TODOS.md Internal tracker
QA-REVIEWER.md Internal QA notes
DESIGN.md Internal design notes (1 comment ref stripped)

Two source files pointed at removed docs via comments — refs stripped (apps/web/emails/sign-in-magic-link.tsx, supabase-admin.ts). The mechanism each comment described still holds; only the doc-link was load-bearing.

Two more local-only handoff docs (DEVICE_FLOW_PROMPT.md, NEXT_SESSION_PROMPT.md) were never tracked and removed locally.

Test plan

  • pnpm --filter web typecheck — clean
  • No template/scaffold leak: apps/web/components.json is independent of packages/create-helpbase/templates/components.json (generated, not copied)
  • TAILARK_API_KEY lives in gitignored .env.local, never enters git history
  • Smoke: cd apps/web && pnpm dlx shadcn@latest list @tailark-pro after merge — verify registry auth works

🤖 Generated with Claude Code

Summary by CodeRabbit

  • New Features

    • Integrated shadcn MCP server to enable component management capabilities
    • Configured Tailark Pro component registry with secure API key authentication
  • Documentation

    • Removed internal planning and reference documentation including CLI development roadmap, device flow plan, design system guidelines, QA procedures, scaffolder implementation plan, and project backlog tracking

Dev-environment plumbing (no scaffold/template impact, no public-folder
leak — verified: scripts/sync-templates.mjs generates template
components.json from a hardcoded literal, doesn't copy from apps/web):

- .mcp.json: add `shadcn` MCP server alongside supabase. Lets Claude
  Code use the shadcn registry tools when working in this repo.
- apps/web/components.json: add @tailark-pro registry pointing at
  https://pro.tailark.com/registry/{name}, auth via TAILARK_API_KEY
  env var. Key lives in apps/web/.env.local (gitignored, not committed).
  Use: `pnpm dlx shadcn@latest add @tailark-pro/<name>` from apps/web.

Repo hygiene — remove 6 internal planning/handoff docs that don't
belong in a public repo:
- CLI_DX_PLAN.md, DEVICE_FLOW_PLAN.md, UNIFIED_SCAFFOLDER_PLAN.md
  (delivery plans, work already shipped)
- TODOS.md (internal tracker), QA-REVIEWER.md (internal QA notes)
- DESIGN.md (internal design source — single comment ref stripped)

Two files in source pointed at removed docs via comments — those refs
stripped (apps/web/emails/sign-in-magic-link.tsx, supabase-admin.ts).
The actual mechanism the comment described still holds; only the link
was load-bearing.

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

vercel Bot commented Apr 19, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
helpbase Ready Ready Preview, Comment Apr 19, 2026 9:12am

Request Review

@coderabbitai

coderabbitai Bot commented Apr 19, 2026 •

Copy link
Copy Markdown

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c826a98a-6c80-4178-8a9a-b2cf5923ebc4

📥 Commits

Reviewing files that changed from the base of the PR and between 54be00d and 35022c1.

📒 Files selected for processing (10)
  • .mcp.json
  • CLI_DX_PLAN.md
  • DESIGN.md
  • DEVICE_FLOW_PLAN.md
  • QA-REVIEWER.md
  • TODOS.md
  • UNIFIED_SCAFFOLDER_PLAN.md
  • apps/web/components.json
  • apps/web/emails/sign-in-magic-link.tsx
  • apps/web/lib/supabase-admin.ts
💤 Files with no reviewable changes (6)
  • DEVICE_FLOW_PLAN.md
  • CLI_DX_PLAN.md
  • DESIGN.md
  • QA-REVIEWER.md
  • TODOS.md
  • UNIFIED_SCAFFOLDER_PLAN.md

📝 Walkthrough

Walkthrough

Removed multiple planning and design documentation files, added shadcn MCP server configuration, integrated tailark-pro component registry, and updated code comments to remove references to deleted documentation.

Changes

Cohort / File(s) Summary
Documentation Cleanup
CLI_DX_PLAN.md, DESIGN.md, DEVICE_FLOW_PLAN.md, QA-REVIEWER.md, TODOS.md, UNIFIED_SCAFFOLDER_PLAN.md
Removed planning, design system, QA workflow, and task tracking documentation files (1,478 total lines deleted).
MCP Server Configuration
.mcp.json
Added new shadcn MCP server entry configured to launch via npx shadcn@latest mcp.
Component Registry
apps/web/components.json
Added @tailark-pro registry configuration with URL template and TAILARK_API_KEY authorization header.
Comment Updates
apps/web/emails/sign-in-magic-link.tsx, apps/web/lib/supabase-admin.ts
Removed outdated references to deleted documentation and obsolete date annotations in code comments.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 Hop, skip, and away go the plans so grand,
Filing cabinets cleared with a wave of my paw—
But look! New tools arrive with shadcn's call,
And registries bloom in the spring of it all!
Less clutter, more code, let's build something tall. 🌱

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately describes the main changes: adding shadcn MCP, Tailark Pro registry, and removing 6 internal documentation files.
Description check ✅ Passed The description is comprehensive and well-structured, covering all key changes with clear explanations. It includes summary, rationale, config changes, repo cleanup details, and test plan verification.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch chore/internal-md-cleanup-plus-tailark

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@Codehagen
Codehagen merged commit ae1d8b0 into main Apr 19, 2026
5 checks passed
@Codehagen
Codehagen deleted the chore/internal-md-cleanup-plus-tailark branch April 19, 2026 09:16

This branch was successfully deployed

1 active deployment
Preview — 35022c10 Deployed Apr 19, 2026 by vercel[bot]
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