PR 2/17 of the catalog system rollout. Physical directory rename to
make room for registry/blocks/ and registry/components/ in future PRs.
No user-visible change.
## What
- git mv templates/ registry/examples/ (all 8 example dirs + templates.json)
- Update packages/cli/src/templates/remote.ts TEMPLATES_DIR path
constant from "templates" to "registry/examples"
- Update scripts/generate-template-previews.ts remoteTemplatesDir to
resolve(repoRoot, "registry/examples")
- Comment update in packages/cli/src/templates/generators.ts
## Why
- Current templates/ dir is a flat "things that scaffold" bucket. The
registry model splits content into examples (full projects — what
today's templates are), blocks (sub-compositions), and components
(effect snippets). registry/examples/ is the canonical home for
what was previously at templates/
- Making room for registry/blocks/ and registry/components/ without
top-level clutter
## How
- git mv preserves history. Remote fetch via giget follows TEMPLATES_DIR,
so updating that one constant is enough for the CLI's remote code path
- The CLI's internal templates/ dir (packages/cli/src/templates/) is a
different thing — it holds `blank` and `_shared` bundled assets plus
the fetch code. Not touched in this PR. Renaming that module belongs
to PR 3 (registry resolver + installer) where the abstraction changes
- templates.json keeps its existing shape and location (now at
registry/examples/templates.json). PR 3 will transform it to the new
registry.json shape introduced in PR 1 and generate a per-item
registry-item.json for each example. Leaving the shape change to PR 3
keeps this PR a pure physical move
## Test plan
- [x] bun run test in packages/cli: 55 passed, 4 pre-existing failures
(SRT/VTT whisper normalizer + lintProject clean-project test) —
identical to main. No regressions
- [x] Manual smoke test: hyperframes init /tmp/x --template blank works
(bundled code path, unchanged)
- [x] bunx oxfmt + bunx oxlint on changed files: clean
- [x] bun run typecheck (core + studio, pre-commit hook): clean
- [ ] Manual smoke test for remote fetch (--template warm-grain): will
work once this PR merges — giget resolves the new path against
GitHub main. Can't be verified locally since the remote path
doesn't exist on origin/main until this lands
## Breaking / migration
None for end users. The CLI flag --template continues to accept the
same template names; the only change is where they live in the repo.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
* refactor(cli): move templates to examples/ for remote fetching
* refactor(cli): rename examples/ to templates/ for clarity
Follows Remix/Vite convention — these are init scaffolds, not general examples.
* feat(docs): add template gallery page with visual previews
* fix(docs): remove invalid MDX heading anchors
* chore: retrigger CI
* feat(docs): merge gallery into templates page with hover-to-play video previews
- Consolidated gallery.mdx and templates.mdx into single templates.mdx
- Moved templates page to Getting Started section
- Added MP4 video previews rendered by hyperframes (hover to play)
- Custom JS for hover-to-play behavior (Mintlify strips JSX event handlers)
- 2-column grid for landscape, 3-column for portrait
- Remotion-style cards with gradient overlay labels
* fix(docs): update broken links after templates page move
* ci(regression): remove scripts/ from regression trigger paths
scripts/ contains dev utilities (lint, versioning, preview generation)
that don't affect the rendering engine.
## What
Add a script that uses `@hyperframes/producer` to render PNG thumbnails of each built-in template. Output goes to `docs/images/templates/`.
## Why
User feedback: "I would have loved more visual examples of what's actually possible. I had to scaffold every template just to see what they look like." This is the foundation for a visual template gallery in the docs.
## How
- New `scripts/generate-template-previews.ts` uses the producer's `createFileServer` + `createCaptureSession` + `captureFrame` APIs — hyperframes renders its own templates
- Patches out `__VIDEO_SRC__` placeholders (same logic as `init.ts`) so templates render without a video file
- Captures a frame at t=2s for each template (skips `blank` — it's just empty scaffolding)
- Handles varying dimensions (vignelli is 1080x1920 portrait)
- Adds `pnpm generate:previews` npm script
## Test plan
- [x] `pnpm generate:previews` generates 8 PNGs in `docs/images/templates/`
- [x] Each PNG is visually correct (verified by viewing)
- [x] `--only <template>` flag works for single template generation
- Replace hardcoded template list in build:copy with `cp -r src/templates/*`
so new templates are included automatically (kinetic-type, decision-tree,
product-promo, nyt-graph were missing from published package)
- Fix captions SKILL.md: reword `!` and `>` in inline backticks that
triggered Claude Code's bash permission checker
- Add scripts/lint-skills.ts to catch shell-unsafe patterns in SKILL.md
files (runs as part of `bun run lint` in CI)
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
The --tag flag was optional, which led to v0.1.11 and v0.1.12 being
bumped without tags — skipping npm publish entirely. Invert the default:
always commit + tag, with --no-tag as the escape hatch.
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
## Summary
- rewrite workspace protocol dependencies to publish-safe semver ranges before the npm publish workflow runs
- keep workspace protocol references in source manifests for normal monorepo development
- ensure the published `@hyperframes/producer` manifest no longer ships unresolved `workspace:` deps
## Why
The internal repo hit a Docker build failure because the published `@hyperframes/producer` metadata still contained `workspace:^` dependencies for `@hyperframes/core` and `@hyperframes/engine`. `npm install` cannot resolve those outside the monorepo, so the published package itself was the root cause.
## Validation
- `bun install --frozen-lockfile`
- `bun run build:producer`
- `bun run prepare:publish-manifests`
- `npm pack --workspace packages/core`
- `npm pack --workspace packages/engine`
- `npm pack --workspace packages/producer`
- installed the three tarballs together in a clean temp project with `npm install --ignore-scripts`
- extracted the producer tarball and verified its `package.json` contains `^0.1.3` for `@hyperframes/core` and `@hyperframes/engine`, not `workspace:^`
* fix(ci): update publish workflow to use bun install
pnpm-lock.yaml was removed in the bun migration but publish.yml
still referenced it. Use bun for install/build, keep pnpm for
publish (publishConfig overrides + --provenance).
* docs: update stale pnpm references to bun across docs and scripts
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
James