[] []

🧭 Lost & Found @ NYU

A web platform for NYU students to report lost items and find items found by others — powered by Flask, MongoDB, and full CI/CD with Docker and GitHub Actions.

---

🐳 Docker Images

• t1mmmmm/backend
• t1mmmmm/frontend

🟢 Live site: http://167.99.148.70:3000

---

Sites

🔗 Deployed frontend: http://167.99.148.70:3000
🔧 Deployed backend: http://167.99.148.70:5001

You can still run the project locally using the instructions below.

⚙️ Setup Instructions (Local Dev)

📦 Install Dependencies

# Install Python packages
pip install -r requirements.txt

---

Create Environment File

cp .env.example .env

edit the env file if needed, it should contain:

MONGO_URI=mongodb://mongo:27017/lostfound
SECRET_KEY=your-secret-key
DEBUG=True

---

Run Full System with Docker

docker-compose up --build

Frontend: http://localhost:3000 Backend: http://localhost:5001 MongoDB runs internally

When Done

docker-compose down

After Ctrl+C to stop the process and remove docker containers.

Note

Make sure Docker Desktop is installed and running.

If ports 3000 or 5001 are busy, stop other apps or change ports in docker-compose.yml.

Each subsystem has independent CI/CD with GitHub Actions and DockerHub image push.

👨‍💻 Contributors

• Tim Yan
• Kenny Pan
• Winter Li
• Warren Wu