Porty Pet

Porty is a custom digital pet created with the hatch-pet workflow and inspired by the visual language of Portfolio 2026.

It combines several cues from the portfolio project:

• a friendly companion-like avatar feel
• modular design-system structure
• dashboard and workflow motifs
• blue-cyan, warm orange, and purple accent details

Why This Exists

This repository exists as both:

• a finished custom Codex pet package
• a documented generation run that shows how the final pet was produced, reviewed, and packaged

The goal is not just to keep the final asset, but to preserve the prompts, intermediate outputs, QA artifacts, and release history around Porty.

Project Status

Status: v1.0 complete

This repository is currently a finished first release. Future updates may include alternate visual themes, additional motion polish, or more companion pets inspired by other portfolio projects.

Final Output

The final packaged pet lives in Codex's pet directory:

• ~/.codex/pets/porty/pet.json
• ~/.codex/pets/porty/spritesheet.webp

The generated run artifacts used to build it are stored in this repository under:

• hatch-pet-runs/porty/

How To Use

If you want to use Porty as a custom Codex pet, the key files are:

• ~/.codex/pets/porty/pet.json
• ~/.codex/pets/porty/spritesheet.webp

If you want to inspect or reuse the generation run, start from:

• hatch-pet-runs/porty/final/spritesheet.webp
• hatch-pet-runs/porty/qa/contact-sheet.png
• hatch-pet-runs/porty/pet_request.json

Repository Structure

• hatch-pet-runs/porty/references/ Base identity reference and layout guides.
• hatch-pet-runs/porty/prompts/ Base prompt plus row-by-row animation prompts.
• hatch-pet-runs/porty/decoded/ Recorded image generation outputs for each animation state.
• hatch-pet-runs/porty/frames/ Extracted 192x208 frame cells used for atlas composition.
• hatch-pet-runs/porty/final/ Final spritesheet and validation output.
• hatch-pet-runs/porty/qa/ Contact sheet, QA reports, and preview videos.
• CHANGELOG.md Release history for the public repository.
• LICENSE Repository license for public reuse.

Animation States

Porty includes these animation rows:

• idle
• running-right
• running-left
• waving
• jumping
• failed
• waiting
• running
• review

QA Files

Useful review files in this repo:

• hatch-pet-runs/porty/qa/contact-sheet.png
• hatch-pet-runs/porty/qa/review.json
• hatch-pet-runs/porty/final/validation.json

Preview videos are also available under:

• hatch-pet-runs/porty/qa/videos/

Versioning

Release history is tracked in CHANGELOG.md.

Current release:

• v1.0.0 - first public Porty release

Notes

• running-left was generated as its own row instead of mirroring running-right, because Porty has asymmetric identity details on its side attachment and accent tab.
• The final spritesheet passed atlas validation and frame extraction checks during generation.
• The repository is published under the MIT license in LICENSE.