🏡 Apna Adda

Your Place, Your People, Your Home

India's most trusted full-stack house rent & buy listing platform 🏘️

🚀 Quick Start | ✨ Features | 📸 Gallery | 🗺️ API Routes | 🔮 Roadmap

🌟 Vision

"Ghar ki talash, ab ho gayi aasan" — Making house hunting simple, secure, and Indian.

Apna Adda is more than just a property listing platform—it's your trusted companion in finding the perfect home. Built with Indian sensibilities at its core, we understand that a home isn't just four walls; it's where memories are made and dreams take shape.

Why Apna Adda?

🏠 Comprehensive Listings – Authority plots, freehold properties, apartments, industrial plots
🔒 Verified Owners – Aadhaar verification & ownership document authentication
💬 AI Assistant – Chat with our intelligent bot for instant property recommendations
📱 Mobile-First Design – Beautiful, responsive interface that works everywhere
🇮🇳 Made for India – Supports Indian property types, documents, and payment preferences

✨ Features Overview

👤 User Management Secure Authentication with bcrypt password hashing Session Management using Express + MongoDB Profile Updates including password changes Multi-Role System: Users, Tenants, Admins Document Upload for KYC verification Privacy First approach with data encryption	🤖 AI-Powered Features Apna Adda Chat Assistant for property queries Smart Recommendations based on preferences Natural Language Search for easy discovery Auto-Complete for locations and property types Intelligent Filtering by price, area, amenities Predictive Text throughout the platform
🏘️ Property Listings Multiple Categories: Authority Plots Freehold Properties Industrial Plots Flats & Apartments Rich Media Support with image uploads Detailed Specifications (area, price, location) Real-Time Updates to listing database Wishlist & Favorites functionality	👨‍💼 Admin & Owner Portal Verified Registration with Aadhaar Ownership Paper Upload for authenticity Listing Management (add/edit/delete) Tenant Applications review system Analytics Dashboard with insights Document Verification tools
🏠 Tenant Features Easy Application with photo upload Aadhaar Integration for quick verification Custom Offer System (negotiate prices) Lease Duration flexibility Application Tracking in real-time Direct Owner Contact after approval	🔐 Security & Trust Encrypted Passwords using bcrypt Session Security with HttpOnly cookies Input Sanitization against XSS/SQL injection File Upload Validation (type, size limits) CORS Protection for API security Rate Limiting to prevent abuse

🏗️ System Architecture

graph TB
    A[👤 Client Browser] --> B{Express Server}
    B --> C[🔐 Auth Middleware]
    C --> D[📊 MongoDB Database]
    
    B --> E[🤖 AI Chat API]
    B --> F[📁 Multer File Handler]
    F --> G[💾 Local Storage]
    
    D --> H[(Users Collection)]
    D --> I[(Tenants Collection)]
    D --> J[(Admins Collection)]
    D --> K[(Listings Collection)]
    D --> L[(Sessions Store)]
    
    B --> M[📄 JSON Data Files]
    M --> N[Authority Plots]
    M --> O[Freehold Properties]
    M --> P[Industrial Plots]
    M --> Q[Apartments]
    
    style B fill:#667eea,stroke:#764ba2,stroke-width:3px,color:#fff
    style D fill:#f093fb,stroke:#f5576c,stroke-width:3px,color:#fff
    style E fill:#4facfe,stroke:#00f2fe,stroke-width:3px,color:#fff

💻 Tech Stack Deep Dive

Backend Technologies

Technology	Purpose	Why We Chose It
	Runtime Environment	Non-blocking I/O, perfect for real-time apps
	Web Framework	Minimalist, flexible, vast middleware ecosystem
	Database	Schema flexibility, JSON-like documents
	ODM	Elegant schema modeling, validation
	File Uploads	Easy multipart/form-data handling
	Password Hashing	Industry-standard security

Frontend Stack

// Clean, modern frontend built with:
✅ HTML5 — Semantic markup
✅ CSS3 — Custom properties, Flexbox, Grid, Animations
✅ JavaScript (ES6+) — Modern async/await, modules
✅ jQuery — AJAX calls, DOM manipulation
✅ Responsive Design — Mobile-first approach

Project Structure

