# 🦝 Possum Paradise

Welcome to **Possum Paradise** — a cozy little web app to browse, enjoy, and share pictures of possums!

![Preview](https://possumparadise.com/static/icon/image.jpg)

---

## 🖼 What is this?

**Possum Paradise** is a playful frontend app designed to:

* Show you a random possum image with each click
* Let you **download** or **share** that possum instantly
* Provide a fun, cozy visual experience with 🐾 paw prints and 🎉 celebration emojis

---

## 🔧 Features

* **Possum Generator**: Fetches a new image from a backend `/api` endpoint.
* **Stylish Interface**: Hand-crafted CSS using Comic Neue and possum-themed aesthetics.
* **Animated Background**: Includes floating paw prints and celebratory raccoon emojis.
* **Image Downloading**: One-click download of the currently displayed possum.
* **Sharing Support**: Uses `navigator.share` when available, with a fallback copy-to-clipboard toast.
* **Responsive Design**: Looks good on both desktop and mobile.

---

## 🚀 Getting Started (Frontend Only)

If you're serving this frontend yourself (e.g., via Flask, Express, or static hosting):

1. Save the code as `index.html`
2. Make sure your server provides a `/api` endpoint that returns JSON in the format:

   ```json
   { "url": "https://example.com/images/possum123.jpg" }
   ```
3. Optionally serve images from a `/static/` folder or another CDN path.
4. Open the HTML in a browser and enjoy!

---

## 🧠 Backend Expectations

The frontend expects an API endpoint at:

```
GET /api
```

...that responds with JSON like:

```json
{
  "url": "https://possumparadise.com/images/possum001.jpg"
}
```

💡 The frontend dynamically loads and displays this image.

> **Note**: Backend logic is not included here, and you’re free to implement it however you'd like.

---

## 📸 Screenshot

![screenshot of possum paradise interface](https://possumparadise.com/static/images/hyprshot.png)

---

## 🙈 Credits

* Font: [Comic Neue](https://fonts.google.com/specimen/Comic+Neue)
* Background patterns: [Transparent Textures](https://www.transparenttextures.com/)
* Emojis: Unicode raccoons, paw prints, and party icons 🎉

---

## 🐾 Live Site

Visit the live project here:
🌐 [https://possumparadise.com](https://possumparadise.com)