Lexicon Reference

Wisp.place uses custom AT Protocol lexicons to store and manage static site data. These lexicons define the structure of records stored in your PDS.

Available Lexicons

place.wisp.fs

The main lexicon for storing static site manifests. Contains the directory tree structure with references to file blobs.

place.wisp.subfs

Subtree lexicon for splitting large sites across multiple records. Entries from subfs records are merged (flattened) into the parent directory.

place.wisp.domain

Domain registration record for claiming wisp.place subdomains.

How Lexicons Work

Storage Model

Sites are stored as place.wisp.fs records in your AT Protocol repository:

at://did:plc:abc123/place.wisp.fs/my-site

Each record contains:

Site metadata (name, file count, timestamps)
Directory tree (hierarchical structure)
Blob references (content-addressed file storage)

File Processing

Files are gzipped for compression
Text files are base64 encoded to bypass PDS content sniffing
Uploaded as blobs with application/octet-stream MIME type
Original MIME type stored in manifest metadata

Large Site Splitting

Sites with 250+ files are automatically split:

Large directories are extracted into place.wisp.subfs records
Main manifest references subfs records via AT-URI
Hosting services merge (flatten) subfs entries when serving
Keeps manifest size under 150KB PDS limit

Example Record Structure

{
  "$type": "place.wisp.fs",
  "site": "my-site",
  "root": {
    "type": "directory",
    "entries": [
      {
        "name": "index.html",
        "node": {
          "type": "file",
          "blob": {
            "$type": "blob",
            "ref": { "$link": "bafyreiabc123..." },
            "mimeType": "application/octet-stream",
            "size": 12345
          },
          "encoding": "gzip",
          "mimeType": "text/html",
          "base64": true
        }
      },
      {
        "name": "assets",
        "node": {
          "type": "directory",
          "entries": [...]
        }
      }
    ]
  },
  "fileCount": 42,
  "createdAt": "2024-01-15T10:30:00Z"
}