@lupinum/ginko-content 1.0.0-beta.7 → 1.0.0-beta.9

package/README.md

@@ -15,7 +15,7 @@
 </p>
 
 > [!WARNING]
-> Version `1.0.0-beta.7` is a prerelease. Install it from npm's `next`
+> Version `1.0.0-beta.9` is a prerelease. Install it from npm's `next`
 > channel. The stable `0.3` line remains on `latest`.
 
 ## Why use this package?
@@ -40,13 +40,13 @@ output.
 Use the Nuxt CLI:
 
 ```bash
-npx nuxi module add @lupinum/ginko-content@1.0.0-beta.7
+npx nuxi module add @lupinum/ginko-content@1.0.0-beta.9
 ```
 
 Or install and register the module by hand:
 
 ```bash
-pnpm add @lupinum/ginko-content@1.0.0-beta.7
+pnpm add @lupinum/ginko-content@1.0.0-beta.9
 ```
 
 ```ts
@@ -56,6 +56,33 @@ export default defineNuxtConfig({
 })
 ```
 
+<!-- BEGIN:consumer-onboarding -->
+
+### Use a coding agent
+
+A coding agent is a development tool that can inspect and change your project.
+
+After installation, copy this prompt into your agent:
+
+```text
+Add Ginko Content to this Nuxt application and render a Markdown page.
+Read the project's existing instructions first. Resolve
+@lupinum/ginko-content/agent-docs from this application's directory and read
+its starting pages. Use the installed version's examples and public types.
+Preserve existing routes, conventions, and AGENTS.md instructions. Add or
+update one short Ginko Content pointer in AGENTS.md if the project allows it;
+do not duplicate the documentation. If the file is absent, create only that
+pointer. Report missing guidance. Verify the page, links, and a missing route.
+```
+
+If the installed package has no `agent-docs` export, read its packaged README
+and types. Use documentation from the matching source tag when more detail is
+needed. Installing or updating the package does not edit project instructions.
+The pointer resolves the installed package, so upgrades and rollbacks select
+the matching documentation without copying it into your application.
+
+<!-- END:consumer-onboarding -->
+
 ## Quick start
 
 Define a collection:

package/dist/agent/AGENTS.md

