---
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