# net.anisota.observatory.layout > Published by [anisota.net](https://lexicon.garden/identity/did:plc:lcieujcfkv4jx7gehsvok3pr) ## Links - [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:lcieujcfkv4jx7gehsvok3pr/net.anisota.observatory.layout) - [Documentation](https://lexicon.garden/lexicon/did:plc:lcieujcfkv4jx7gehsvok3pr/net.anisota.observatory.layout/docs) - [Examples](https://lexicon.garden/lexicon/did:plc:lcieujcfkv4jx7gehsvok3pr/net.anisota.observatory.layout/examples) ## Definitions ### `net.anisota.observatory.layout` **Type**: `record` A saved Observatory grid layout. Each record is a complete, self-contained snapshot of a layout — built-in button configuration, unified tile order, and embedded element snapshots — so it can be shared by URL and saved ('learned') into another user's PDS without depending on the original author's element records, mirroring the spell architecture. tileOrder entries are 'builtin:' for built-in tiles or 'element:' pointing into the embedded elements array. An optional schedule makes the layout activate automatically during a daily time window. **Key**: `any` | Property | Type | Required | Description | |----------|------|----------|-------------| | `name` | `string` | Yes | Display name for this layout | | `layout` | `ref` → `#layout` | No | | | `source` | `ref` → `#source` | No | | | `elements` | `array` | No | Embedded snapshots of the custom elements this layout uses. Each entry mirrors the shape of a net.anisota.observatory.element record body (type, name, description, plus the type-specific payload: button, note, quote, reminder, divider, spacer, heading, or widget). | | `schedule` | `ref` → `#schedule` | No | | | `createdAt` | `string` (datetime) | Yes | When this layout was first saved | | `createdBy` | `ref` → `#createdBy` | No | | | `updatedAt` | `string` (datetime) | Yes | When this layout was last modified | | `description` | `string` | No | Optional description of what this layout is for | ### `net.anisota.observatory.layout#layout` **Type**: `object` The grid configuration captured by this layout. | Property | Type | Required | Description | |----------|------|----------|-------------| | `buttons` | `unknown` | No | Built-in button overrides keyed by button key (enter, atmosphere, post, chronicle, inventory, harvest, tutorial). Each value may carry enabled, order, size, and variant. | | `tileOrder` | `array` | No | Unified rendering order. Entries are 'builtin:' or 'element:' into the record's elements array. | | `shuffleLayout` | `boolean` | No | Whether tiles shuffle within divider-bounded groups each session | | `patternsIndicator` | `unknown` | No | Patterns visualization configuration captured with this layout | ### `net.anisota.observatory.layout#source` **Type**: `object` Provenance backlink for layouts learned from another user. | Property | Type | Required | Description | |----------|------|----------|-------------| | `type` | `string` | No | | | `originalDid` | `string` (did) | No | DID of the user this layout was learned from | | `originalUri` | `string` (at-uri) | No | AT URI of the record this layout was learned from | ### `net.anisota.observatory.layout#schedule` **Type**: `object` Optional daily activation window. When enabled, the layout takes over the Observatory between startTime and endTime (wrapping past midnight when startTime > endTime), optionally restricted to certain days of the week. | Property | Type | Required | Description | |----------|------|----------|-------------| | `enabled` | `boolean` | No | Whether the schedule is active | | `endTime` | `string` | No | Window end as 'HH:MM' (24-hour, local time) | | `startTime` | `string` | No | Window start as 'HH:MM' (24-hour, local time) | | `daysOfWeek` | `array` | No | Days the window applies to (0 = Sunday … 6 = Saturday). Empty or absent means every day. | ### `net.anisota.observatory.layout#createdBy` **Type**: `object` Attribution for the original crafter of this layout. | Property | Type | Required | Description | |----------|------|----------|-------------| | `did` | `string` (did) | No | | | `handle` | `string` (handle) | No | | ## Raw Schema ```json { "id": "net.anisota.observatory.layout", "defs": { "main": { "key": "any", "type": "record", "record": { "type": "object", "required": [ "name", "createdAt", "updatedAt" ], "properties": { "name": { "type": "string", "maxLength": 80, "description": "Display name for this layout" }, "layout": { "ref": "#layout", "type": "ref" }, "source": { "ref": "#source", "type": "ref" }, "elements": { "type": "array", "items": { "type": "unknown" }, "description": "Embedded snapshots of the custom elements this layout uses. Each entry mirrors the shape of a net.anisota.observatory.element record body (type, name, description, plus the type-specific payload: button, note, quote, reminder, divider, spacer, heading, or widget)." }, "schedule": { "ref": "#schedule", "type": "ref" }, "createdAt": { "type": "string", "format": "datetime", "description": "When this layout was first saved" }, "createdBy": { "ref": "#createdBy", "type": "ref" }, "updatedAt": { "type": "string", "format": "datetime", "description": "When this layout was last modified" }, "description": { "type": "string", "maxLength": 500, "description": "Optional description of what this layout is for" } } }, "description": "A saved Observatory grid layout. Each record is a complete, self-contained snapshot of a layout — built-in button configuration, unified tile order, and embedded element snapshots — so it can be shared by URL and saved ('learned') into another user's PDS without depending on the original author's element records, mirroring the spell architecture. tileOrder entries are 'builtin:' for built-in tiles or 'element:' pointing into the embedded elements array. An optional schedule makes the layout activate automatically during a daily time window." }, "layout": { "type": "object", "properties": { "buttons": { "type": "unknown", "description": "Built-in button overrides keyed by button key (enter, atmosphere, post, chronicle, inventory, harvest, tutorial). Each value may carry enabled, order, size, and variant." }, "tileOrder": { "type": "array", "items": { "type": "string", "maxLength": 64 }, "description": "Unified rendering order. Entries are 'builtin:' or 'element:' into the record's elements array." }, "shuffleLayout": { "type": "boolean", "description": "Whether tiles shuffle within divider-bounded groups each session" }, "patternsIndicator": { "type": "unknown", "description": "Patterns visualization configuration captured with this layout" } }, "description": "The grid configuration captured by this layout." }, "source": { "type": "object", "properties": { "type": { "type": "string", "knownValues": [ "original", "learned" ] }, "originalDid": { "type": "string", "format": "did", "description": "DID of the user this layout was learned from" }, "originalUri": { "type": "string", "format": "at-uri", "description": "AT URI of the record this layout was learned from" } }, "description": "Provenance backlink for layouts learned from another user." }, "schedule": { "type": "object", "properties": { "enabled": { "type": "boolean", "description": "Whether the schedule is active" }, "endTime": { "type": "string", "maxLength": 5, "description": "Window end as 'HH:MM' (24-hour, local time)" }, "startTime": { "type": "string", "maxLength": 5, "description": "Window start as 'HH:MM' (24-hour, local time)" }, "daysOfWeek": { "type": "array", "items": { "type": "integer", "maximum": 6, "minimum": 0 }, "maxLength": 7, "description": "Days the window applies to (0 = Sunday … 6 = Saturday). Empty or absent means every day." } }, "description": "Optional daily activation window. When enabled, the layout takes over the Observatory between startTime and endTime (wrapping past midnight when startTime > endTime), optionally restricted to certain days of the week." }, "createdBy": { "type": "object", "properties": { "did": { "type": "string", "format": "did" }, "handle": { "type": "string", "format": "handle" } }, "description": "Attribution for the original crafter of this layout." } }, "$type": "com.atproto.lexicon.schema", "lexicon": 1 } ```