@@ -0,0 +1,60 @@
+# @lupinum/ginko-content
+
+Documentation for installed version 1.0.0-beta.9.
+
+Read the relevant local pages before changing this package’s integration.
+Project instructions govern architecture, style and permissions.
+
+## Start here
+
+- [Quickstart](./pages/docs/get-started/quickstart.md) — /docs/get-started/quickstart
+- [Package exports](./pages/docs/reference/package-exports.md) — /docs/reference/package-exports
+
+## Find a page
+
+The index below maps public documentation routes to this installed snapshot.
+For links to this documentation site, use the matching local page in manifest.json
+instead of fetching a possibly different website version. Preserve URL fragments.
+External dependencies have their own versioned contracts. Report missing guidance.
+
+- [Build a blog](./pages/docs/build/blog.md) — /docs/build/blog
+- [Build a documentation site](./pages/docs/build/documentation-site.md) — /docs/build/documentation-site
+- [Build a multilingual site](./pages/docs/build/multilingual-site.md) — /docs/build/multilingual-site
+- [Add search and navigation](./pages/docs/build/search-and-navigation.md) — /docs/build/search-and-navigation
+- [How Ginko thinks](./pages/docs/concepts/how-ginko-thinks.md) — /docs/concepts/how-ginko-thinks
+- [Why Ginko (and when not)](./pages/docs/concepts/why-ginko.md) — /docs/concepts/why-ginko
+- [Quickstart](./pages/docs/get-started/quickstart.md) — /docs/get-started/quickstart
+- [Publish agent-readable content](./pages/docs/guides/agent-readable-output.md) — /docs/guides/agent-readable-output
+- [Model data collections and references](./pages/docs/guides/data-collections-and-references.md) — /docs/guides/data-collections-and-references
+- [Data-source adapters](./pages/docs/guides/data-source-adapters.md) — /docs/guides/data-source-adapters
+- [Hide drafts and partials](./pages/docs/guides/drafts-and-partials.md) — /docs/guides/drafts-and-partials
+- [Add typed frontmatter](./pages/docs/guides/frontmatter-and-schemas.md) — /docs/guides/frontmatter-and-schemas
+- [Use Vue components in Markdown](./pages/docs/guides/mdc-components.md) — /docs/guides/mdc-components
+- [Build content navigation](./pages/docs/guides/navigation.md) — /docs/guides/navigation
+- [Add provider search and caching](./pages/docs/guides/provider-search-and-caching.md) — /docs/guides/provider-search-and-caching
+- [Connect an external content source](./pages/docs/guides/providers.md) — /docs/guides/providers
+- [Route, link, and redirect content](./pages/docs/guides/routes-links-and-redirects.md) — /docs/guides/routes-links-and-redirects
+- [Choose a search engine](./pages/docs/guides/search-engines.md) — /docs/guides/search-engines
+- [Generate a sitemap and prerender pages](./pages/docs/guides/sitemap-and-prerender.md) — /docs/guides/sitemap-and-prerender
+- [Translate URL slugs](./pages/docs/guides/translated-slugs.md) — /docs/guides/translated-slugs
+- [Migration](./pages/docs/migration.md) — /docs/migration
+- [Move filesystem content to a CMS](./pages/docs/migration/filesystem-to-cms.md) — /docs/migration/filesystem-to-cms
+- [From Nuxt Content v2](./pages/docs/migration/from-nuxt-content-v2.md) — /docs/migration/from-nuxt-content-v2
+- [From Nuxt Content v3](./pages/docs/migration/from-nuxt-content-v3.md) — /docs/migration/from-nuxt-content-v3
+- [Ginko version upgrades](./pages/docs/migration/ginko-version-upgrades.md) — /docs/migration/ginko-version-upgrades
+- [Reference](./pages/docs/reference.md) — /docs/reference
+- [Components](./pages/docs/reference/components.md) — /docs/reference/components
+- [Composables](./pages/docs/reference/composables.md) — /docs/reference/composables
+- [content.config.ts](./pages/docs/reference/content-config.md) — /docs/reference/content-config
+- [Document envelope](./pages/docs/reference/document-envelope.md) — /docs/reference/document-envelope
+- [Module options](./pages/docs/reference/module-options.md) — /docs/reference/module-options
+- [Package exports](./pages/docs/reference/package-exports.md) — /docs/reference/package-exports
+- [Provider contract](./pages/docs/reference/provider-contract.md) — /docs/reference/provider-contract
+- [Query API](./pages/docs/reference/query-api.md) — /docs/reference/query-api
+- [Query operators](./pages/docs/reference/query-operators.md) — /docs/reference/query-operators
+- [Server API](./pages/docs/reference/server-api.md) — /docs/reference/server-api
+- [Deployment](./pages/docs/resources/deployment.md) — /docs/resources/deployment
+- [Design principles](./pages/docs/resources/design-principles.md) — /docs/resources/design-principles
+- [Examples](./pages/docs/resources/examples.md) — /docs/resources/examples
+- [Support and stability](./pages/docs/resources/support-and-stability.md) — /docs/resources/support-and-stability
+- [Troubleshooting](./pages/docs/resources/troubleshooting.md) — /docs/resources/troubleshooting

package/dist/agent/manifest.json

