🌱 EcoLink

A web application built for the Zayed Hackathon. EcoLink connects people around sustainability, helping users track eco-friendly actions, discover green initiatives, and engage with a community working toward environmental impact. The backend is a structured FastAPI project with separate layers for routing, services, models, and configuration.

---

🔗 Live Site

👉 eco-link-nine.vercel.app

---

🧠 What It Does

EcoLink is a platform that encourages and tracks sustainable behavior. Users can log in, explore eco initiatives, and participate in community-driven environmental challenges. The backend handles authentication, data models, and business logic through a clean, layered architecture.

---

📁 Repo Structure

Zayed-Hackathon/
├── main.py             # FastAPI entry point
├── routers/            # API route handlers (auth, users, actions, etc.)
├── models/             # Database models and schemas
├── services/           # Business logic layer
├── config/             # App configuration and environment settings
├── dependencies/       # Shared dependencies (auth, database session)
├── requirements.txt    # Python dependencies
└── .gitignore

---

⚙️ Requirements

pip install -r requirements.txt

Key dependencies include FastAPI, Uvicorn, and supporting libraries for authentication and data handling.

---

🚀 Running It Locally

1. Clone the repo

git clone https://github.com/radhika-khatri/Zayed-Hackathon.git
cd Zayed-Hackathon

2. Install dependencies

pip install -r requirements.txt

3. Set up environment variables

Create a .env file in the root directory and add any required configuration values (database URL, secret key, etc.) as specified in the config/ folder.

4. Start the server

uvicorn main:app --reload

The API will be available at http://localhost:8000. You can explore the auto-generated API docs at http://localhost:8000/docs.

---

🖥️ How to Use It

1. Visit the live site at eco-link-nine.vercel.app.
2. Create an account or log in.
3. Explore eco initiatives and challenges available on the platform.
4. Log sustainable actions and track your progress.
5. Engage with the community and see the collective impact.

---

🛠️ Built With

• FastAPI for the backend API
• Uvicorn as the ASGI server
• Vercel for frontend deployment
• Python for all backend logic

---

👤 Author

Radhika Khatri
GitHub Profile