| name | add-collection |
| description | Introduce a new Library collection ID with schema, i18n, Collection Explorer card, and docs catalog row. Use when adding industry verticals or curated resource groups like gym, clinic, restaurant. |
| metadata | {"tags":"collections, schema, i18n, library, docs"} |
Add Collection
Collections group resources in the Library Collection Explorer (e.g. gym, clinic, restaurant). Resources join via collections: [my-collection] in frontmatter or heuristics in resource-collections.ts.
When to use
- New industry vertical or themed bundle in the Library
- Curated filter preset users browse as a first-class collection
- ROADMAP phase delivering a vertical (Restaurant, Salon, Real Estate, …)
Wiring checklist (all five required)
1. Schema enum
packages/schema/src/schema.ts — add to ResourceCollectionSchema:
z.enum([..., "my-collection"])
Also update packages/schema/src/types.ts if types are duplicated there.
2. Astro content config
apps/www/src/content/config.ts — mirror the enum in the content collection schema.
3. Collection Explorer card
apps/www/src/lib/collections.ts — add an entry:
{
id: "my-collection",
titleKey: "collection.my-collection.title",
descKey: "collection.my-collection.desc",
accentToken: "emerald",
order: 50,
}
4. i18n labels
apps/www/src/i18n/index.ts — for each locale block:
"collection.my-collection.title": "My Collection",
"collection.my-collection.desc": "Short description for the explorer card.",
5. Docs catalog
apps/docs/src/content/docs/collections.mdx — add a row to the All collections table (ID, title, purpose, link).
For industry verticals, also add a row in apps/docs/src/content/docs/choose-your-path.mdx.
Optional: auto-join heuristics
apps/www/src/lib/resource-collections.ts — extend heuristics so resources auto-join the collection from tags/title without explicit collections: frontmatter.
Assign resources
In resource frontmatter:
collections: [my-collection]
Verify
bun run lint
bun run build:www
bun run build:docs
- Library Collection Explorer shows the new card
- Filtering by collection returns assigned resources
- Docs:
http://localhost:4322/collections/
Related
- Resource authoring:
content-authoring
- Batch vertical builds:
PHASE-WORKFLOW.md
- Heuristics file:
apps/www/src/lib/resource-collections.ts