ApnaAdda/
│
├── 📁 server.js                    # Express app entry point
├── 📁 .env                         # Environment configuration
├── 📁 package.json                 # Dependencies
│
├── 📂 models/
│   ├── User.js                     # User schema & model
│   ├── Tenant.js                   # Tenant registration model
│   ├── Admin.js                    # Admin/owner model
│   └── Listing.js                  # Property listing model
│
├── 📂 routes/
│   ├── auth.js                     # User auth routes
│   ├── admin.js                    # Admin management routes
│   ├── listings.js                 # Property CRUD routes
│   └── tenant.js                   # Tenant application routes
│
├── 📂 middleware/
│   ├── authMiddleware.js           # Session validation
│   └── uploadMiddleware.js         # Multer configuration
│
├── 📂 public/
│   ├── 📂 css/
│   │   └── style.css              # Indian-inspired styling
│   ├── 📂 js/
│   │   └── main.js                # Client-side logic
│   ├── 📂 images/                 # Static assets
│   ├── Homepage.html              # Landing page
│   ├── login.html                 # User login
│   ├── register.html              # User signup
│   ├── admin.html                 # Admin dashboard
│   └── success.html               # Confirmation page
│
├── 📂 uploads/
│   ├── tenant/                    # Tenant photos
│   └── ownership_papers/          # Admin documents
│
├── 📂 data/
│   ├── authority-plots.json       # Authority plot listings
│   ├── freehold-property.json     # Freehold listings
│   ├── industrial-plots.json      # Industrial listings
│   └── flats-apartments.json      # Apartment listings
│
└── README.md

🗺️ API Routes

Authentication Routes

Method	Endpoint	Description	Request Body	Response
POST	`/register`	Register new user	`{Username, Email, Password}`	User object + session
POST	`/login`	User login	`{Email, Password}`	Session token
GET	`/session-info`	Get current user	-	User details
GET	`/logout`	Logout user	-	Success message

Admin Routes

Method	Endpoint	Description	Request Body	Response
POST	`/admin/register`	Admin signup with docs	`{name, email, password, aadhaar}` + files	Admin object
POST	`/admin/login-admin`	Admin authentication	`{email, password}`	Session token
GET	`/admin/session-info-admin`	Get admin session	-	Admin details
GET	`/admin/logout-admin`	Admin logout	-	Success message

Tenant Routes

Method	Endpoint	Description	Request Body	Response
POST	`/submit-details`	Register as tenant	Form data + photo	Tenant application

Listing Routes

Method	Endpoint	Description	Query Params	Response
GET	`/api/listings`	Fetch all listings	`?type=rent&city=delhi`	Array of listings
POST	`/add-listing`	Create new listing	`{city, title, type, rent, area}` + image	Created listing
GET	`/authority-plots`	Get authority plots	-	Array of plots
GET	`/freehold-property`	Get freehold listings	-	Array of properties
GET	`/industrial-plots`	Get industrial plots	-	Array of plots
GET	`/flats-apartments`	Get apartments	-	Array of flats

AI Chat Route

Method	Endpoint	Description	Request Body	Response
POST	`/api/chat`	Chat with AI assistant	`{message: "3BHK in Mumbai"}`	AI recommendations

Data Management Routes

Method	Endpoint	Description	Response
GET	`/load-data`	Load JSON to MongoDB	Success count
GET	`/load-authority-plots`	Sync authority plots	Loaded items
GET	`/load-freehold-property`	Sync freehold data	Loaded items
GET	`/load-industrial-plots`	Sync industrial plots	Loaded items
GET	`/load-flats-apartments`	Sync apartments	Loaded items

🗄️ Database Schemas

User Schema

const UserSchema = new mongoose.Schema({
  Username: { 
    type: String, 
    required: true,
    trim: true,
    minlength: 3 
  },
  Email: { 
    type: String, 
    required: true, 
    unique: true,
    lowercase: true,
    validate: {
      validator: function(v) {
        return /^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$/.test(v);
      }
    }
  },
  Password: { 
    type: String, 
    required: true,
    minlength: 6
  },
  createdAt: { type: Date, default: Date.now },
  updatedAt: { type: Date, default: Date.now }
}, { timestamps: true });

Tenant Schema

const TenantSchema = new mongoose.Schema({
  tenantName: { type: String, required: true, trim: true },
  age: { type: Number, required: true, min: 18 },
  email: { type: String, required: true, lowercase: true },
  phone: { 
    type: String, 
    required: true,
    validate: {
      validator: function(v) {
        return /^[6-9]\d{9}$/.test(v); // Indian mobile number
      }
    }
  },
  numPeople: { type: Number, required: true, min: 1 },
  propertySelected: { type: String, required: true },
  listedAmount: { type: Number, required: true },
  readyToPay: { type: Number, required: true },
  leaseTime: { 
    type: String, 
    enum: ['1 month', '3 months', '6 months', '1 year', '2 years'],
    required: true 
  },
  aadhaar: { 
    type: String, 
    required: true,
    validate: {
      validator: function(v) {
        return /^\d{12}$/.test(v); // 12-digit Aadhaar
      }
    }
  },
  photo: { type: String, required: true },
  status: { 
    type: String, 
    enum: ['pending', 'approved', 'rejected'],
    default: 'pending'
  }
}, { timestamps: true });

