# 🐱 Awwnimate: The Ultimate Browser Pet Collection

Awwnimate is a premium interactive experience that brings adorable screen pets to your browser. Based on the classic `oneko.js`, it features enhanced physics, traits, and an interactive playground.

---

## ✨ Features

- **21+ Adorable Pets**: From the original cat to Eevee, Fox, and more.
- **Unique Traits**: Every pet has a personality (Swift, Floaty, Lazy, etc.) that affects its speed.
- **Interactive Playground**: Drop treats (🧀) for your pets to chase!
- **Awwnimate Studio**: A dedicated tool to help you create and test custom sprite sheets.

---

## 📂 Project Structure

- `/index.html`: The main pet gallery and playground.
- `/studio.html`: The custom pet creation tool.
- `/js/`:
  - `oneko.js`: Core animation engine (Refactored for traits).
  - `main.js`: Gallery logic and trait definitions.
- `/css/`:
  - `styles.css`: Premium aesthetics and layout.
- `/assets/`: Pet sprite sheets and icons.
- `/docs/`: Technical specifications and user guides.

---

## 🚀 Getting Started

1. Open `index.html` in any modern browser.
2. Select a pet from the grid to adopt it.
3. Click in the "Pet Playground" to drop a treat and watch your pet rush to it!

Developed with 💖 by the Awwnimate Team.