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