@@ -0,0 +1,299 @@
+{
+  "schemaVersion": 1,
+  "name": "@lupinum/ginko-content",
+  "version": "1.0.0-beta.9",
+  "entrySha256": "7cc59f759b37eb49e601dd12251591dfe6b5ed64e61a02e0f45e6f7dc89b5b3d",
+  "startRoutes": [
+    "/docs/get-started/quickstart",
+    "/docs/reference/package-exports"
+  ],
+  "pages": [
+    {
+      "title": "Build a blog",
+      "route": "/docs/build/blog",
+      "url": "https://ginko-content.lupinum.com/docs/build/blog",
+      "file": "pages/docs/build/blog.md",
+      "sha256": "50e0a348cf86475ed3ebfbcebd3ce4b2d85a2fe2390165c323b8d89a753d89d3"
+    },
+    {
+      "title": "Build a documentation site",
+      "route": "/docs/build/documentation-site",
+      "url": "https://ginko-content.lupinum.com/docs/build/documentation-site",
+      "file": "pages/docs/build/documentation-site.md",
+      "sha256": "939fdf188eed81d525c35a87af8df22e36fb8b4009e550109d1a9be3c3ff5b90"
+    },
+    {
+      "title": "Build a multilingual site",
+      "route": "/docs/build/multilingual-site",
+      "url": "https://ginko-content.lupinum.com/docs/build/multilingual-site",
+      "file": "pages/docs/build/multilingual-site.md",
+      "sha256": "355c43f3400fa91602157fe00f681ecb42d4c69a85cbb5f1e4a010e53ae54ab7"
+    },
+    {
+      "title": "Add search and navigation",
+      "route": "/docs/build/search-and-navigation",
+      "url": "https://ginko-content.lupinum.com/docs/build/search-and-navigation",
+      "file": "pages/docs/build/search-and-navigation.md",
+      "sha256": "4ef7eadb2a83988d2e8bda17b1f6a0b93e9bf0893ec156c03644de7fb0b260b0"
+    },
+    {
+      "title": "How Ginko thinks",
+      "route": "/docs/concepts/how-ginko-thinks",
+      "url": "https://ginko-content.lupinum.com/docs/concepts/how-ginko-thinks",
+      "file": "pages/docs/concepts/how-ginko-thinks.md",
+      "sha256": "65681a11930aed14c28075d8274956d54d966eac34b9d24853852e975b89fffa"
+    },
+    {
+      "title": "Why Ginko (and when not)",
+      "route": "/docs/concepts/why-ginko",
+      "url": "https://ginko-content.lupinum.com/docs/concepts/why-ginko",
+      "file": "pages/docs/concepts/why-ginko.md",
+      "sha256": "d59797eb52b9a629f86c15b136a69cafa4c558073e4c4f2fd1b876ec79da39c1"
+    },
+    {
+      "title": "Quickstart",
+      "route": "/docs/get-started/quickstart",
+      "url": "https://ginko-content.lupinum.com/docs/get-started/quickstart",
+      "file": "pages/docs/get-started/quickstart.md",
+      "sha256": "096dc1cf66802cab9866f5655adcf916c29e2458a59bf3dff105067afa994150"
+    },
+    {
+      "title": "Publish agent-readable content",
+      "route": "/docs/guides/agent-readable-output",
+      "url": "https://ginko-content.lupinum.com/docs/guides/agent-readable-output",
+      "file": "pages/docs/guides/agent-readable-output.md",
+      "sha256": "9ea42aea957f1a460f0e669a0892423931779ca8278634845c2aea186893b3fe"
+    },
+    {
+      "title": "Model data collections and references",
+      "route": "/docs/guides/data-collections-and-references",
+      "url": "https://ginko-content.lupinum.com/docs/guides/data-collections-and-references",
+      "file": "pages/docs/guides/data-collections-and-references.md",
+      "sha256": "77a08618193ef2ff28c2fdb585cb87250fa5b65aa7553a43ccdb02c9ccec7bee"
+    },
+    {
+      "title": "Data-source adapters",
+      "route": "/docs/guides/data-source-adapters",
+      "url": "https://ginko-content.lupinum.com/docs/guides/data-source-adapters",
+      "file": "pages/docs/guides/data-source-adapters.md",
+      "sha256": "21dcd71b3e84435d1d45f51b96f2016c390e0ee69f8d06371a76457c1c0b4061"
+    },
+    {
+      "title": "Hide drafts and partials",
+      "route": "/docs/guides/drafts-and-partials",
+      "url": "https://ginko-content.lupinum.com/docs/guides/drafts-and-partials",
+      "file": "pages/docs/guides/drafts-and-partials.md",
+      "sha256": "54dbf62ada25b13d1c08ddc439e8e261f51f8484a2bd4efa061160d0b0f71ce2"
+    },
+    {
+      "title": "Add typed frontmatter",
+      "route": "/docs/guides/frontmatter-and-schemas",
+      "url": "https://ginko-content.lupinum.com/docs/guides/frontmatter-and-schemas",
+      "file": "pages/docs/guides/frontmatter-and-schemas.md",
+      "sha256": "d2239de28370cd9f268a4f9551142c99635c178ce328cde98091294c13b28570"
+    },
+    {
+      "title": "Use Vue components in Markdown",
+      "route": "/docs/guides/mdc-components",
+      "url": "https://ginko-content.lupinum.com/docs/guides/mdc-components",
+      "file": "pages/docs/guides/mdc-components.md",
+      "sha256": "13d6453a0fbf4dcbe99f60a626184a2b804ea711001070771a4106689ff46e97"
+    },
+    {
+      "title": "Build content navigation",
+      "route": "/docs/guides/navigation",
+      "url": "https://ginko-content.lupinum.com/docs/guides/navigation",
+      "file": "pages/docs/guides/navigation.md",
+      "sha256": "0cb01c4744c0566e1864d0dbb580717829b4df390bde5a76862eae633b2d10e3"
+    },
+    {
+      "title": "Add provider search and caching",
+      "route": "/docs/guides/provider-search-and-caching",
+      "url": "https://ginko-content.lupinum.com/docs/guides/provider-search-and-caching",
+      "file": "pages/docs/guides/provider-search-and-caching.md",
+      "sha256": "41aa21af47c57c32b9ebe0770fdcb90ecc8b26e584c9a968fb1377e575f78a98"
+    },
+    {
+      "title": "Connect an external content source",
+      "route": "/docs/guides/providers",
+      "url": "https://ginko-content.lupinum.com/docs/guides/providers",
+      "file": "pages/docs/guides/providers.md",
+      "sha256": "2ff9e60b33a008a193efd16c162fc35825366b80f75d0c689018f84aab2b0df9"
+    },
+    {
+      "title": "Route, link, and redirect content",
+      "route": "/docs/guides/routes-links-and-redirects",
+      "url": "https://ginko-content.lupinum.com/docs/guides/routes-links-and-redirects",
+      "file": "pages/docs/guides/routes-links-and-redirects.md",
+      "sha256": "191bec49db54d2617db6931a9a59f89e39d77a5eda3993d9819576c15f25eae3"
+    },
+    {
+      "title": "Choose a search engine",
+      "route": "/docs/guides/search-engines",
+      "url": "https://ginko-content.lupinum.com/docs/guides/search-engines",
+      "file": "pages/docs/guides/search-engines.md",
+      "sha256": "ecfea550109285a399fddc58f70b9484a71b28751076284474eb4f70f0cad32b"
+    },
+    {
+      "title": "Generate a sitemap and prerender pages",
+      "route": "/docs/guides/sitemap-and-prerender",
+      "url": "https://ginko-content.lupinum.com/docs/guides/sitemap-and-prerender",
+      "file": "pages/docs/guides/sitemap-and-prerender.md",
+      "sha256": "9a2f1426693fd21deeec06bf18d1f24e72cb6800686d8a218e4c2def1a678875"
+    },
+    {
+      "title": "Translate URL slugs",
+      "route": "/docs/guides/translated-slugs",
+      "url": "https://ginko-content.lupinum.com/docs/guides/translated-slugs",
+      "file": "pages/docs/guides/translated-slugs.md",
+      "sha256": "c566944a71f7ec96f78b01a5ab70c1adcea89c6ac051b7665ca70544de9eb1e6"
+    },
+    {
+      "title": "Migration",
+      "route": "/docs/migration",
+      "url": "https://ginko-content.lupinum.com/docs/migration",
+      "file": "pages/docs/migration.md",
+      "sha256": "6b53bfd7b8f7fa34b7c067a2cb47060a7f1548b9f7e464ce4f9fe32442b72aa1"
+    },
+    {
+      "title": "Move filesystem content to a CMS",
+      "route": "/docs/migration/filesystem-to-cms",
+      "url": "https://ginko-content.lupinum.com/docs/migration/filesystem-to-cms",
+      "file": "pages/docs/migration/filesystem-to-cms.md",
+      "sha256": "805c6149bfcdbcafad1c75d2ef243ff7bf6f4c9a962961dd854019a0b24d9afc"
+    },
+    {
+      "title": "From Nuxt Content v2",
+      "route": "/docs/migration/from-nuxt-content-v2",
+      "url": "https://ginko-content.lupinum.com/docs/migration/from-nuxt-content-v2",
+      "file": "pages/docs/migration/from-nuxt-content-v2.md",
+      "sha256": "c22bb498d31986679b972574275ba54c59ed446ec6acb71f8cbb753e020e41a0"
+    },
+    {
+      "title": "From Nuxt Content v3",
+      "route": "/docs/migration/from-nuxt-content-v3",
+      "url": "https://ginko-content.lupinum.com/docs/migration/from-nuxt-content-v3",
+      "file": "pages/docs/migration/from-nuxt-content-v3.md",
+      "sha256": "4a026da34385d4493f909ee6a10bc154ae58de9964e6448f6207fcb459440714"
+    },
+    {
+      "title": "Ginko version upgrades",
+      "route": "/docs/migration/ginko-version-upgrades",
+      "url": "https://ginko-content.lupinum.com/docs/migration/ginko-version-upgrades",
+      "file": "pages/docs/migration/ginko-version-upgrades.md",
+      "sha256": "90ef769b62f71b8086b5d76ea45875395646f65d4664a5298bd0105fc80008d1"
+    },
+    {
+      "title": "Reference",
+      "route": "/docs/reference",
+      "url": "https://ginko-content.lupinum.com/docs/reference",
+      "file": "pages/docs/reference.md",
+      "sha256": "7ee104b2baf39b1b189419886f95a4f426cc9adffe384301df5a8dbae74b526a"
+    },
+    {
+      "title": "Components",
+      "route": "/docs/reference/components",
+      "url": "https://ginko-content.lupinum.com/docs/reference/components",
+      "file": "pages/docs/reference/components.md",
+      "sha256": "6b5c728c4fe9490b99baa9335459395b6d226691a28592b6039a605acb4e6a78"
+    },
+    {
+      "title": "Composables",
+      "route": "/docs/reference/composables",
+      "url": "https://ginko-content.lupinum.com/docs/reference/composables",
+      "file": "pages/docs/reference/composables.md",
+      "sha256": "8abd6f89dc3b4364b03797f36d6b0af89daa2348ac5eb90a12a4dd15f537aea9"
+    },
+    {
+      "title": "content.config.ts",
+      "route": "/docs/reference/content-config",
+      "url": "https://ginko-content.lupinum.com/docs/reference/content-config",
+      "file": "pages/docs/reference/content-config.md",
+      "sha256": "986c0be15733b79ae8f0d00eb844862e9a1446bdc2fce8c6655aa3232044aaf7"
+    },
+    {
+      "title": "Document envelope",
+      "route": "/docs/reference/document-envelope",
+      "url": "https://ginko-content.lupinum.com/docs/reference/document-envelope",
+      "file": "pages/docs/reference/document-envelope.md",
+      "sha256": "3c178f34b1ce92789292add1eff8572c44716f385316387c2b2295714d8a0c19"
+    },
+    {
+      "title": "Module options",
+      "route": "/docs/reference/module-options",
+      "url": "https://ginko-content.lupinum.com/docs/reference/module-options",
+      "file": "pages/docs/reference/module-options.md",
+      "sha256": "293559058ad8b5e696c1c66ed5e91fab9908b71b8de7a77001a3db1b08aeaaa5"
+    },
+    {
+      "title": "Package exports",
+      "route": "/docs/reference/package-exports",
+      "url": "https://ginko-content.lupinum.com/docs/reference/package-exports",
+      "file": "pages/docs/reference/package-exports.md",
+      "sha256": "7d3dde402416a63ebf1aa6a7007494f197be47116c16bc71fe1851af1cc609a7"
+    },
+    {
+      "title": "Provider contract",
+      "route": "/docs/reference/provider-contract",
+      "url": "https://ginko-content.lupinum.com/docs/reference/provider-contract",
+      "file": "pages/docs/reference/provider-contract.md",
+      "sha256": "0bed35f6c2a7cef04da2c4ac513bfe7b2a3eadb28f6556dfbda8bfe822d6dc93"
+    },
+    {
+      "title": "Query API",
+      "route": "/docs/reference/query-api",
+      "url": "https://ginko-content.lupinum.com/docs/reference/query-api",
+      "file": "pages/docs/reference/query-api.md",
+      "sha256": "8de1e3eae111bd83d22222f665e3fbefac7ac036ead4ead664cb8965fef1c43b"
+    },
+    {
+      "title": "Query operators",
+      "route": "/docs/reference/query-operators",
+      "url": "https://ginko-content.lupinum.com/docs/reference/query-operators",
+      "file": "pages/docs/reference/query-operators.md",
+      "sha256": "14c5f6ecd9a17486dbaf4c884865d6eb3798e374cd7fd3d35d5bd1e74724289d"
+    },
+    {
+      "title": "Server API",
+      "route": "/docs/reference/server-api",
+      "url": "https://ginko-content.lupinum.com/docs/reference/server-api",
+      "file": "pages/docs/reference/server-api.md",
+      "sha256": "c061f069f34bb4221fc536c4724460488336f2bbe4569cc454b659698f2278a2"
+    },
+    {
+      "title": "Deployment",
+      "route": "/docs/resources/deployment",
+      "url": "https://ginko-content.lupinum.com/docs/resources/deployment",
+      "file": "pages/docs/resources/deployment.md",
+      "sha256": "80168cb7f63d8e22b332e27f18f97ff034833914007eb35a61150635d70488f3"
+    },
+    {
+      "title": "Design principles",
+      "route": "/docs/resources/design-principles",
+      "url": "https://ginko-content.lupinum.com/docs/resources/design-principles",
+      "file": "pages/docs/resources/design-principles.md",
+      "sha256": "8ec69437c92107b05e2889b36d371013bd09fa530141012312a442de28daefba"
+    },
+    {
+      "title": "Examples",
+      "route": "/docs/resources/examples",
+      "url": "https://ginko-content.lupinum.com/docs/resources/examples",
+      "file": "pages/docs/resources/examples.md",
+      "sha256": "fc21ee3197bee8d730df3981cfcd50405464d94603bfe0a4a31035bfa3b862e3"
+    },
+    {
+      "title": "Support and stability",
+      "route": "/docs/resources/support-and-stability",
+      "url": "https://ginko-content.lupinum.com/docs/resources/support-and-stability",
+      "file": "pages/docs/resources/support-and-stability.md",
+      "sha256": "ccad779f657029f829c51a625db549adf70db9c50e4a0b65c6915d49ef5f1536"
+    },
+    {
+      "title": "Troubleshooting",
+      "route": "/docs/resources/troubleshooting",
+      "url": "https://ginko-content.lupinum.com/docs/resources/troubleshooting",
+      "file": "pages/docs/resources/troubleshooting.md",
+      "sha256": "f93a193b208e1132099a124b7bf6c1f55f897cd82e43a7b3bb0700ef404d3f6d"
+    }
+  ]
+}

