🎁 Anugrah

Give with Grace — Share Joy, Spread Kindness 💝

A responsive donation platform connecting donors with communities

🚀 Features • 📖 Setup • 🛠️ Tech Stack • 📡 API

---

🌟 About Anugrah

Anugrah (Sanskrit: अनुग्रह - meaning grace or blessing) is a full-stack donation platform that allows users to donate items by submitting a form with item details, images, and location information. Built with session-based authentication and real-time form validation.

🚀 Features

📦 Core Features 📝 Donate items with description 📸 Optional image upload 📍 Auto-location via Geolocation API ✅ Real-time form validation 🔄 No page reload (AJAX) 🗃️ MongoDB storage

🔐 Security & UX 🔒 Session-based authentication 🍪 Cookie storage 🚪 Logout functionality 📱 Responsive design 🎨 Clean UI ⚡ Fast performance

🛠️ Tech Stack

Frontend

Backend

Additional Tools

⚙️ Setup Instructions

📋 Prerequisites

✓ Node.js >= 14.0.0
✓ MongoDB (local or Atlas)
✓ npm

🚀 Installation

# 1️⃣ Clone the repository
git clone https://github.com/yourusername/anugrah.git
cd anugrah

# 2️⃣ Install dependencies
npm install

# 3️⃣ Setup environment variables (if applicable)
# Create .env file with:
MONGO_URI=your_mongodb_connection_string
SESSION_SECRET=your_secret_key

# 4️⃣ Start the server
node server.js

# 5️⃣ Open in browser
# Visit http://localhost:5000

📁 Project Structure

anugrah/
│
├── 📂 public/
│   ├── donation.css              # Main stylesheet
│   ├── donor.png                 # Favicon/icon
│   └── home.html                 # Home page
│
├── 📂 views/
│   └── donate.html               # Donation form
│
├── 📂 uploads/                   # Uploaded images
│
├── 📂 models/
│   └── Donor.js                  # Mongoose schema
│
├── 📄 server.js                  # Main server file
├── 📄 package.json               # Dependencies
└── 📄 README.md                  # Documentation

📡 API Endpoints

Method	Endpoint	Description	Auth Required
GET	/	Serve home page	❌
GET	/donate	Serve donation form	✅
POST	/donor	Handle form submission (with image and location)	✅
GET	/logout	Destroy session and log out user	✅

🗄️ Database Schema

{
  item: String,               // Item name/title
  description: String,        // Detailed description
  latitude: Number,           // Geographic latitude
  longitude: Number,          // Geographic longitude
  imagePath: String,          // Path to uploaded image
  timestamp: {                // Auto-generated timestamp
    type: Date, 
    default: Date.now 
  }
}

🧪 Testing

Testing Checklist

• ✅ Submit valid form entries
• ✅ Submit invalid entries (test validation)
• ✅ Grant location permission
• ✅ Deny location permission
• ✅ Upload supported image formats (.jpg, .png)
• ✅ Verify data saved to MongoDB
• ✅ Test session authentication
• ✅ Test logout functionality

📷 Screenshots Gallery

🏠 Home Page

Clean landing page with easy navigation

---

📝 Donation Form

Intuitive form with real-time validation

---

📸 Image Upload & Details

Easy image upload with preview

---

📍 Location Tracking

Automatic location detection

---

✅ Form Submission

Success confirmations and feedback

---

🔐 Authentication

Secure login and session management

---

📱 Responsive Design

Works perfectly on all devices

---

🎨 UI Elements

Beautiful and functional interface

🤝 Contributing

Contributions are welcome! Here's how:

# Fork the repository
# Create your feature branch
git checkout -b feature/AmazingFeature

# Commit your changes
git commit -m 'Add some AmazingFeature'

# Push to the branch
git push origin feature/AmazingFeature

# Open a Pull Request

🙌 Acknowledgements

• MDN Web Docs - Web development resources
• Express.js - Web framework
• Mongoose - MongoDB ODM
• jQuery - JavaScript library
• Open Source Community ❤️

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Author

[Your Name]

💖 Support

If this project helped you, please consider giving it a ⭐️!

---

Built with 💚 | Made with ❤️ for Communities

⬆ Back to Top