Restructure into a pnpm + Turborepo monorepo (library + docs, unified manifest) by devsaifmohamed · Pull Request #1 · devsaifmohamed/hookli

devsaifmohamed · 2026-07-16T12:43:27Z

Merges the library and docs into one repo with a single source of truth. Built and tested in a worktree; gate green.

What changed

Structure: library → `packages/hookli/`; docs → `apps/docs/` (brought in via `git subtree`, history preserved).
Tooling: pnpm + Turborepo. `pnpm build/test/lint/typecheck` green across both workspaces. Docs consume the library via `workspace:*` and prerender all 40 hook pages against the local build.
Single source of truth: `packages/hookli/hooks.manifest.json` (shipped + exported as `hookli/manifest`). The README hook-list + count badge are generated (`scripts/gen-readme.mjs`, on prepublishOnly); the docs registry imports the manifest (the hardcoded 40-entry array is gone). Version + hook-count + metadata now live in exactly one place.
Claude structure (Nzmly-style): root `CLAUDE.md` + per-workspace `CLAUDE.md`; `.claude/` with git-safety hooks + reusable commands/agents.
Ralph: root harness with a scoped `check.sh` — gates only the workspace that changed (via turbo filters).

After merge (human steps)

Vercel: set project Root Directory = `apps/docs`, install `pnpm install`, redeploy.
Archive `saifmohamedsv/hookli-docs` (its history now lives here under `apps/docs`).
Publish the library from `packages/hookli` as usual (human-gated, needs npm 2FA).

🤖 Generated with Claude Code

create-next-app (TS/Tailwind/App Router) with hookli@1.3.16 installed from npm for live demos, brand assets in public/, and the Ralph loop ported in: check.sh gate (lint + tsc + next build), docs-tuned prompt.md, prd.json seeded with 15 tasks (research usehooks-ts first -> design system -> landing -> per-hook doc pages with interactive demos -> search -> donation placeholder -> SEO/OG -> polish -> final QA). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

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

@theme

…oter, Wordmark) Brand tokens from docs/DESIGN.md as Tailwind v4 @theme vars; JetBrains Mono via next/font for headings/wordmark; root metadata (title template, svg favicon, separate viewport export); shared Header/Footer; boilerplate page/svgs/favicon.ico removed; interim branded home page (T3 builds the hero). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Hero headline reuses Wordmark with new xl size + steps() cursor blink (solid under prefers-reduced-motion); InstallCommand + CopyButton (2s check feedback, aria-live) as shared components for later reuse (footer/docs index per DESIGN.md); Copy/Check icons added to Icons.tsx. T3 marked done in prd.json. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…lock, useToggle demo) Six-feature grid with new lucide-style icons; LiveProofSection pairs a shiki-highlighted useToggle sample with the same hook running live, imported from the published hookli package. CodeBlock (css-variables theme wired to brand tokens in globals.css) + lib/shiki.ts are built for T6 reuse. shiki@4.3.1 added per DESIGN.md dependency policy. T4 marked done in prd.json. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…sidebar, [slug] scaffold) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…age (tabs, error boundary, API tables) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…orage (live demos, shared demo UI) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…rkMode (TTL countdown, scoped theme panel) + useToggle polish Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

…osition, useInfiniteScroll (dropdown, crosshair panel, window-scroll batches) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>