package/dist/agent/pages/docs/build/blog.md

@@ -0,0 +1,129 @@
+---
+title: "Build a blog"
+description: "Create typed post routes, previous/next links, and a paginated index."
+url: "https://ginko-content.lupinum.com/docs/build/blog"
+route: "/docs/build/blog"
+locale: "en"
+section: "Documentation"
+collection: "docs"
+source: "ginko-content"
+---
+
+> Create typed post routes, previous/next links, and a paginated index.
+
+Use a page collection for post routes and a regular Nuxt page for the index. Start with the collection.
+
+```ts [content.config.ts]
+import { defineCollection, defineContentConfig } from '@lupinum/ginko-content/config'
+import { z } from 'zod'
+
+export const posts = defineCollection({
+  type: 'page',
+  source: 'blog/**/*.md',
+  route: '/blog',
+  schema: z.object({
+    title: z.string(),
+    description: z.string(),
+    publishedAt: z.iso.datetime(),
+    tags: z.array(z.string()).default([]),
+    image: z.string().optional()
+  })
+})
+
+export default defineContentConfig({ collections: { posts } })
+```
+
+Every file under `content/blog/` now becomes a post at `/blog/<slug>`, and its frontmatter is checked against the schema. `publishedAt` is validated as an ISO datetime, so you can sort on it reliably. `tags` defaults to an empty array when you omit it.
+
+## Write a post
+
+```md [content/blog/first-post.md]
+---
+title: First post
+description: Why the content model stays collection-first.
+publishedAt: 2026-07-14T08:00:00.000Z
+tags:
+  - architecture
+---
+
+# First post
+
+The post body is Markdown.
+```
+
+## Render the post
+
+`useContentPage` loads the post for the current route. Pass `surround` to also get the neighbouring posts for previous and next links.
+
+```vue [app/pages/blog/[...slug\].vue]
+<script setup lang="ts">
+import { createError } from '#imports'
+import { posts } from '~~/content.config'
+
+definePageMeta({ key: route => route.path })
+
+const { page: post, previous, next } = await useContentPage(posts, {
+  surround: { select: ['description', 'publishedAt'] }
+})
+
+if (!post.value) {
+  throw createError({ statusCode: 404, statusMessage: 'Post not found', fatal: true })
+}
+</script>
+
+<template>
+  <article v-if="post">
+    <ContentRenderer :value="post" />
+
+    <nav aria-label="Adjacent posts">
+      <NuxtLink v-if="previous" :to="previous.path">
+        Previous: {{ previous.title }}
+      </NuxtLink>
+      <NuxtLink v-if="next" :to="next.path">
+        Next: {{ next.title }}
+      </NuxtLink>
+    </nav>
+  </article>
+</template>
+```
+
+The guards hide the previous link on the first post and the next link on the last.
+
+## Build a paginated index
+
+`paginate` returns one page of results plus paging metadata. Read the page number from `route.query.page`, and pass it to `watch` so the query re-runs when the URL changes. Give `useAsyncData` a key that includes the page number, so each page caches separately.
+
+```vue [app/pages/blog/index.vue]
+<script setup lang="ts">
+import { paginate } from '@lupinum/ginko-content/client'
+import { posts } from '~~/content.config'
+
+const route = useRoute()
+const pageNumber = computed(() =>
+  Math.max(1, Number.parseInt(String(route.query.page || 1), 10) || 1)
+)
+
+const { data: result } = await useAsyncData(
+  () => `blog:${pageNumber.value}`,
+  () => paginate(posts, {
+    mode: 'offset',
+    page: pageNumber.value,
+    limit: 12,
+    sort: { publishedAt: 'desc' },
+    select: ['title', 'description', 'publishedAt', 'tags', 'image']
+  }),
+  { watch: [pageNumber] }
+)
+</script>
+
+<template>
+  <article v-for="post in result?.data" :key="post.canonicalKey">
+    <NuxtLink :to="post.route.resolvedPath">{{ post.title }}</NuxtLink>
+    <p>{{ post.description }}</p>
+  </article>
+</template>
+```
+
+Link each card with `post.route.resolvedPath`, and use `post.canonicalKey` as the `v-for` key. Both come back even when you narrow the fields with `select`, so the card always knows where it points.
+
+Set `draft: true` in a post's frontmatter to keep it out of the production build while you finish it.