app.zeens.portfolio

{
  "description": "One titled external link on the About page. Readers MUST re-validate `url` and accept only https: the record lives on the owner's PDS and any client can write it, so the value reaches an href untrusted. Writers upgrade a typed http:// to https:// rather than storing insecure links.",
  "properties": {
    "title": {
      "description": "Link label, e.g. 'Buy prints'.",
      "maxLength": 60,
      "type": "string"
    },
    "url": {
      "description": "Destination URL. https only.",
      "format": "uri",
      "type": "string"
    }
  },
  "required": [
    "title",
    "url"
  ],
  "type": "object"
}

{
  "description": "The portfolio's About page. Plain text, like #homePage. The owner's portrait is NOT stored here: `useProfileAvatar` is a flag and the avatar is resolved from the profile at render time, so it tracks their Zeens avatar with no copy to go stale.",
  "properties": {
    "body": {
      "description": "About text, rendered with preserved line breaks.",
      "maxLength": 4000,
      "type": "string"
    },
    "enabled": {
      "description": "Whether the About page exists and appears in the rail.",
      "type": "boolean"
    },
    "heading": {
      "description": "Page heading, also used as the rail's label for it. Defaults to 'About' when absent.",
      "maxLength": 120,
      "type": "string"
    },
    "links": {
      "description": "Titled external links shown as one horizontal row above the About photo grid (e.g. 'Buy prints', 'My Instagram'). Distinct from the profile socials in the rail: those are platform accounts, these are anything the owner wants to point at.",
      "items": {
        "ref": "#aboutLink",
        "type": "ref"
      },
      "maxLength": 8,
      "type": "array"
    },
    "photos": {
      "description": "Photos chosen from the owner's own posts, in display order. Rendered as a grid below the About text: one photo full width, two side by side, three or more in three columns (six fills a 3x2 grid). Only the first image of a multi-image post is shown.",
      "items": {
        "ref": "#aboutPhoto",
        "type": "ref"
      },
      "maxLength": 6,
      "type": "array"
    },
    "useProfileAvatar": {
      "description": "Show the owner's live profile avatar as the portrait. Opt-in: absent means false, so a portrait never appears on the public page unless the owner asked for it.",
      "type": "boolean"
    }
  },
  "required": [
    "enabled"
  ],
  "type": "object"
}

{
  "description": "A reference to one of the owner's own posts, used wherever a block stores picked photos — the About page, page heroes, and Featured Work. Named for its first use; kept under that name because renaming a def would orphan the records already pointing at it.",
  "properties": {
    "cid": {
      "description": "CID of the referenced post at pick time.",
      "type": "string"
    },
    "uri": {
      "description": "AT-URI of an app.zeens.post / app.bsky.feed.post record on the owner's repo.",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "uri",
    "cid"
  ],
  "type": "object"
}

{
  "description": "A reference to one of the user's collections, in menu order.",
  "properties": {
    "collection": {
      "description": "AT-URI of an app.zeens.collection record on the owner's repo.",
      "format": "at-uri",
      "type": "string"
    }
  },
  "required": [
    "collection"
  ],
  "type": "object"
}

{
  "description": "Featured work: photos picked directly rather than through a collection. The heading is the owner's own — 'Featured Work' is one gallery's word for it and 'Selected' or 'Latest' is another's.",
  "properties": {
    "photos": {
      "description": "Photos chosen from the owner's own posts, in display order.",
      "items": {
        "ref": "#aboutPhoto",
        "type": "ref"
      },
      "maxLength": 12,
      "type": "array"
    },
    "title": {
      "description": "Section heading. ABSENT MEANS 'Featured Work' — the default lives in the render path, so it is not frozen into every record.",
      "maxLength": 60,
      "type": "string"
    }
  },
  "required": [
    "photos"
  ],
  "type": "object"
}

{
  "description": "A page hero: the owner's photos across the top of a page. One def serves all three arrangements because they are the same data seen differently. A hero with no photos is dropped on write rather than stored empty — an absent hero falls back to the owner's most-liked photos, which is a better empty state than a blank band.",
  "properties": {
    "mode": {
      "description": "'single' = one full-width photo; 'carousel' = a swipeable run of them; 'grid' = all of them as a grid. Unknown/absent reads as 'single'.",
      "knownValues": [
        "single",
        "carousel",
        "grid"
      ],
      "type": "string"
    },
    "photos": {
      "description": "Photos chosen from the owner's own posts, in display order. Only the first image of a multi-image post is used.",
      "items": {
        "ref": "#aboutPhoto",
        "type": "ref"
      },
      "maxLength": 6,
      "type": "array"
    }
  },
  "required": [
    "mode",
    "photos"
  ],
  "type": "object"
}

{
  "description": "Plain-text intro shown at the top of the portfolio home page. Deliberately NOT rich text: it renders into a public page, so a markup format would need sanitising and carry XSS surface. Mirrors how collections store their description.",
  "properties": {
    "body": {
      "description": "Home page paragraph, rendered with preserved line breaks.",
      "maxLength": 2000,
      "type": "string"
    },
    "heading": {
      "description": "Home page heading. When present it supplies the page's <h1>, and a home collection's own title renders as <h2> so the page keeps exactly one top-level heading.",
      "maxLength": 120,
      "type": "string"
    }
  },
  "type": "object"
}

{
  "description": "Navigation menu appearance. Its one property defaults to the behaviour that predates this def, so an absent `menu` never changes how a portfolio renders. Records written before the template took over navigation may still carry `icons` and `collections`; both axes were retired and readers ignore them.",
  "properties": {
    "homeCollections": {
      "description": "Whether the home page shows the owner's collections. ABSENT MEANS TRUE. When on, the home page shows the 3 most recently updated as a row linking through to the Galleries page that lists the rest. Lives here rather than on #homePage because it concerns the collections, not the home text, and an all-empty homePage is dropped from the record.",
      "type": "boolean"
    }
  },
  "type": "object"
}

{
  "description": "Controls which profile social links the public portfolio shows. Filtering is applied server-side AFTER the Bluesky link is synthesised from the owner's handle, so hiding Bluesky works even though it is not stored on the profile record.",
  "properties": {
    "mode": {
      "description": "'all' (also the meaning of an absent socials field) shows every link; 'selected' shows only the platforms in `shown`; 'none' hides the block entirely, website included.",
      "knownValues": [
        "all",
        "selected",
        "none"
      ],
      "type": "string"
    },
    "shown": {
      "description": "Platform ids to show when mode is 'selected'. Ignored for other modes.",
      "items": {
        "maxLength": 32,
        "type": "string"
      },
      "maxLength": 32,
      "type": "array"
    },
    "website": {
      "description": "Whether the profile website link is shown. Absent means true.",
      "type": "boolean"
    }
  },
  "required": [
    "mode"
  ],
  "type": "object"
}