@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)