Initial commit

README.md

@@ -0,0 +1,21 @@
+<img width="1638" height="1638" alt="app_icon (Edit)" src="https://github.com/user-attachments/assets/34f61a86-bfde-4233-b53e-38b3e861b31b" />
+
+# 🌙 Pocket Oracle
+
+A comprehensive, user-friendly Tarot reading application for Android and iOS.
+
+## ✨ Features
+
+- **Dynamic Spreads:** Choose from Daily Pull, 3-Card Spread, Horseshoe, and Celtic Cross.
+- **Mystical UI:** Twinkling animated starfield background and smooth card-flip animations.
+- **Encyclopedia:** Full library of 78 cards with search and suit-filtering logic.
+- **Cloud Journal:** Save your readings to Firebase with personal notes.
+- **Personalization:** Discover your Birth Card and choose custom deck backs.
+- **Tactile Feedback:** Crisp haptic vibrations and high-quality card sounds.
+
+## 🛠️ Tech Stack
+
+- **Framework:** Flutter
+- **Database/Auth:** Firebase (Firestore & Anonymous Auth)
+- **State Management:** StatefulWidget / setState
+- **Graphics:** Custom Painter & 3D FlipCard