a46764fb1b
ci / Validate workspace (push) Has been cancelled
landing-page-ci / Validate landing page (push) Has been cancelled
landing-page-deploy / Deploy landing page (push) Has been cancelled
github-metrics / Generate repository metrics SVG (push) Has been cancelled
refresh-contributors-wall / Refresh contributors wall cache bust (push) Waiting to run
36 lines
788 B
Markdown
36 lines
788 B
Markdown
# Codex Pet Contract
|
|
|
|
## Sprite Atlas
|
|
|
|
- Format: PNG or WebP.
|
|
- Dimensions: `1536x1872`.
|
|
- Grid: 8 columns x 9 rows.
|
|
- Cell: `192x208`.
|
|
- Background: transparent.
|
|
- Unused cells: fully transparent.
|
|
|
|
The webview animation uses CSS background positions from the fixed row and column counts. Do not add labels, gutters, borders, grid lines, shadows outside the cell, or extra frames.
|
|
|
|
## Local Custom Pet Package
|
|
|
|
Place files under:
|
|
|
|
```text
|
|
${CODEX_HOME:-$HOME/.codex}/pets/<pet-name>/
|
|
├── pet.json
|
|
└── spritesheet.webp
|
|
```
|
|
|
|
Manifest shape:
|
|
|
|
```json
|
|
{
|
|
"id": "pet-name",
|
|
"displayName": "Pet Name",
|
|
"description": "One short sentence.",
|
|
"spritesheetPath": "spritesheet.webp"
|
|
}
|
|
```
|
|
|
|
The app loads custom pets from the folder name under `${CODEX_HOME:-$HOME/.codex}/pets/`.
|