README.md

metadata

title: LocalLend
emoji: 🏘️
colorFrom: blue
colorTo: green
sdk: docker
app_port: 7860
pinned: false

LocalLend - Community Item Sharing Platform

LocalLend is a community-driven platform that connects neighbors to share items and build trust within their local community.

🌟 Features

• Item Listing & Browsing: Browse available items in your community
• Smart Search & Filters: Filter by category, condition, and ratings
• Booking System: Request to borrow items with date management
• Rating System: Rate items and users to build community trust
• User Profiles: View user trust scores and borrowing history
• Secure Authentication: JWT-based authentication system
• Image Management: Upload and manage item images via Cloudinary

🛠️ Tech Stack

Frontend:

• HTML5, CSS3, JavaScript (Vanilla JS)
• Responsive design with modern CSS

Backend:

• Spring Boot 3.5.6
• Java 17
• MongoDB for data persistence
• JWT for authentication
• Cloudinary for image storage

Deployment:

• Docker (single JAR deployment)
• Hugging Face Spaces

🚀 Getting Started

This application is automatically deployed from the GitHub repository and runs on Hugging Face Spaces.

Test Credentials

You can use these test accounts to explore the platform:

• Username: fasd@gmail.com
• Password: 12345678

📝 How to Use

1. Register/Login: Create an account or login with test credentials
2. Browse Items: View available items on the home page
3. Filter & Search: Use filters to find specific items
4. Book Items: Click on an item to view details and create a booking
5. Manage Bookings: View and manage your bookings from the dashboard
6. Rate & Review: After completing a booking, rate the item and owner

🔧 Environment Variables

The following environment variables are configured as Hugging Face Secrets:

• MONGODB_URI: MongoDB connection string (MongoDB Atlas)
• JWT_SECRET: Secret key for JWT token generation
• CLOUDINARY_CLOUD_NAME: Cloudinary cloud name
• CLOUDINARY_API_KEY: Cloudinary API key
• CLOUDINARY_API_SECRET: Cloudinary API secret

📦 Project Structure

locallend/
├── backend/                              # Spring Boot backend
│   ├── src/main/resources/static/        # Static HTML/CSS/JS frontend
│   │   ├── index.html
│   │   ├── styles.css
│   │   └── app.js
│   └── pom.xml
└── Dockerfile.huggingface                # Single-stage Spring Boot deployment

🤝 Contributing

This project is part of an academic project for Object-Oriented Analysis and Design (OOAD) course.

📄 License

This project is for educational purposes.

---

Deployed on Hugging Face Spaces | Auto-deployed via GitHub Actions