📿 Paap–Punya Tracker

A personal spiritual self-tracking app inspired by Bhagavatam, Garud Puran, Bhagavad Gita, and Vishnu Purana. The app helps users record daily Punya (virtuous deeds) and Paap (sins/mistakes), calculate totals, and visualize progress over time.

---

✨ Features

• ✅ Checklist of Paap & Punya categorized by minor, moderate, and major
• 📊 Daily scoring system (positive = Punya, negative = Paap)
• 💾 Save & load daily progress (stored in browser localStorage)
• 📅 Calendar view with daily totals
• 📈 Monthly & yearly point summaries
• 🔄 Export & import JSON backups
• 📌 Fixed score bar always visible at bottom
• 📧 Contact & copyright footer

---

🌐 Live Demo

👉 Paap–Punya Calculator

---

🚀 Getting Started

Prerequisites

• Node.js (>=16)
• npm or yarn

Installation

# Clone the repo
git clone https://github.com/adityananaware/paap-punya-tracker.git
cd paap-punya-tracker

# Install dependencies
npm install

# Run locally
npm start

The app will be available at http://localhost:3000.

---

📂 Project Structure

paap-punya-tracker/
│── src/
│   ├── App.jsx         # Main app logic
│   ├── Footer.jsx      # Footer with copyright & contact
│   ├── data/
│   │   └── paapPunya.js # List of deeds with scores
│   └── components/     # Additional UI components
│
├── public/
│   └── index.html
│
├── package.json
├── README.md

---

📜 Scripts

• npm start → run development server
• npm run build → build production files
• npm test → run tests (if added)

---

🛠️ Technologies Used

• React + Vite (or CRA)
• TailwindCSS (UI styling)
• LocalStorage API (data persistence)

---

📧 Contact

For suggestions, issues, or contributions:

• Email: adityananaware2@gmail.com
• GitHub: adityananaware

---

⚖️ License

copyright License © 2025 Aditya Nanaware. Feel free to use and share. Do Not copy or modify.

---

🙏 Inspired by Sanatan Dharma scriptures for self-reflection and personal growth.