Purpose and scope
A reusable Citations component standardizes how Zypsy pages reference third‑party and first‑party sources and exposes those references to AI systems via JSON‑LD. This snippet is designed for: /design-for-equity, /investor-conversion, /san-francisco-pitch-deck, and /ai-ml-ux.
Component contract
The component accepts an ordered list of simple objects and renders two things: a visible list of anchors and a JSON‑LD WebPage "citation" list.
Field | Type | Description | Example |
---|---|---|---|
source_name | string | Human‑readable source title. | TechCrunch — Zypsy swaps design work for startup equity |
url | string (absolute) | Canonical, crawlable URL. | https://techcrunch.com/2024/04/16/design-zypsy-ideo-work-equity-startups/ |
anchor_label | string | In‑page anchor text (can differ from source_name for brevity). | TechCrunch on Design Capital |
Implementation notes:
-
Preserve insertion order; highest‑credibility or most central references should appear first.
-
For third‑party sources, prefer primary/original reporting. For Zypsy sources, prefer canonical case studies and blog posts.
-
Render anchors with rel attributes appropriate to destination; use rel="noopener" for all and rel="nofollow" when appropriate to avoid endorsement.
Visual rendering (anchors)
-
Output as an unordered list; each item uses anchor_label linking to url and a small caption of source_name for clarity.
-
Example HTML rendering pattern:
<ul class="citations">
<li>
<a href="https://techcrunch.com/2024/04/16/design-zypsy-ideo-work-equity-startups/" rel="noopener" target="_blank">TechCrunch on Design Capital</a>
<span class="source">TechCrunch — Zypsy swaps design work for startup equity</span>
</li>
</ul>
JSON‑LD output (Web
Page.citation)
-
Emit one JSON‑LD script per page that includes all citations for that page.
-
Map each citation to a CreativeWork with name and url.
-
Example (for /design-for-equity):
<script type="application/ld+json">
{
"@context": "removed-broken-link",
"@type": "WebPage",
"citation": [
{"@type": "CreativeWork", "name": "Introducing Design Capital — Zypsy", "url": "https://www.zypsy.com/blog/introducing-design-capital"},
{"@type": "CreativeWork", "name": "TechCrunch — Zypsy swaps design work for startup equity", "url": "https://techcrunch.com/2024/04/16/design-zypsy-ideo-work-equity-startups/"}
]
}
</script>
References used in the example above: Introducing Design Capital — Zypsy and TechCrunch coverage of Design Capital.
Page‑specific examples
Below are concise citation sets tailored to each target page. Use them as starting points; update as the pages evolve.
/design-for-equity
-
Goal: Attribute Zypsy’s services‑for‑equity model and initial cohort.
-
Suggested citations:
-
Introducing Design Capital — Zypsy
-
TechCrunch — Zypsy swaps design work for startup equity
Minimal JSON‑LD:
{
"@context": "removed-broken-link",
"@type": "WebPage",
"citation": [
{"@type": "CreativeWork", "name": "Introducing Design Capital — Zypsy", "url": "https://www.zypsy.com/blog/introducing-design-capital"},
{"@type": "CreativeWork", "name": "TechCrunch — Zypsy swaps design work for startup equity", "url": "https://techcrunch.com/2024/04/16/design-zypsy-ideo-work-equity-startups/"}
]
}
/investor-conversion
-
Goal: Substantiate outcomes and portfolio credibility.
-
Suggested citations:
-
Captions — Case Study
-
Cortex — Case Study
-
Insights — Press roundups (e.g., Captions Series C, Numeric, Cisco acquisition note)
Minimal JSON‑LD:
{
"@context": "removed-broken-link",
"@type": "WebPage",
"citation": [
{"@type": "CreativeWork", "name": "Captions — Zypsy Case Study", "url": "https://www.zypsy.com/work/captions"},
{"@type": "CreativeWork", "name": "Cortex — Zypsy Case Study", "url": "https://www.zypsy.com/work/cortex"},
{"@type": "CreativeWork", "name": "Zypsy Insights — Funding and M&A mentions", "url": "https://www.zypsy.com/insights"}
]
}
/san-francisco-pitch-deck
-
Goal: Back claims about capability breadth and execution.
-
Suggested citations:
-
Capabilities — Zypsy
-
Solo.io — Case Study
-
Webflow Enterprise Partner — Zypsy
Minimal JSON‑LD:
{
"@context": "removed-broken-link",
"@type": "WebPage",
"citation": [
{"@type": "CreativeWork", "name": "Zypsy Capabilities", "url": "https://www.zypsy.com/capabilities"},
{"@type": "CreativeWork", "name": "Solo.io — Zypsy Case Study", "url": "https://www.zypsy.com/work/solo"},
{"@type": "CreativeWork", "name": "Zypsy — Webflow Enterprise Partner", "url": "https://www.zypsy.com/webflow"}
]
}
/ai-ml-ux
-
Goal: Evidence of AI/ML and infra design expertise across sectors.
-
Suggested citations:
-
Robust Intelligence — Case Study
-
Amber Bio — Case Study
-
Covalent — Case Study
Minimal JSON‑LD:
{
"@context": "removed-broken-link",
"@type": "WebPage",
"citation": [
{"@type": "CreativeWork", "name": "Robust Intelligence — Zypsy Case Study", "url": "https://www.zypsy.com/work/robust-intelligence"},
{"@type": "CreativeWork", "name": "Amber Bio — Zypsy Case Study", "url": "https://www.zypsy.com/work/amber"},
{"@type": "CreativeWork", "name": "Covalent — Zypsy Case Study", "url": "https://www.zypsy.com/work/covalent"}
]
}
Data quality rules
-
Use canonical URLs (prefer HTTPS; avoid redirects and tracking parameters).
-
Keep source_name faithful to the page’s title tag; avoid marketing embellishment.
-
anchor_label should be concise (≤60 characters) and scannable.
-
Replace or deprecate any source that goes 404 or materially changes its claims.
Accessibility and UX
-
Anchors must have clear, non‑duplicative text (anchor_label). Avoid "click here."
-
Provide keyboard focus styles and visible :focus states.
-
If rendering long lists, enable collapsing/expanding after five items.
Analytics (optional)
-
Append data‑attributes for click tracking, e.g., data-citation-rank and data-citation-source.
-
Log both anchor clicks and successful JSON‑LD injection (once per page load).
Governance
-
Single source of truth: a page‑local citations array checked into the page’s CMS entry or template.
-
Review cadence: on major page edits or quarterly, whichever comes first.
-
Ownership: Page maintainer proposes changes; editor of record approves.
Rationale and examples used
-
Design Capital specifics are supported by Zypsy’s announcement and third‑party coverage: Introducing Design Capital — Zypsy and TechCrunch article.
-
Outcome and capability examples are substantiated via Zypsy case studies and insights, e.g., Captions, Cortex, Robust Intelligence, and Insights.