+The visual assets are licensed **CC BY 4.0**, so you may use and modify them in
+commercial or non-commercial games and projects with attribution. The gallery,
+scripts, automation, and documentation use the MIT License.
+
+> If ShadowPets earns a place in your project, consider starring the repository.
+> It helps other small-game developers find the pack.
+
+## Use the pack in four steps
+
+1. Download and extract [`ShadowPets.zip`](https://github.com/throwingogo-hub/DigitalPets/releases/latest/download/ShadowPets.zip).
+2. Pick a static `PetName.png`, individual PNG frames, a looping GIF, or a
+ packed `sheet.png`.
+3. Import at **128×128** and enable nearest-neighbour / point filtering.
+4. Add this line to your credits, README, or asset-credits file:
-## The pack
+> ShadowPets by throwingogo-hub — https://github.com/throwingogo-hub/DigitalPets — licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/).
-The ten static PNGs live in [`ShadowPets/`](ShadowPets/). Complete animation
-sets live in [`ShadowPets/Animations/`](ShadowPets/Animations/).
+If you modify the artwork, say so in the credit. Copy-ready examples and the
+exact asset scope live in [`ATTRIBUTION.md`](ATTRIBUTION.md) and
+[`LICENSE-ASSETS.md`](LICENSE-ASSETS.md).
-- **128×128**, true pixel art at native resolution
-- **Transparent**, with a crisp one-pixel white outline
-- **17 colours**, one palette shared across the whole set
-- **Hard edges** — no anti-aliasing, no half-transparent pixels
+## What is included
-They're drawn to a single scale, so the pets sit together correctly without any
-resizing: Frost really is rounder than Comet, and Draco really is the big one.
+| Deliverable | Count | Size | Best for |
+|---|---:|---:|---|
+| Static transparent PNG | 10 | 128×128 | portraits, UI, simple scenes |
+| Individual animation PNG | 90 | 128×128 | engines and custom timing |
+| Ping-pong GIF loop | 30 | 128×128 | prototypes, web, previews |
+| Packed sprite sheet | 10 | 384×384 | one-texture engine imports |
-## Animations
+Every pet has `idle`, `bounce`, and `greet` motion. The visual set uses hard
+alpha—no half-transparent pixels—and one shared 17-colour palette. The sprites
+are drawn at a common scale, so Frost really is rounder than Comet and Draco
+really is the big one.
-Every pet has three looping animations:
+```text
+ShadowPets/
+├── Felis.png … Vesper.png
+└── Animations/
+ └── PetName/
+ ├── idle/01.png … 03.png
+ ├── bounce/01.png … 03.png
+ ├── greet/01.png … 03.png
+ ├── idle.gif / bounce.gif / greet.gif
+ └── sheet.png
+```
-- `idle` — rest, blink/dip, rise
-- `bounce` — anticipation, tiny bounce, landing
-- `greet` — a species-specific tail, wing, paw, ear, gill, or flipper gesture
+The release ZIP contains the game-ready files above plus a per-file SHA-256
+manifest, license, attribution text, and import notes. Preserved generation
+inputs remain in the repository for provenance but are intentionally excluded
+from the player-facing pack.
-Each loop was generated as part of that pet's own single 3×3 prompt sheet. The
-same prompt structure was used for all ten pets, keeping the motion language and
-rendering consistent without asking the model to redraw each frame separately.
+## Meet the companions
-
Felis
-
Corvus
-
Vesper
-
Luna
-
Ursa
+
Felis cat
+
Corvus crow
+
Vesper fox
+
Luna owl
+
Ursa bear cub
-
Lupus
-
Draco
-
Comet
-
Nova
-
Frost
+
Lupus wolf pup
+
Draco dragon
+
Comet bunny
+
Nova axolotl
+
Frost penguin
-Each pet folder contains:
+## Engine import notes
-```text
-PetName/
-├── idle/01.png … 03.png
-├── bounce/01.png … 03.png
-├── greet/01.png … 03.png
-├── idle.gif / bounce.gif / greet.gif
-└── sheet.png
+- **Godot:** set Texture Filter to `Nearest` and define three-frame animations
+ from each motion folder.
+- **Unity:** set Filter Mode to `Point (no filter)`, Compression to `None`, and
+ Pixels Per Unit consistently across all ten pets.
+- **Web:** use `image-rendering: pixelated;` and scale by whole numbers such as
+ 2×, 3×, or 4×.
+
+Avoid smooth filtering and fractional scaling: both blur deliberate pixel edges.
+
+## Asset provenance and quality gates
+
+Each pet's nine animation frames came from one dedicated 3×3 source sheet. The
+shared prompt structure, species-specific greeting rules, and final Luna/Ursa
+anatomy corrections are documented in
+[`ShadowPets/Animations/SOURCE.md`](ShadowPets/Animations/SOURCE.md).
+
+The asset validator enforces the public promise: exact pet/frame/GIF counts,
+dimensions, hard alpha, shared palette, GIF timing, packed-sheet fidelity,
+README/site links, licensing copy, social metadata, and a non-mutating
+pixel- and timing-exact rebuild across platforms. Release packaging is
+deterministic and verified twice.
+
+```bash
+python3 -m pip install -r requirements-dev.txt
+python3 tools/validate_assets.py --check-rebuild --check-package
+
+# Maintainers: create the same release files CI creates.
+python3 tools/package_release.py --output dist
```
-Every individual PNG frame and animated GIF canvas is **128×128**. `sheet.png`
-is the same nine frames packed into a 384×384 3×3 sprite sheet. See
-[`Animations/SOURCE.md`](ShadowPets/Animations/SOURCE.md) for the shared prompt
-template and generation details.
+Do not run `tools/build_animations.py` against the repository casually: it is a
+derivation tool for approved source sheets. CI rebuilds into a temporary
+directory so validation never mutates tracked artwork.
-## Using them
+## Licensing
-Scale by **whole numbers only** — 2×, 3×, 4× — and use nearest-neighbour
-sampling. Any other factor, or smooth scaling, will blur the pixels and undo the
-look.
+- **Visual assets:** everything under `ShadowPets/` plus `social-preview.png`
+ uses [CC BY 4.0](LICENSE-ASSETS.md).
+- **Code and documentation:** `index.html`, `tools/`, `.github/`, and Markdown
+ documentation use the [MIT License](LICENSE).
-CSS: `image-rendering: pixelated;` · Unity: Filter Mode `Point (no filter)` ·
-Godot: Texture Filter `Nearest`
+The repository URL remains `DigitalPets` so existing links, clones, and Pages
+deployments keep working; the collection's public-facing name is **ShadowPets**.
diff --git a/index.html b/index.html
index d13539a..d424a50 100644
--- a/index.html
+++ b/index.html
@@ -3,8 +3,24 @@
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
ShadowPets Motion Lab
