CLAUDE.md — ftpartners.com-ssg

Tech Stack

• Generator: Eleventy (11ty) v1.0.2
• Templating: Liquid (.liquid files)
• CMS: Contentful (content fetched at build time via _data/ JS files)
• Static assets: Served from https://www.ftpartners.com/assets/ (mapped from /assets/)

Directory Structure

_data/          # JS data files — each fetches a Contentful content type
_includes/      # Layouts, partials, utilities
  utils/
    entry-fetcher.js   # Wraps Contentful SDK, handles pagination
    slugify.js
fintech-strategic-insights/   # Research report pages
interviews/                   # VIP panel / interview pages

Contentful Content Types

researchReportPage Fields

vipConferencePage Fields

almanacReportPage Fields

Template Behavior:

• Simplified template: If only title and reportPdf are defined → renders just title + PDF viewer
• Full template: If summary, coverImage, slideImages, or content fields are defined → renders full almanac layout
• Prior reports: Automatically filtered by category, sorted by year/quarter DESC
  • Display format: Q4 shows as "2024", others show as "Q1 2024", "Q2 2024", "Q3 2024"
• PDF analytics: Uses content_type: "almanac" for tracking

Contentful Import JSON Format

File: contentful-import-research-reports.json (created per-batch, not committed)

{
  "assets": [ ... ],
  "entries": [ ... ]
}

Asset format

{
  "sys": { "id": "asset-{slug}-cover" },
  "fields": {
    "title": { "en-US": "Description" },
    "file": {
      "en-US": {
        "contentType": "image/png",
        "fileName": "filename.png",
        "url": "https://www.ftpartners.com/assets/images/..."
      }
    }
  }
}

⚠️ Use "url" — NOT "upload" — for the file field key.

Entry format

{
  "sys": {
    "id": "research-report-{slug}",
    "contentType": { "sys": { "type": "Link", "linkType": "ContentType", "id": "researchReportPage" } }
  },
  "fields": {
    "title":        { "en-US": "..." },
    "slug":         { "en-US": "..." },
    "featureTitle": { "en-US": "..." },
    "ctaLabel":     { "en-US": "View" },
    "reportUrl":    { "en-US": "https://finte.ch/..." },
    "featuredImage": { "en-US": { "sys": { "type": "Link", "linkType": "Asset", "id": "asset-{slug}-cover" } } },
    "coverImage":    { "en-US": { "sys": { "type": "Link", "linkType": "Asset", "id": "asset-{slug}-cover" } } },
    "slideImages":   { "en-US": [ { "sys": { "type": "Link", "linkType": "Asset", "id": "asset-{slug}-slide-1" } }, ... ] },
    "featuredSummary":  { "en-US": { "nodeType": "document", "data": {}, "content": [ { "nodeType": "paragraph", ... } ] } },
    "cardTitle":     { "en-US": "..." },
    "cardSummary":   { "en-US": { "nodeType": "document", "data": {}, "content": [ { "nodeType": "paragraph", ... } ] } },
    "summary":       { "en-US": { "nodeType": "document", "data": {}, "content": [ ... ] } }
  }
}

RichText Document Structure

Plain paragraph

{
  "nodeType": "document", "data": {},
  "content": [
    { "nodeType": "paragraph", "data": {}, "content": [
      { "nodeType": "text", "value": "Text here.", "marks": [], "data": {} }
    ]}
  ]
}

Summary with Executive Summary heading + bullets

{
  "nodeType": "document", "data": {},
  "content": [
    { "nodeType": "heading-4", "data": {}, "content": [
      { "nodeType": "text", "value": "Executive Summary:", "marks": [{ "type": "bold" }], "data": {} }
    ]},
    { "nodeType": "paragraph", "data": {}, "content": [
      { "nodeType": "text", "value": "Main summary text...", "marks": [], "data": {} }
    ]},
    { "nodeType": "paragraph", "data": {}, "content": [
      { "nodeType": "text", "value": "Key discussion topics of the report include:", "marks": [{ "type": "italic" }], "data": {} }
    ]},
    { "nodeType": "unordered-list", "data": {}, "content": [
      { "nodeType": "list-item", "data": {}, "content": [
        { "nodeType": "paragraph", "data": {}, "content": [
          { "nodeType": "text", "value": "Bullet item", "marks": [], "data": {} }
        ]}
      ]}
    ]}
  ]
}