Admin Schema

const AdminSchema = new mongoose.Schema({
  name: { type: String, required: true, trim: true },
  email: { 
    type: String, 
    required: true, 
    unique: true,
    lowercase: true
  },
  passwordHash: { type: String, required: true },
  aadhaar: { 
    type: String, 
    required: true, 
    unique: true,
    validate: {
      validator: function(v) {
        return /^\d{12}$/.test(v);
      }
    }
  },
  ownershipPaperFileName: { type: String, required: true },
  isVerified: { type: Boolean, default: false },
  createdAt: { type: Date, default: Date.now }
});

Listing Schema

const ListingSchema = new mongoose.Schema({
  city: { 
    type: String, 
    required: true,
    index: true 
  },
  title: { type: String, required: true },
  type: { 
    type: String, 
    enum: ['rent', 'buy', 'lease'],
    required: true 
  },
  category: {
    type: String,
    enum: ['authority-plot', 'freehold', 'industrial', 'apartment'],
    required: true
  },
  rent: { type: Number, required: true, min: 0 },
  dateAdded: { type: Date, default: Date.now },
  area: { type: String, required: true },
  image: { type: String },
  amenities: [String],
  ownerId: { 
    type: mongoose.Schema.Types.ObjectId, 
    ref: 'Admin' 
  },
  views: { type: Number, default: 0 },
  isActive: { type: Boolean, default: true }
}, { timestamps: true });

🚀 Quick Setup

Prerequisites

📦 Node.js 14.x or higher
🗄️ MongoDB 4.x or higher (local or Atlas)
💻 npm or yarn package manager
🌐 Modern web browser

Installation Steps

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

# 2️⃣ Install dependencies
npm install

# 3️⃣ Create environment file
cat > .env << EOL
PORT=3000
MONGO_URI=mongodb://localhost:27017/apnaadda
SESSION_SECRET=your_super_secret_key_here_change_in_production
NODE_ENV=development
EOL

# 4️⃣ Create upload directories
mkdir -p uploads/tenant uploads/ownership_papers

# 5️⃣ Start MongoDB (if local)
mongod --dbpath /data/db

# 6️⃣ Run the application
npm start

# 7️⃣ Open in browser
# Navigate to: http://localhost:3000

Environment Variables

# .env configuration
PORT=3000                                    # Server port
MONGO_URI=mongodb://localhost:27017/apnaadda # MongoDB connection
SESSION_SECRET=change_this_in_production     # Session encryption key
NODE_ENV=development                         # Environment mode
CLOUDINARY_URL=cloudinary://...              # Optional: Cloud storage
AI_API_KEY=your_openai_key                   # Optional: AI chat feature

📸 Screenshots Gallery

🏠 Landing Page

Beautiful, welcoming homepage with featured listings

📝 User Registration

Simple, secure registration process

🔐 Login Interface

Clean login with session management

🏘️ Property Listings

Browse categorized properties with filters

📋 Property Details

Comprehensive property information

👨‍💼 Admin Dashboard

Powerful admin controls for listing management

📄 Tenant Application

Easy tenant registration with document upload

✅ Success Confirmation

Clear confirmation after successful actions

🤖 AI Chat Assistant

How It Works

The Apna Adda AI assistant uses natural language processing to help users find properties:

// Example chat interactions:

User: "I need a 2BHK flat in Mumbai under 25000"
AI:   "Found 12 properties matching your criteria..."

User: "Show me properties with parking"
AI:   "Here are 8 apartments with parking facilities..."

User: "What documents do I need for renting?"
AI:   "You'll need: Aadhaar card, recent photos, 
       income proof, and previous address proof..."

Auto-Complete Features

// Smart suggestions as you type:

Input: "Mum..."  →  Suggestions: Mumbai, Mumfordganj
Input: "2BH..."  →  Suggestions: 2BHK, 2BHK Apartment
Input: "Authority..." → Suggestions: Authority Plot, Authority Approved

🔐 Security Features

Password Security

