@core / kit-blog

1.0.1 ▾

1.0.1

認証済みMIT

GitHub

Next.js 向けブログキット：著者・カテゴリ・タグ・シリーズ付き記事、フィード、承認制コメント、ニュースレター

コード32 ファイルコンテキスト約 883 トークンスキャン合格

約 883 トークン→ src/app/(blog)/AGENTS.md→ .cursor/rules/genpm-core-kit-blog.mdc

これは AI が src/app/(blog) で作業するときに読む内容そのものです。それ以外はコンテキストに追加されません。

@core/kit-blog — rules for AI agents

Purpose

A complete blog on top of @core/kit-cms, edited in the same /admin: posts with rich text and cover images, author profiles, categories, tags and series, scheduling, RSS/Atom/JSON feeds, site search, moderated comments, newsletter with double opt-in and one-click unsubscribe, share links without third-party scripts and full SEO (BlogPosting JSON-LD, sitemap, Open Graph). Glue and templates only: logic lives in @core/blog, comments and newsletter.

Map

_templates/genpm.md — the exact lines this kit adds to the project's src/genpm/*.ts (generated, always current).
blog/page.tsx — index (featured first, ?page=). blog/[slug]/page.tsx — post.
blog/{category,tag,author,series}/[slug]/page.tsx — archives (shared _lib/archive.tsx). blog/archive/[year]/[month].
blog/feed.xml, blog/atom.xml, blog/feed.json — feeds. api/comments/[type]/[id] — comments (type post).
newsletter/{subscribe,confirm,unsubscribe} — routes; newsletter/{confirmed,unsubscribed,invalid} — pages.
_components/ — PostList, PostCard, Comments, SubscribeForm, ShareLinks, blog.css (the visual template).
_blocks/latest-posts.tsx — "Latest posts" block for CMS pages. _lib/campaign.ts — "Create newsletter campaign" action.

Integration

@core/kit-cms must be integrated first (follow its AGENTS.md if it was installed with this kit).
Env: NEWSLETTER_FROM, NEWSLETTER_POSTAL_ADDRESS, NEWSLETTER_SECRET (≥ 32 chars) and, in production, RESEND_API_KEY (see src/lib/newsletter/AGENTS.md). Explain to the person how to verify their sending domain (SPF, DKIM, DMARC) with their email provider; do not change their DNS yourself.
Migrations for @core/comments and @core/newsletter (src/lib/db/AGENTS.md).
Add the lines of _templates/genpm.md to the project's src/genpm/*.ts (it says which file and where): the blog collections, sitemap and search sources, the latestPosts block, and the admin resources (posts with "Create newsletter campaign", taxonomies, comments, newsletter) plus the pending-comments widget.
Add "Blog" to the header menu in Admin → Menus, and link the feeds from the site footer if wanted.
Verify: create an author and a post, schedule it, check it is absent from /blog, the feed and the sitemap until its time; comment as a guest (goes to moderation) and approve it; subscribe, confirm from the email and unsubscribe. Without an OAuth app nobody can sign in to the admin: an agent can create the author and posts with seedEntry / createEntry + publish (@core/content) from a script. Without RESEND_API_KEY, emails are printed to the console only under next dev (next start is production and refuses to send without a provider).

Conventions

Posts reference authors, categories, tags and series by slug; renaming a slug breaks links, so prefer editing names.
membersOnly posts show only the excerpt here; with @core/billing, decide access with hasEntitlement in blog/[slug]/page.tsx.
The templates in _components belong to the project after installation: adapt markup and blog.css freely.

Don't

Don't add third-party share or comment widgets (scripts and cookies without consent); keep plain links.
Don't import subscriber lists without demonstrable consent, and never remove the unsubscribe link or postal address.
Don't publish comments from guests without moderation unless the owner asks for it (moderation: 'guests').

# @core/kit-blog — rules for AI agents

## Purpose
A complete blog on top of @core/kit-cms, edited in the same `/admin`: posts with rich text and cover images, author
profiles, categories, tags and series, scheduling, RSS/Atom/JSON feeds, site search, moderated comments, newsletter
with double opt-in and one-click unsubscribe, share links without third-party scripts and full SEO (BlogPosting
JSON-LD, sitemap, Open Graph). Glue and templates only: logic lives in @core/blog, comments and newsletter.