Hyperlink (inline)

When source HTML contains <a href="...">link text</a> inside summary paragraphs, use:

{ "nodeType": "hyperlink", "data": { "uri": "https://full-url-here.com" }, "content": [
  { "nodeType": "text", "value": "link text", "marks": [], "data": {} }
]}

Internal links using / must be converted to full URLs: https://www.ftpartners.com/.

⚠️ Only bilt-overview had inline links in its summary text. All other reports use plain text.

Image URL Construction

/assets/ = /assets/ → full URL = https://www.ftpartners.com/assets/images/...

Common image paths:

/assets/images/ftresearch/fintech-africa/
/assets/images/ftresearch/wift/
/assets/images/ftresearch/bilt/
/assets/images/ftresearch/what-to-watch/
/assets/images/ftresearch/spot-etf/
/assets/images/stablecoin/
/assets/images/interviews/wift-2025/
/assets/images/ftresearch/fintech-2025/
/assets/images/ftresearch/UnlockingDataCover.png
/assets/images/ftresearch/auto/

Workflow: Migrating a Static Page to Contentful

1. Read the .liquid file to extract: title, slug, summary text, image paths, reportUrl, slide images, cardTitle/cardSummary (from index.liquid "Selected Reports" section)
2. Build contentful-import-research-reports.json with assets + entry
3. Import via npx contentful-import --space-id ... --management-token ... --content-file contentful-import-research-reports.json
4. Delete the static .liquid file — leaving it causes an 11ty output conflict with research-report-detail.liquid

curatedLists.js — enrichItem Pattern

_data/curatedLists.js computes added.url per content type:

researchReportPage  → /fintech-strategic-insights/{slug}/
almanacReportPage   → /fintech-strategic-insights/{slug}/
vipConferencePage   → /interviews/{slug}/
interview           → /fintech-strategic-insights/library/interviews/{slug}/  (or bitlyLink if no slug)
customPage          → item.fields.internalUrl

Known Gotchas

• featuredSummary and cardSummary are RichText — sending a plain string causes a 422 validation error
• Asset file key is "url" — using "upload" causes a 422 validation error
• DocSend links (finte.ch/...) are access-controlled viewers — cannot be imported as PDF assets; store in reportUrl field only
• Output conflicts: importing a Contentful entry with the same slug as an existing .liquid file causes 11ty to fail — always delete the static file after import
• / = site root (used for internal links in templates) → https://www.ftpartners.com/ for Contentful hyperlinks

Imported Reports (completed)

Batch 1: stablecoin-payments, women-in-fintech-2025, fintech-2025, digital-asset-ecosystem, parking-payments

Batch 2: fintech-in-africa-thriving-opportunity, women-in-fintech-resilience, bilt-overview, what-to-watch-2024, spot-etf

Remaining Static Reports (not yet imported)

See "Selected Reports" section of fintech-strategic-insights/index.liquid for card copy: fintech-in-india, innovations-in-payroll, women-in-fintech-rising-stars, blockchain-accounting, b2b-payments, blockchain-economy, women-in-fintech2022, race-to-super-app, buy-now-pay-later, open-banking-rearchitecting-financial-landscape, women-in-fintech, alternative-investments, challenger-banks, brazil-fintech, wealth-technology-report

Some entries (healthcare-payments, stablecoins video recap, youth-focused-fintech, insurtech, auto-fintech) link directly to external DocSend URLs and may not have a corresponding static .liquid page.