// Password hashing with bcrypt (10 salt rounds)
const hashedPassword = await bcrypt.hash(plainPassword, 10);

// Password verification
const isValid = await bcrypt.compare(inputPassword, hashedPassword);

Session Security

// Secure session configuration
app.use(session({
  secret: process.env.SESSION_SECRET,
  resave: false,
  saveUninitialized: false,
  cookie: {
    httpOnly: true,      // Prevents XSS attacks
    secure: true,        // HTTPS only in production
    maxAge: 24*60*60*1000 // 24 hour session
  },
  store: MongoStore.create({ mongoUrl: process.env.MONGO_URI })
}));

File Upload Validation

// Multer configuration with security
const upload = multer({
  storage: diskStorage,
  limits: { fileSize: 5 * 1024 * 1024 }, // 5MB max
  fileFilter: (req, file, cb) => {
    const allowedTypes = ['image/jpeg', 'image/png', 'image/jpg'];
    if (allowedTypes.includes(file.mimetype)) {
      cb(null, true);
    } else {
      cb(new Error('Invalid file type. Only JPEG/PNG allowed.'));
    }
  }
});

🔮 Development Roadmap

Phase 1: MVP ✅ Completed

User authentication system
Admin/owner registration with verification
Tenant application system
Property listing CRUD operations
Multiple property categories
Document upload functionality
Session management

Phase 2: Enhanced Features 🚧 In Progress

🔍 Advanced Search with filters (price, location, amenities)
❤️ Wishlist & Favorites for users
📧 Email Notifications for applications
🗺️ Google Maps Integration for property locations
☁️ Cloud Storage (Cloudinary) for images
📱 Responsive Mobile UI improvements
🎨 Dark Mode theme toggle

Phase 3: Social & Interactive 📅 Planned - Q3 2025

💬 In-App Messaging between tenants and owners
⭐ Rating & Review System for properties
📊 Analytics Dashboard for admins
🔔 Real-Time Notifications using WebSockets
📅 Booking Calendar for property visits
💳 Payment Gateway integration (Razorpay/Stripe)
🏆 Verified Badge for trusted owners

Phase 4: Advanced Platform 📅 Planned - Q1 2026

📱 Native Mobile Apps (iOS & Android)
🤖 Advanced AI Recommendations using ML
🌐 Multi-Language Support (Hindi, Tamil, Bengali)
🔗 Social Login (Google, Facebook, Apple)
📈 Price Trend Analytics for localities
🎥 Virtual Tours with 360° photos
🔒 Blockchain for document verification

🎁 Bonus Features Ideas

For Users

📧 Email verification with OTP
🔔 Browser push notifications for new listings
💾 Save search preferences
📊 Compare up to 3 properties side-by-side
🎯 Set price alerts for desired areas

For Owners/Admins

📈 View analytics (views, inquiries, conversions)
🤖 Auto-response templates for common queries
📸 Bulk image upload for properties
📝 Property performance reports
💼 Portfolio management for multiple properties

Technical Enhancements

⚡ PWA support for offline access
🔍 SEO-friendly URLs for each listing
🎨 Customizable themes
🌙 Dark mode with user preference save
🚀 Redis caching for faster load times
📊 Google Analytics integration

🧪 Testing

API Testing with Postman/Thunder Client

// Sample test cases:

✅ POST /register
   Body: { Username: "test", Email: "test@gmail.com", Password: "123456" }
   Expected: 201 Created + user object

✅ POST /login
   Body: { Email: "test@gmail.com", Password: "123456" }
   Expected: 200 OK + session cookie

✅ GET /api/listings?city=Delhi&type=rent
   Expected: Array of Delhi rental properties

✅ POST /submit-details (with file upload)
   Expected: 201 Created + tenant application object

Manual Testing Checklist

User Flow:
 ☐ Register new account
 ☐ Login successfully
 ☐ View session info
 ☐ Browse listings
 ☐ Filter by category
 ☐ Apply as tenant
 ☐ Logout

Admin Flow:
 ☐ Register with Aadhaar + documents
 ☐ Admin login
 ☐ Add new listing
 ☐ View tenant applications
 ☐ Admin logout

Security:
 ☐ Cannot access protected routes without login
 ☐ Passwords are hashed in database
 ☐ Session expires after logout
 ☐ File uploads validated properly

🤝 Contributing

We welcome contributions from developers who believe in making housing accessible! 🏡

How to Contribute

# 1. Fork the repository
# 2. Create your feature branch
git checkout -b feature/amazing-feature

# 3. Commit your changes
git commit -m "Add: Amazing new feature description"

