multisite-cms-mcp 1.2.4 → 1.3.0

package/dist/tools/get-example.js

@@ -37,9 +37,9 @@ A minimal manifest with static pages only:
 - \`file\` points to the HTML file in pages/ folder
 - \`editable: true\` allows inline editing in the CMS
 - \`defaultHeadHtml\` is injected into all pages`,
-    manifest_custom_paths: `# manifest.json with Custom CMS Paths
+    manifest_custom_paths: `# manifest.json with CMS Collections
 
-When your site uses different URLs than the defaults:
+Configure templates for your CMS collections:
 
 \`\`\`json
 {
@@ -58,26 +58,25 @@ When your site uses different URLs than the defaults:
     }
   ],
   "cmsTemplates": {
-    "blogIndex": "templates/insights_index.html",
-    "blogIndexPath": "/insights",
-    "blogPost": "templates/insights_detail.html",
-    "blogPostPath": "/insights",
-    "team": "templates/leadership.html",
-    "teamPath": "/about/leadership",
-    "downloads": "templates/resources.html",
-    "downloadsPath": "/resources",
-    "authorsIndex": "templates/contributors.html",
-    "authorDetail": "templates/contributor.html",
-    "authorsPath": "/contributors"
+    "postsIndex": "templates/posts_index.html",
+    "postsIndexPath": "/blog",
+    "postsDetail": "templates/posts_detail.html",
+    "postsDetailPath": "/blog",
+    "teamIndex": "templates/team.html",
+    "teamIndexPath": "/team",
+    "servicesIndex": "templates/services.html",
+    "servicesIndexPath": "/services",
+    "servicesDetail": "templates/service-detail.html",
+    "servicesDetailPath": "/services"
   }
 }
 \`\`\`
 
-**Path Configuration:**
-- \`blogIndexPath: "/insights"\` → Blog listing at /insights
-- \`blogPostPath: "/insights"\` → Posts at /insights/post-slug
-- \`teamPath: "/about/leadership"\` → Team page at /about/leadership
-- Both blogIndexPath and blogPostPath should usually match`,
+**Path Configuration Pattern:**
+- \`{collectionSlug}Index\` - Template file for listing page
+- \`{collectionSlug}IndexPath\` - URL for listing page
+- \`{collectionSlug}Detail\` - Template file for detail page
+- \`{collectionSlug}DetailPath\` - URL base for detail pages`,
     manifest_minimal_with_ui: `# Minimal manifest.json (Configure Templates via Settings UI)
 
 When you want to upload pages first and configure CMS templates later via the Settings UI:
@@ -115,21 +114,16 @@ When you want to upload pages first and configure CMS templates later via the Se
 
 **After uploading this package:**
 1. Go to Dashboard → Settings → CMS Templates
-2. Select "Blog" (/blog) as the Blog Index Template
-3. Select "Blog Post Template" (/blog-post) as the Blog Post Template
-4. Set the Blog URL Path (e.g., /blog)
-5. Click Save
+2. Configure template mappings for your collections
+3. Set URL paths
 
 **Benefits of this approach:**
 - Faster initial upload - no need to configure cmsTemplates in JSON
 - Visual UI makes it easier to understand the configuration
-- Can change template mappings without re-uploading the package
-- Good for iterating on template designs
+- Can change template mappings without re-uploading the package`,
+    blog_index_template: `# Blog/Posts Index Template
 
-**Note:** The editor will show a warning banner if you visit /blog before configuring the template.`,
-    blog_index_template: `# Blog Index Template
-
-Lists all blog posts with filtering options:
+Lists all posts with featured section (using a "posts" collection):
 
 \`\`\`html
 <main class="blog-page">
@@ -139,14 +133,14 @@ Lists all blog posts with filtering options:
   </header>
 
   <!-- Featured Post (first featured article) -->
-  {{#each blogs featured=true limit=1}}
+  {{#each posts featured=true limit=1}}
   <article class="featured-post">
-    {{#if mainImage}}
-      <img src="{{mainImage}}" alt="{{name}}" class="featured-image">
+    {{#if image}}
+      <img src="{{image}}" alt="{{name}}" class="featured-image">
     {{/if}}
     <div class="featured-content">
       <h2><a href="{{url}}">{{name}}</a></h2>
-      <p class="excerpt">{{postSummary}}</p>
+      <p class="excerpt">{{summary}}</p>
       <div class="meta">
         {{#if author}}
           <span class="author">By {{author.name}}</span>
@@ -159,18 +153,18 @@ Lists all blog posts with filtering options:
 
   <!-- All Posts Grid -->
   <div class="posts-grid">
-    {{#each blogs limit=12}}
+    {{#each posts limit=12 sort="publishedAt" order="desc"}}
     <article class="post-card">
-      {{#if thumbnailImage}}
-        <img src="{{thumbnailImage}}" alt="{{name}}">
+      {{#if thumbnail}}
+        <img src="{{thumbnail}}" alt="{{name}}">
       {{else}}
-        {{#if mainImage}}
-          <img src="{{mainImage}}" alt="{{name}}">
+        {{#if image}}
+          <img src="{{image}}" alt="{{name}}">
         {{/if}}
       {{/if}}
       <div class="card-content">
         <h3><a href="{{url}}">{{name}}</a></h3>
-        <p>{{postSummary}}</p>
+        <p>{{summary}}</p>
         {{#if author}}
           <span class="byline">{{author.name}}</span>
         {{/if}}
@@ -178,22 +172,26 @@ Lists all blog posts with filtering options:
     </article>
     {{/each}}
   </div>
+  
+  {{#unless posts}}
+    <p>No posts yet. Check back soon!</p>
+  {{/unless}}
 </main>
 \`\`\`
 
 **Key patterns:**
-- \`{{#each blogs featured=true limit=1}}\` for featured post
-- \`{{#each blogs limit=12}}\` for post grid
-- Always wrap images in \`{{#if mainImage}}\`
+- \`{{#each posts featured=true limit=1}}\` for featured post
+- \`{{#each posts limit=12 sort="publishedAt" order="desc"}}\` for post grid
+- Always wrap images in \`{{#if image}}\`
 - Use \`{{url}}\` for links to post detail page`,
     blog_post_template: `# Blog Post Detail Template
 
-Single blog post with author information:
+Single post page with author information (using a "posts" collection with author relation):
 
 \`\`\`html
 <article class="blog-post">
-  {{#if mainImage}}
-    <img src="{{mainImage}}" alt="{{name}}" class="hero-image">
+  {{#if image}}
+    <img src="{{image}}" alt="{{name}}" class="hero-image">
   {{/if}}
 
   <header class="post-header">
@@ -202,8 +200,8 @@ Single blog post with author information:
     <div class="post-meta">
       {{#if author}}
         <div class="author-info">
-          {{#if author.picture}}
-            <img src="{{author.picture}}" alt="{{author.name}}" class="author-avatar">
+          {{#if author.photo}}
+            <img src="{{author.photo}}" alt="{{author.name}}" class="author-avatar">
           {{/if}}
           <a href="{{author.url}}" class="author-name">{{author.name}}</a>
         </div>
@@ -212,30 +210,22 @@ Single blog post with author information:
     </div>
   </header>
 
-  {{#if postSummary}}
-    <p class="lead">{{postSummary}}</p>
+  {{#if summary}}
+    <p class="lead">{{summary}}</p>
   {{/if}}
 
   <div class="post-content">
-    {{{postBody}}}
+    {{{body}}}
   </div>
 
   {{#if author}}
   <aside class="author-box">
-    {{#if author.picture}}
-      <img src="{{author.picture}}" alt="{{author.name}}">
+    {{#if author.photo}}
+      <img src="{{author.photo}}" alt="{{author.name}}">
     {{/if}}
     <div class="author-details">
       <h3>About <a href="{{author.url}}">{{author.name}}</a></h3>
       {{{author.bio}}}
-      <div class="social-links">
-        {{#if author.twitterProfileLink}}
-          <a href="{{author.twitterProfileLink}}">Twitter</a>
-        {{/if}}
-        {{#if author.linkedinProfileLink}}
-          <a href="{{author.linkedinProfileLink}}">LinkedIn</a>
-        {{/if}}
-      </div>
     </div>
   </aside>
   {{/if}}
@@ -243,11 +233,13 @@ Single blog post with author information:
 \`\`\`
 
 **IMPORTANT:**
-- \`{{{postBody}}}\` uses TRIPLE braces (contains HTML)
+- \`{{{body}}}\` uses TRIPLE braces (contains HTML)
 - \`{{{author.bio}}}\` uses TRIPLE braces (contains HTML)
 - Everything else uses double braces`,
     team_template: `# Team Members Template
 
+Using a "team" collection with name, role, photo, bio, order fields:
+
 \`\`\`html
 <section class="team-section">
   <header class="section-header">
@@ -279,9 +271,10 @@ Single blog post with author information:
 
 **Key points:**
 - \`sort="order" order="asc"\` maintains manual ordering
-- \`{{{bio}}}\` uses triple braces for HTML content
-- \`{{photo}}\` not \`{{picture}}\` (that's for authors)`,
-    downloads_template: `# Downloads Template
+- \`{{{bio}}}\` uses triple braces for HTML content`,
+    downloads_template: `# Downloads/Resources Template
+
+Using a "downloads" collection with name, description, fileUrl, category fields:
 
 \`\`\`html
 <section class="downloads-section">
@@ -294,7 +287,7 @@ Single blog post with author information:
     {{#each downloads sort="order" order="asc"}}
     <div class="download-item">
       <div class="download-info">
-        <h3>{{title}}</h3>
+        <h3>{{name}}</h3>
         {{#if description}}
           <p>{{description}}</p>
         {{/if}}
@@ -309,11 +302,11 @@ Single blog post with author information:
     {{/each}}
   </div>
 </section>
-\`\`\`
-
-**Note:** Downloads uses \`{{title}}\` not \`{{name}}\``,
+\`\`\``,
     authors_template: `# Authors Index Template
 
+Using an "authors" collection:
+
 \`\`\`html
 <section class="authors-section">
   <header class="section-header">
@@ -323,8 +316,8 @@ Single blog post with author information:
   <div class="authors-grid">
     {{#each authors}}
     <a href="{{url}}" class="author-card">
-      {{#if picture}}
-        <img src="{{picture}}" alt="{{name}}" class="author-photo">
+      {{#if photo}}
+        <img src="{{photo}}" alt="{{name}}" class="author-photo">
       {{/if}}
       <h3>{{name}}</h3>
       {{#if bio}}
@@ -337,11 +330,13 @@ Single blog post with author information:
 \`\`\``,
     author_detail_template: `# Author Detail Template
 
+Using an "authors" collection with detail pages:
+
 \`\`\`html
 <article class="author-detail">
   <header class="author-header">
-    {{#if picture}}
-      <img src="{{picture}}" alt="{{name}}" class="author-photo-large">
+    {{#if photo}}
+      <img src="{{photo}}" alt="{{name}}" class="author-photo-large">
     {{/if}}
     <h1>{{name}}</h1>
     
@@ -349,11 +344,11 @@ Single blog post with author information:
       {{#if email}}
         <a href="mailto:{{email}}">Email</a>
       {{/if}}
-      {{#if twitterProfileLink}}
-        <a href="{{twitterProfileLink}}">Twitter</a>
+      {{#if twitter}}
+        <a href="{{twitter}}">Twitter</a>
       {{/if}}
-      {{#if linkedinProfileLink}}
-        <a href="{{linkedinProfileLink}}">LinkedIn</a>
+      {{#if linkedin}}
+        <a href="{{linkedin}}">LinkedIn</a>
       {{/if}}
     </div>
   </header>
@@ -362,27 +357,30 @@ Single blog post with author information:
     <div class="author-bio">{{{bio}}}</div>
   {{/if}}
 
+  <!-- Show posts by this author (if you have a posts collection with author relation) -->
   <section class="author-articles">
     <h2>Articles by {{name}}</h2>
     <div class="articles-grid">
-      {{#each blogs where="author.slug:{{slug}}" limit=10}}
-      <a href="{{url}}" class="article-card">
-        {{#if thumbnailImage}}
-          <img src="{{thumbnailImage}}" alt="{{name}}">
+      {{#each posts}}
+        {{#if (eq author.name ../name)}}
+        <a href="{{url}}" class="article-card">
+          {{#if thumbnail}}
+            <img src="{{thumbnail}}" alt="{{name}}">
+          {{/if}}
+          <h3>{{name}}</h3>
+          <p>{{summary}}</p>
+        </a>
         {{/if}}
-        <h3>{{name}}</h3>
-        <p>{{postSummary}}</p>
-      </a>
       {{/each}}
     </div>
   </section>
 </article>
 \`\`\`
 
-**Special:** \`where="author.slug:{{slug}}"\` filters blogs by this author`,
+**Pattern:** \`{{#if (eq author.name ../name)}}\` filters posts by this author`,
     custom_collection_template: `# Custom Collection Template
 
-For user-defined collections. All custom collections have mandatory \`name\` and \`publishedAt\` fields.
+For any user-defined collection. All collections have built-in \`name\`, \`slug\`, \`url\`, and date fields.
 
 ## Index Template
 
@@ -408,6 +406,10 @@ For user-defined collections. All custom collections have mandatory \`name\` and
     </article>
     {{/each}}
   </div>
+  
+  {{#unless products}}
+    <p>No products yet.</p>
+  {{/unless}}
 </section>
 \`\`\`
 
@@ -433,38 +435,27 @@ For user-defined collections. All custom collections have mandatory \`name\` and
 </article>
 \`\`\`
 
-## Required Built-in Tokens
+## Built-in Tokens (Available on ALL items)
 
-Every custom collection item automatically has:
-- \`{{name}}\` - Item name/title (REQUIRED)
-- \`{{slug}}\` - URL slug for detail pages
+- \`{{name}}\` - Item name/title
+- \`{{slug}}\` - URL slug
 - \`{{url}}\` - Full URL to detail page
-- \`{{publishedAt}}\` - Publish date (REQUIRED)
+- \`{{publishedAt}}\` - Publish date
+- \`{{createdAt}}\` - Creation date
+- \`{{updatedAt}}\` - Last modified date
 
-## In manifest.json (Flat Format)
+## In manifest.json
 
 \`\`\`json
 {
   "cmsTemplates": {
-    "productIndex": "pages/shop.html",
-    "productIndexPath": "/shop",
-    "productDetail": "templates/product-detail.html",
-    "productDetailPath": "/product"
+    "productsIndex": "templates/products_index.html",
+    "productsIndexPath": "/shop",
+    "productsDetail": "templates/products_detail.html",
+    "productsDetailPath": "/products"
   }
 }
-\`\`\`
-
-**Path Configuration (flat format):**
-- \`{slug}Index\` - Template file for the list page
-- \`{slug}IndexPath\` - URL for the list page (e.g., /shop → lists all products)
-- \`{slug}Detail\` - Template file for the detail page
-- \`{slug}DetailPath\` - Base URL for detail pages (e.g., /product → /product/my-product-slug)
-
-This serves:
-- Collection index at \`/shop\` (lists all products using productIndex template)
-- Detail pages at \`/product/product-slug\` (individual product using productDetail template)
-
-**IMPORTANT:** The manifest's paths are the SINGLE SOURCE OF TRUTH. Collection slug is for database only.`,
+\`\`\``,
     form_handling: `# Form Handling
 
 Forms are automatically captured by the CMS:
@@ -488,37 +479,38 @@ Forms are automatically captured by the CMS:
   
   <button type="submit">Send Message</button>
 </form>
+\`\`\`
+
+## Form Handler Script
 
-<script>
+\`\`\`javascript
 document.querySelectorAll('form[data-form-name]').forEach(form => {
   form.addEventListener('submit', async (e) => {
     e.preventDefault();
     
+    const formName = form.dataset.formName || 'general';
     const formData = new FormData(form);
     const data = Object.fromEntries(formData);
     
-    const response = await fetch('/api/forms/submit', {
+    // IMPORTANT: Endpoint is /_forms/{formName}
+    const response = await fetch('/_forms/' + formName, {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify({
-        formName: form.dataset.formName,
-        data: data
-      })
+      body: JSON.stringify(data)
     });
     
     if (response.ok) {
       form.reset();
-      alert('Thank you! Your message has been sent.');
+      alert(form.dataset.successMessage || 'Thank you!');
     }
   });
 });
-</script>
 \`\`\`
 
 **Key points:**
 - Add \`data-form-name="xxx"\` to identify the form
-- All \`name\` attributes are captured as fields
-- Tenant context is handled automatically by the system`,
+- Endpoint is \`/_forms/{formName}\` (NOT \`/api/forms/submit\`)
+- All \`name\` attributes are captured as fields`,
     asset_paths: `# Asset Path Rules
 
 **ALL asset paths must use /public/ prefix:**
@@ -569,78 +561,28 @@ Logos, icons, decorative backgrounds, UI elements - these are bundled with the s
 \`\`\`
 
 ### 2. Content Images (Use CMS Tokens)
-Blog photos, team headshots, product images - these are managed through the CMS:
+Post images, team photos, product images - these are managed through the CMS:
 \`\`\`html
 <!-- USE CMS tokens for content -->
-<img src="{{mainImage}}" alt="{{name}}">
-<img src="{{thumbnailImage}}" alt="{{name}}">
+<img src="{{image}}" alt="{{name}}">
+<img src="{{thumbnail}}" alt="{{name}}">
 <img src="{{photo}}" alt="{{name}}">
 \`\`\`
 
 ---
 
-## How to Decide: Static vs CMS Token
-
-| Image Type | Use | Example |
-|------------|-----|---------|
-| Company logo | \`/public/images/logo.png\` | Header/footer logo |
-| UI icons | \`/public/images/icons/...\` | Arrows, social icons |
-| Decorative backgrounds | \`/public/images/...\` | Hero patterns, textures |
-| Favicon | \`/public/images/favicon.ico\` | Browser tab icon |
-| Blog post images | \`{{mainImage}}\` | Article hero image |
-| Team member photos | \`{{photo}}\` | Staff headshots |
-| Product images | \`{{productImage}}\` | E-commerce photos |
-| User-uploaded content | \`{{fieldName}}\` | Any CMS-managed media |
-
-**Rule of thumb:** If the image is part of the site's design/branding → static. If it's content that changes per item → CMS token.
-
----
-
-## Content Images: Avoid Hardcoded Examples
-
-When converting a static site with example blog posts or team members, replace the example content with CMS tokens:
-
-**WRONG - Hardcoded example content:**
-\`\`\`html
-<div class="videos-grid">
-  <article class="video-card">
-    <img src="/images/example-video.jpg" alt="Example">
-    <h2>Example Video Title</h2>
-    <p>Example description text...</p>
-  </article>
-</div>
-\`\`\`
-
-**CORRECT - CMS tokens with loop:**
-\`\`\`html
-<div class="videos-grid">
-  {{#each video sort="publishedAt" order="desc"}}
-  <article class="video-card">
-    {{#if videothumbnail}}
-      <img src="{{videothumbnail}}" alt="{{name}}">
-    {{/if}}
-    <h2><a href="{{url}}">{{name}}</a></h2>
-    <p>{{shortdescription}}</p>
-  </article>
-  {{/each}}
-</div>
-\`\`\`
-
----
-
 ## Always Wrap Content Images in Conditionals
 
-Since CMS images may not be uploaded, always check:
 \`\`\`html
-{{#if mainImage}}
-  <img src="{{mainImage}}" alt="{{name}}" class="hero-image">
+{{#if image}}
+  <img src="{{image}}" alt="{{name}}" class="hero-image">
 {{/if}}
 \`\`\`
 
-Or provide a CSS fallback (not a hardcoded placeholder image):
+Or provide a CSS fallback:
 \`\`\`html
-{{#if mainImage}}
-  <img src="{{mainImage}}" alt="{{name}}">
+{{#if image}}
+  <img src="{{image}}" alt="{{name}}">
 {{else}}
   <div class="placeholder-image"></div>
 {{/if}}
@@ -648,61 +590,14 @@ Or provide a CSS fallback (not a hardcoded placeholder image):
 
 ---
 
-## Image Field Names by Collection
-
-**Blog Posts:**
-- \`{{mainImage}}\` - Hero/cover image
-- \`{{thumbnailImage}}\` - Small preview image
-
-**Team Members:**
-- \`{{photo}}\` - Headshot
-
-**Authors:**
-- \`{{picture}}\` - Author photo
-
-**Custom Collections:**
-- **Token name = field slug** defined when creating the collection
-- e.g., field slug \`videothumbnail\` → \`{{videothumbnail}}\`
-- e.g., field slug \`ogimage\` → \`{{ogimage}}\`
-- e.g., field slug \`productImage\` → \`{{productImage}}\`
-
-**Use \`get_tenant_schema\` tool to see exact field slugs for a tenant's custom collections.**
-
----
-
-## How CMS Images Work
-
-1. User creates a custom collection with image fields (e.g., \`videothumbnail\`)
-2. User uploads images via CMS dashboard
-3. Template uses the field slug as the token: \`{{videothumbnail}}\`
-4. CMS automatically provides the correct URL at runtime
-
----
-
 ## Common Mistakes
 
 1. **Replacing logos with CMS tokens** - Keep static UI images as \`/public/\` paths
-2. **Hardcoding example blog/product images** - Use \`{{#each}}\` loops with CMS tokens
-3. **Wrong field names** - \`{{photo}}\` for team, \`{{picture}}\` for authors
-4. **Missing conditionals** - Always wrap optional content images in \`{{#if}}\`
-5. **Hardcoded placeholder images** - Use CSS placeholders, not image files`,
+2. **Hardcoding example content images** - Use \`{{#each}}\` loops with CMS tokens
+3. **Missing conditionals** - Always wrap optional content images in \`{{#if}}\``,
     relation_fields: `# Relation Fields - Linking Collections
 
-Relation fields let you link items from one collection to another, like adding tags, categories, or related items to your content.
-
----
-
-## Creating a Relation Field
-
-In the CMS dashboard, when adding a custom field to a collection:
-1. Choose field type: **Relation**
-2. Select the target collection to link to (built-in or custom)
-3. The field will store a reference to an item from that collection
-
-**Example: Adding a "Category" relation field to a Projects collection**
-- Create a "Categories" custom collection with items like "Web Design", "Branding", "Mobile"
-- Add a relation field called "category" to Projects, linked to Categories
-- Each project can now be assigned a category
+Relation fields let you link items from one collection to another.
 
 ---
 
@@ -730,11 +625,8 @@ When a relation field is set, access the related item's data using dot notation:
 
 ## Available Relation Tokens
 
-All relation fields expose these tokens:
-
 | Token | Description |
 |-------|-------------|
-| \`{{relationField.id}}\` | Related item's ID |
 | \`{{relationField.name}}\` | Related item's name |
 | \`{{relationField.slug}}\` | Related item's URL slug |
 | \`{{relationField.url}}\` | Full URL to related item's detail page |
@@ -742,29 +634,11 @@ All relation fields expose these tokens:
 
 ---
 
-## Common Patterns
-
-### Tags/Categories on Blog Posts
-
-\`\`\`html
-{{#each blogs limit=10 sort="publishedAt" order="desc"}}
-<article class="blog-card">
-  <h2>{{name}}</h2>
-  {{#if tag}}
-    <span class="tag">{{tag.name}}</span>
-  {{/if}}
-  <p>{{postSummary}}</p>
-  <a href="{{url}}">Read more</a>
-</article>
-{{/each}}
-\`\`\`
-
-### Category/Tag Detail Pages - Filter by Relation
+## Filter by Relation on Detail Pages
 
 On a category detail page, show only items with that category:
 
 \`\`\`html
-<!-- templates/category-detail.html -->
 <h1>{{name}}</h1>
 <p>Projects in this category:</p>
 
@@ -780,50 +654,13 @@ On a category detail page, show only items with that category:
 </div>
 \`\`\`
 
-### Related Service on Project
-
-\`\`\`html
-<div class="project-detail">
-  <h1>{{name}}</h1>
-  {{{description}}}
-  
-  {{#if relatedService}}
-  <aside class="service-highlight">
-    <h3>Service Used</h3>
-    <a href="{{relatedService.url}}">
-      <strong>{{relatedService.name}}</strong>
-    </a>
-    {{#if relatedService.shortDescription}}
-      <p>{{relatedService.shortDescription}}</p>
-    {{/if}}
-  </aside>
-  {{/if}}
-</div>
-\`\`\`
-
----
-
-## Target Collections
-
-Relation fields can link to:
-
-**Built-in Collections:**
-- \`blogs\` - Blog posts
-- \`authors\` - Content authors
-- \`team\` - Team members
-- \`downloads\` - Downloadable files
-
-**Custom Collections:**
-- Any custom collection you create (e.g., \`categories\`, \`tags\`, \`services\`, \`clients\`)
-
 ---
 
 ## Best Practices
 
 1. **Always wrap in {{#if}}** - The relation may not be set for all items
 2. **Use for categorization** - Tags, categories, content types
-3. **Link related content** - Featured author, related service, parent category
-4. **Filter on detail pages** - Use \`{{#if (eq relation.slug ../slug)}}\` to show related items`,
+3. **Link related content** - Featured author, related service, parent category`,
     data_edit_keys: `# Inline Editing with data-edit-key
 
 Make text editable in the CMS visual editor:
@@ -854,31 +691,31 @@ Make text editable in the CMS visual editor:
 
 **Basic loop:**
 \`\`\`html
-{{#each blogs}}
+{{#each posts}}
   <article>
     <h2>{{name}}</h2>
-    <p>{{postSummary}}</p>
+    <p>{{summary}}</p>
   </article>
 {{/each}}
 \`\`\`
 
 **With limit:**
 \`\`\`html
-{{#each blogs limit=6}}
+{{#each posts limit=6}}
   ...
 {{/each}}
 \`\`\`
 
-**Featured only:**
+**Featured only (if collection has boolean "featured" field):**
 \`\`\`html
-{{#each blogs featured=true}}
+{{#each posts featured=true}}
   ...
 {{/each}}
 \`\`\`
 
 **Combined:**
 \`\`\`html
-{{#each blogs featured=true limit=3}}
+{{#each posts featured=true limit=3}}
   ...
 {{/each}}
 \`\`\`
@@ -892,7 +729,7 @@ Make text editable in the CMS visual editor:
 
 **Loop variables:**
 \`\`\`html
-{{#each blogs limit=5}}
+{{#each posts limit=5}}
   <article class="{{#if @first}}featured{{/if}} {{#if @last}}last{{/if}}">
     <span class="position">Item {{@index}}</span>
     <h2>{{name}}</h2>
@@ -907,15 +744,15 @@ Make text editable in the CMS visual editor:
 
 **{{#if}} - Render if truthy:**
 \`\`\`html
-{{#if mainImage}}
-  <img src="{{mainImage}}" alt="{{name}}">
+{{#if image}}
+  <img src="{{image}}" alt="{{name}}">
 {{/if}}
 \`\`\`
 
 **{{#if}} with {{else}}:**
 \`\`\`html
-{{#if thumbnailImage}}
-  <img src="{{thumbnailImage}}" alt="{{name}}">
+{{#if thumbnail}}
+  <img src="{{thumbnail}}" alt="{{name}}">
 {{else}}
   <div class="placeholder">No image</div>
 {{/if}}
@@ -932,8 +769,8 @@ Make text editable in the CMS visual editor:
 \`\`\`html
 {{#if author}}
   <div class="author-info">
-    {{#if author.picture}}
-      <img src="{{author.picture}}" alt="{{author.name}}">
+    {{#if author.photo}}
+      <img src="{{author.photo}}" alt="{{author.name}}">
     {{/if}}
     <span>{{author.name}}</span>
   </div>
@@ -942,24 +779,25 @@ Make text editable in the CMS visual editor:
 
 **Multiple conditions (check both):**
 \`\`\`html
-{{#if mainImage}}
+{{#if image}}
   {{#if featured}}
-    <img src="{{mainImage}}" class="featured-image">
+    <img src="{{image}}" class="featured-image">
   {{/if}}
 {{/if}}
 \`\`\``,
