docs: add readme

Author: unseen-ninja

readme.md

@@ -0,0 +1,69 @@
+ 
+
+# Pepperjack Loves Flags
+
+ 
+
+> »*Hold my flag.*«<br>
+>  — Pepperjack, probably
+
+**Pepperjack Loves Flags** is a tiny, fun web app that lets you choose a flag, watch Pepperjack (the Catppuccin mascot) hold it proudly, and download the result as a PNG.  
+
+Built for shits and giggles. 💜 <br>
+Not an official Catppuccin product!™
+
+&nbsp;
+
+## ✨ Features
+
+- **Works entirely client-side — no uploads, no tracking, no nonsense**
+- Pick from a huge list of flags
+- Live preview of Pepperjack holding your chosen flag
+- Optional outline styles and themes
+- Instant PNG download
+
+&nbsp;
+
+## 🖼 Credits
+
+- **Pepperjack** – Mascot of [Catppuccin](https://catppuccin.com/) (used here with love, but not affiliated)
+- **Flags** – Based on the open-source [Twemoji](https://twemoji.twitter.com/) set by Twitter
+
+&nbsp;
+
+## 🚀 Run it yourself!
+
+1. Clone the repo:
+```bash
+git clone https://github.com/unseen-ninja/pepperjack-flags.git
+cd pepperjack-flags
+```
+
+2. Install dependencies:
+```bash
+pnpm install
+```
+
+3. Run the dev server:
+```bash
+pnpm run dev
+```
+
+4. Open your browser and start waving some flags. 🎌
+
+&nbsp;
+
+## 📄 License
+
+This project is licensed under the MIT License.<br>
+Flag assets are under [CC-BY 4.0](https://creativecommons.org/licenses/by/4.0/) via Twemoji.
+
+&nbsp;
+
+&nbsp;
+
+<p align="center">
+  <a href="https://unseen.ninja">
+    <img src="https://img.shields.io/badge/-unseen%20ninja-fff?style=for-the-badge&color=EA33ED&labelColor=8819EC&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNTYgMjU2Ij4KICA8ZyBpZD0idGV4dCIgdHJhbnNmb3JtPSJtYXRyaXgoNS4xMTk4OSwwLDAsNS4xMTk4OSw4My44MTUxLDE2Ny42KSI+CiAgICAgIDxwYXRoIGQ9Ik0wLDUuNzU5TDAsLTExLjUwN0wxNy4yNiwtMTEuNTA3TDE3LjI2LDQuMzVDMTcuMjYsMTMuMjkzIDYuNzQ1LDE3LjI2NiA2Ljc0NSwxNy4yNjZMMy44NTcsMTMuOTQzQzMuNTAxLDEzLjUzMiAzLjU3NiwxMi45MDggNC4wMTIsMTIuNTgzQzcuODM2LDkuNzI0IDcuODM1LDcuMTczIDcuODM1LDcuMTczTDcuODM3LDUuNzU5TDAsNS43NTlaTTAsLTMyLjczNUwxNy4yNiwtMzIuNzM1TDE3LjI2LC0xNS40NzVMMCwtMTUuNDc1TDAsLTMyLjczNVoiIGZpbGw9IiNGNUY0NTEiLz4KICA8L2c+Cjwvc3ZnPg==">
+  </a>
+</p>