# 4. Push to the branch
git push origin feature/amazing-feature

# 5. Open a Pull Request

Contribution Guidelines

🐛 Bug Reports: Create detailed issue with steps to reproduce
✨ Feature Requests: Describe the feature and its benefits
💻 Code Contributions: Follow existing code style, add comments
📖 Documentation: Help improve README, add code comments
🎨 UI/UX: Design improvements always welcome

Code Style

// Follow these conventions:
✅ Use camelCase for variables: propertyId, userName
✅ Use PascalCase for models: User, Tenant, Listing
✅ Add comments for complex logic
✅ Use async/await over callbacks
✅ Handle errors properly with try-catch
✅ Validate all user inputs

👨‍💻 Developer

Siddharth Goutam Kumar

Information Technology Student @ VIT

📜 License

This project is licensed under the MIT License.

Copyright (c) 2025 Siddharth Goutam Kumar

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software.

See the LICENSE file for complete terms.

🙏 Acknowledgments

Inspiration

Housing.com & 99acres for inspiring the UI/UX
Indian Real Estate community for insights
Open Source Community for amazing tools

Technologies

MongoDB Atlas for cloud database hosting
Express.js team for the robust framework
Node.js community for the ecosystem

Special Thanks

Beta testers from VIT who provided feedback
Stack Overflow community for debugging help
GitHub for hosting and version control

Built with 🏡 and endless cups of chai 🍵

"Ghar ki talash, ab ho gayi aasan" 🏘️

⭐ Star this repo if Apna Adda helped you find your dream home!

⬆ Back to Top

Need Help? Have Questions? Let's Connect!

🐛 Report Bug | 💡 Request Feature | 🤝 Contribute

Making house hunting in India simple, secure, and accessible for everyone 🇮🇳

Name		Name	Last commit message	Last commit date
Latest commit History 25 Commits
assets		assets
frontend		frontend
models		models
uploads		uploads
Apna_Adda.html		Apna_Adda.html
Apna_Adda.md		Apna_Adda.md
BingSiteAuth (3).xml		BingSiteAuth (3).xml
BingSiteAuth.xml		BingSiteAuth.xml
README.md		README.md
access.log		access.log
authority_plots.json		authority_plots.json
data.json		data.json
flats_apartment.json		flats_apartment.json
freehold_property.json		freehold_property.json
industrial_plots.json		industrial_plots.json
package-lock.json		package-lock.json
package.json		package.json
server.js		server.js

SiddharthKumar268/Apna__Adda

Folders and files

Latest commit

History

Repository files navigation

🏡 Apna Adda

Your Place, Your People, Your Home

🌟 Vision

Why Apna Adda?

✨ Features Overview

👤 User Management

🤖 AI-Powered Features

🏘️ Property Listings

👨‍💼 Admin & Owner Portal

🏠 Tenant Features

🔐 Security & Trust

🏗️ System Architecture

💻 Tech Stack Deep Dive

Backend Technologies

Frontend Stack

Project Structure

🗺️ API Routes

Authentication Routes

Admin Routes

Tenant Routes

Listing Routes

AI Chat Route

Data Management Routes

🗄️ Database Schemas

User Schema

Tenant Schema

Admin Schema

Listing Schema

🚀 Quick Setup

Prerequisites

Installation Steps

Environment Variables

📸 Screenshots Gallery

🏠 Landing Page

📝 User Registration

🔐 Login Interface

🏘️ Property Listings

📋 Property Details

👨‍💼 Admin Dashboard

📄 Tenant Application

✅ Success Confirmation

🤖 AI Chat Assistant

How It Works

Auto-Complete Features

🔐 Security Features

Password Security

Session Security

File Upload Validation

🔮 Development Roadmap

Phase 1: MVP ✅ Completed

Phase 2: Enhanced Features 🚧 In Progress

Phase 3: Social & Interactive 📅 Planned - Q3 2025

Phase 4: Advanced Platform 📅 Planned - Q1 2026

🎁 Bonus Features Ideas

For Users

For Owners/Admins

Technical Enhancements

🧪 Testing

API Testing with Postman/Thunder Client

Manual Testing Checklist

🤝 Contributing

How to Contribute

Contribution Guidelines

Code Style

👨‍💻 Developer

📜 License

🙏 Acknowledgments

Inspiration

Technologies

Special Thanks

Built with 🏡 and endless cups of chai 🍵

"Ghar ki talash, ab ho gayi aasan" 🏘️

About

Topics

Resources

Packages