-    nested_fields: `# Nested Field Access
+    nested_fields: `# Nested Field Access (Relation Fields)
+
+Access related item fields using dot notation:
 
-**Author fields in blog templates:**
 \`\`\`html
-{{#each blogs}}
+{{#each posts}}
   <article>
     <h2>{{name}}</h2>
     
     {{#if author}}
       <div class="author">
-        {{#if author.picture}}
-          <img src="{{author.picture}}" alt="{{author.name}}">
+        {{#if author.photo}}
+          <img src="{{author.photo}}" alt="{{author.name}}">
         {{/if}}
         <span>By {{author.name}}</span>
         
@@ -972,17 +810,14 @@ Make text editable in the CMS visual editor:
 {{/each}}
 \`\`\`
 
-**Available nested author fields:**
+**Available nested tokens (for a relation field named "author"):**
 - \`{{author.name}}\`
 - \`{{author.slug}}\`
-- \`{{author.picture}}\`
-- \`{{{author.bio}}}\` (triple braces!)
-- \`{{author.email}}\`
-- \`{{author.twitterProfileLink}}\`
-- \`{{author.linkedinProfileLink}}\`
 - \`{{author.url}}\`
+- \`{{{author.bio}}}\` (triple braces for richText!)
+- Any other field from the related collection
 
-**Always wrap in {{#if author}}** to handle posts without authors`,
+**Always wrap in {{#if author}}** to handle items without the relation set`,
     featured_posts: `# Featured Posts Section
 
 **Homepage featured posts (3 most recent):**
@@ -990,14 +825,14 @@ Make text editable in the CMS visual editor:
 <section class="featured-posts">
   <h2 data-edit-key="home-blog-title">Latest News</h2>
   
-  {{#each blogs featured=true limit=3}}
+  {{#each posts featured=true limit=3}}
   <article class="featured-card {{#if @first}}large{{/if}}">
-    {{#if mainImage}}
-      <img src="{{mainImage}}" alt="{{name}}">
+    {{#if image}}
+      <img src="{{image}}" alt="{{name}}">
     {{/if}}
     <div class="card-content">
       <h3><a href="{{url}}">{{name}}</a></h3>
-      <p>{{postSummary}}</p>
+      <p>{{summary}}</p>
       {{#if author}}
         <span class="byline">By {{author.name}}</span>
       {{/if}}
@@ -1006,28 +841,11 @@ Make text editable in the CMS visual editor:
   </article>
   {{/each}}
   
-  <a href="/blog" class="view-all">View All Posts →</a>
+  <a href="/blog" class="view-all">View All Posts</a>
 </section>
 \`\`\`
 
-**Hero featured post (single):**
-\`\`\`html
-{{#each blogs featured=true limit=1}}
-<section class="hero-post">
-  {{#if mainImage}}
-    <div class="hero-image" style="background-image: url('{{mainImage}}')">
-  {{/if}}
-    <div class="hero-content">
-      <span class="label">Featured</span>
-      <h1><a href="{{url}}">{{name}}</a></h1>
-      <p>{{postSummary}}</p>
-    </div>
-  {{#if mainImage}}
-    </div>
-  {{/if}}
-</section>
-{{/each}}
-\`\`\``,
+**Note:** Requires a boolean "featured" field on your collection`,
     parent_context: `# Parent Context References (\`../\`)
 
 Inside loops, access the **parent scope** (the page's current item) using \`../\`:
@@ -1041,11 +859,11 @@ Inside loops, access the **parent scope** (the page's current item) using \`../\
   <section class="author-articles">
     <h2>Posts by {{name}}</h2>
     
-    {{#each blogs}}
+    {{#each posts}}
       {{#if (eq author.name ../name)}}
         <article class="post-card">
           <h3><a href="{{url}}">{{name}}</a></h3>
-          <p>{{postSummary}}</p>
+          <p>{{summary}}</p>
           <time>{{publishedAt}}</time>
         </article>
       {{/if}}
@@ -1055,8 +873,8 @@ Inside loops, access the **parent scope** (the page's current item) using \`../\
 \`\`\`
 
 **How It Works:**
-- Inside \`{{#each blogs}}\`, the context is each blog post
-- \`author.name\` = the blog post's author
+- Inside \`{{#each posts}}\`, the context is each post
+- \`author.name\` = the post's author
 - \`../name\` = the parent context (the author being displayed on the page)
 - Only posts where author.name matches ../name are shown
 
@@ -1069,23 +887,12 @@ Inside loops, access the **parent scope** (the page's current item) using \`../\
     </a>
   {{/each}}
 </nav>
-
-<div class="category-content">
-  <h1>{{name}}</h1>
-  
-  {{#each items}}
-    {{#if (eq category ../slug)}}
-      <div class="item">{{name}}</div>
-    {{/if}}
-  {{/each}}
-</div>
 \`\`\`
 
 **Available Parent Fields:**
 - \`../name\` - Parent item's name
 - \`../slug\` - Parent item's slug
-- \`../fieldName\` - Any field from the parent item
-- \`../nested.field\` - Nested field access in parent`,
+- \`../fieldName\` - Any field from the parent item`,
     equality_comparison: `# Equality Comparisons
 
 Compare two values using \`(eq field1 field2)\` helper:
@@ -1093,7 +900,7 @@ Compare two values using \`(eq field1 field2)\` helper:
 ## Show When Equal ({{#if (eq ...)}})
 \`\`\`html
 {{#if (eq author.slug ../slug)}}
-  <span class="current-author-badge">✓ Your Post</span>
+  <span class="current-author-badge">Your Post</span>
 {{/if}}
 \`\`\`
 
@@ -1101,13 +908,13 @@ Compare two values using \`(eq field1 field2)\` helper:
 The most common pattern for "Related Posts" or "Other Items" sections:
 
 \`\`\`html
-<!-- On a blog post page, show other posts EXCEPT the current one -->
+<!-- On a post page, show other posts EXCEPT the current one -->
 <h3>Related Posts</h3>
-{{#each blogs limit=3}}
+{{#each posts limit=3}}
   {{#unless (eq slug ../slug)}}
     <article>
       <a href="{{url}}">{{name}}</a>
-      <p>{{postSummary}}</p>
+      <p>{{summary}}</p>
     </article>
   {{/unless}}
 {{/each}}
@@ -1126,38 +933,20 @@ The most common pattern for "Related Posts" or "Other Items" sections:
 {{/eq}}
 
 {{#eq category "news"}}
-  <span class="news-icon">📰</span>
+  <span class="news-icon">News</span>
 {{/eq}}
 \`\`\`
 
-## Inside Loops with Parent Context
-\`\`\`html
-{{#each blogs}}
-  <article class="{{#if (eq author.name ../name)}}highlight{{/if}}">
-    <h3>{{name}}</h3>
-    {{#if (eq author.name ../name)}}
-      <span class="yours">You wrote this!</span>
-    {{/if}}
-  </article>
-{{/each}}
-\`\`\`
-
 ## Summary Table
 
 | Syntax | Shows content when... |
 |--------|----------------------|
 | \`{{#if (eq a b)}}\` | a equals b |
 | \`{{#unless (eq a b)}}\` | a does NOT equal b |
-| \`{{#eq field "value"}}\` | field equals "value" |
-
-**Common Use Cases:**
-- Related posts (exclude current) - use \`{{#unless (eq slug ../slug)}}\`
-- Filter by current author/category - use \`{{#if (eq author.slug ../slug)}}\`
-- Highlight active items - use \`{{#if (eq ...)}}\`
-- Show badges for specific statuses - use \`{{#eq status "value"}}\``,
+| \`{{#eq field "value"}}\` | field equals "value" |`,
     youtube_embed: `# YouTube Video Embeds
 
-**IMPORTANT:** YouTube iframes require specific attributes to work correctly. Missing attributes will cause Error 150/153 "Video player configuration error".
+**IMPORTANT:** YouTube iframes require specific attributes to work correctly. Missing attributes will cause Error 150/153.
 
 ## Correct YouTube Embed Format
 
@@ -1182,20 +971,6 @@ The most common pattern for "Related Posts" or "Other Items" sections:
 | \`frameborder="0"\` | Recommended | Removes border |
 | \`title="..."\` | Recommended | Accessibility for screen readers |
 
-## Common Mistake (Causes Error 153)
-
-\`\`\`html
-<!-- ❌ WRONG - Missing referrerpolicy -->
-<iframe src="{{videoUrl}}" allowfullscreen></iframe>
-
-<!-- ✅ CORRECT - All required attributes -->
-<iframe 
-  src="{{videoUrl}}" 
-  referrerpolicy="strict-origin-when-cross-origin"
-  allowfullscreen
-></iframe>
-\`\`\`
-
 ## Video URL Format
 
 Store YouTube URLs in embed format:
@@ -1205,7 +980,7 @@ https://www.youtube.com/embed/VIDEO_ID
 
 **NOT** watch format:
 \`\`\`
-https://www.youtube.com/watch?v=VIDEO_ID  ❌
+https://www.youtube.com/watch?v=VIDEO_ID
 \`\`\`
 
 ## Full Example with Conditional
@@ -1227,24 +1002,6 @@ https://www.youtube.com/watch?v=VIDEO_ID  ❌
     </div>
   {{/if}}
 </div>
-\`\`\`
-
-## Responsive Video CSS
-
-\`\`\`css
-.video-container {
-  position: relative;
-  width: 100%;
-  padding-bottom: 56.25%; /* 16:9 aspect ratio */
-}
-
-.video-container iframe {
-  position: absolute;
-  top: 0;
-  left: 0;
-  width: 100%;
-  height: 100%;
-}
 \`\`\``,
 };
 /**