social.twinkl.theme.pack

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "The user's active look AND the unit of theme sharing (one per user, key=self). Holds the base theme, tokens, custom CSS, effects, and asset blobs (backgrounds/fonts) — which are kept live by this record's structural blob references. Listed in the public gallery by setting `gallery` to the Twinkl gallery DID (the publish property); discovered via constellation backlinks on `.gallery`. \"Stealing\" copies another user's pack into the applier's own self pack (copy-on-apply) — there is no live cross-repo reference, so a theme author can never retro-push CSS onto wearers. Custom CSS is sanitized + scoped server-side before it is ever rendered.",
      "key": "literal:self",
      "record": {
        "properties": {
          "active": {
            "description": "Which look is active: `base` renders the plain `customBase` built-in theme (the tokens/CSS/effects/background are kept but dormant); `custom` layers them on top of `customBase`. Absent on legacy records — readers then infer `custom` when any customization is present, else `base`.",
            "knownValues": [
              "base",
              "custom"
            ],
            "type": "string"
          },
          "assets": {
            "description": "Blobs referenced by the pack's CSS/tokens (backgrounds, cursors, fonts). Listed here so the PDS keeps them referenced; a CID used in CSS but absent here is rejected on save.",
            "items": {
              "accept": [
                "image/png",
                "image/jpeg",
                "image/webp",
                "image/gif",
                "font/woff2",
                "font/woff"
              ],
              "maxSize": 5000000,
              "type": "blob"
            },
            "maxLength": 16,
            "type": "array"
          },
          "background": {
            "description": "Optional page background image URL (a same-origin /blob/<did>/<cid> proxy URL or an allowlisted origin); the referenced blob must appear in `assets`.",
            "maxLength": 2048,
            "type": "string"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "customBase": {
            "default": "y2kringe",
            "description": "Built-in base theme whose tokens this pack layers on top of.",
            "knownValues": [
              "y2kringe",
              "gyaru"
            ],
            "type": "string"
          },
          "description": {
            "description": "Free-form description of the vibe.",
            "maxGraphemes": 300,
            "maxLength": 3000,
            "type": "string"
          },
          "effects": {
            "description": "Enabled first-party page effects.",
            "items": {
              "ref": "social.twinkl.theme.defs#effect",
              "type": "ref"
            },
            "maxLength": 8,
            "type": "array"
          },
          "gallery": {
            "description": "Set to the Twinkl gallery DID to list this pack publicly; omit or remove to unpublish. Gallery hydration re-verifies this value.",
            "format": "did",
            "type": "string"
          },
          "homeCss": {
            "description": "Custom home-page CSS (sanitized + scoped before use).",
            "maxLength": 100000,
            "type": "string"
          },
          "name": {
            "description": "Display name of the theme.",
            "maxGraphemes": 64,
            "maxLength": 640,
            "type": "string"
          },
          "postCss": {
            "description": "Post-decoration CSS (sanitized + scoped, never executes JS).",
            "maxLength": 50000,
            "type": "string"
          },
          "preview": {
            "accept": [
              "image/png",
              "image/jpeg",
              "image/webp"
            ],
            "description": "Optional preview thumbnail for the gallery.",
            "maxSize": 1000000,
            "type": "blob"
          },
          "priorThemeCid": {
            "description": "CID of the previous version of this look, for one-step rollback (best-effort).",
            "format": "cid",
            "type": "string"
          },
          "sourceTheme": {
            "description": "Provenance: the theme.pack this look was copied from. Backlink target for gallery wearer counts.",
            "format": "at-uri",
            "type": "string"
          },
          "sourceThemeCid": {
            "description": "CID of the pack version that was copied.",
            "format": "cid",
            "type": "string"
          },
          "tokens": {
            "description": "Open map of theme token name (e.g. the --twinkl-* custom properties) to a string value. All values are strings; names and value grammar are validated in application code.",
            "type": "unknown"
          },
          "updatedAt": {
            "format": "datetime",
            "type": "string"
          }
        },
        "required": [
          "name",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "id": "social.twinkl.theme.pack",
  "lexicon": 1
}