## Map
- `_templates/genpm.md` — the exact lines this kit adds to the project's `src/genpm/*.ts` (generated, always current).
- `blog/page.tsx` — index (featured first, `?page=`). `blog/[slug]/page.tsx` — post.
- `blog/{category,tag,author,series}/[slug]/page.tsx` — archives (shared `_lib/archive.tsx`). `blog/archive/[year]/[month]`.
- `blog/feed.xml`, `blog/atom.xml`, `blog/feed.json` — feeds. `api/comments/[type]/[id]` — comments (type `post`).
- `newsletter/{subscribe,confirm,unsubscribe}` — routes; `newsletter/{confirmed,unsubscribed,invalid}` — pages.
- `_components/` — `PostList`, `PostCard`, `Comments`, `SubscribeForm`, `ShareLinks`, `blog.css` (the visual template).
- `_blocks/latest-posts.tsx` — "Latest posts" block for CMS pages. `_lib/campaign.ts` — "Create newsletter campaign" action.

## Integration
1. @core/kit-cms must be integrated first (follow its AGENTS.md if it was installed with this kit).
2. Env: `NEWSLETTER_FROM`, `NEWSLETTER_POSTAL_ADDRESS`, `NEWSLETTER_SECRET` (≥ 32 chars) and, in production,
   `RESEND_API_KEY` (see src/lib/newsletter/AGENTS.md). Explain to the person how to verify their sending domain
   (SPF, DKIM, DMARC) with their email provider; do not change their DNS yourself.
3. Migrations for @core/comments and @core/newsletter (src/lib/db/AGENTS.md).
4. Add the lines of `_templates/genpm.md` to the project's `src/genpm/*.ts` (it says which file and where): the blog
   collections, sitemap and search sources, the `latestPosts` block, and the admin resources (posts with "Create
   newsletter campaign", taxonomies, comments, newsletter) plus the pending-comments widget.
5. Add "Blog" to the header menu in Admin → Menus, and link the feeds from the site footer if wanted.
6. Verify: create an author and a post, schedule it, check it is absent from `/blog`, the feed and the sitemap until
   its time; comment as a guest (goes to moderation) and approve it; subscribe, confirm from the email and unsubscribe.
   Without an OAuth app nobody can sign in to the admin: an agent can create the author and posts with `seedEntry` /
   `createEntry` + `publish` (@core/content) from a script. Without `RESEND_API_KEY`, emails are printed to the console
   only under `next dev` (`next start` is production and refuses to send without a provider).

## Conventions
- Posts reference authors, categories, tags and series by slug; renaming a slug breaks links, so prefer editing names.
- `membersOnly` posts show only the excerpt here; with @core/billing, decide access with `hasEntitlement` in `blog/[slug]/page.tsx`.
- The templates in `_components` belong to the project after installation: adapt markup and `blog.css` freely.

## Don't
- Don't add third-party share or comment widgets (scripts and cookies without consent); keep plain links.
- Don't import subscriber lists without demonstrable consent, and never remove the unsubscribe link or postal address.
- Don't publish comments from guests without moderation unless the owner asks for it (`moderation: 'guests'`).

.genpmignore 適用後に組み込まれる正確なツリーです。固定先:

src/app/(blog)/_lib/widgets.ts読み取り専用 · fa952a4

// Widget del panel: comentarios pendientes de moderar (posts y, con kit-store, reseñas).
import type { AdminWidget } from '@/lib/admin';
import { commentsAdminResource } from '@/lib/comments';

export const pendingCommentsWidget: AdminWidget = {
  name: 'pending-comments',
  title: 'Comments to moderate',
  permission: 'comments:read',
  load: async (ctx) => ({ value: (await commentsAdminResource.list({ page: 1, pageSize: 1, filters: { status: 'pending' } }, ctx)).total }),
};

バージョン	コミット	公開日	スキャン
1.0.1	fa952a4	3 時間前	スキャン合格

$genpm add @core/kit-blog

組み込み先: src/app/(blog)
コミット
タグ: v1.0.1
必要: @core/blog ^1.0.0 @core/comments ^1.0.0 @core/kit-cms ^1.0.0 @core/newsletter ^1.1.0
npm: next >=15.5.0react ^19.0.0zod ^4.0.0
Env: NEWSLETTER_FROM NEWSLETTER_POSTAL_ADDRESS NEWSLETTER_SECRET
品質: 100/100
インストール数: 0 / 30日
公開日: 3 時間前 · genpm-system

README バッジ

[![genpm](https://api.genpm.net/v1/badge/@core/kit-blog.svg)](https://genpm.net/p/@core/kit-blog)