Thanks to visit codestin.com
Credit goes to github.com

Skip to content

EcoQuest is a comprehensive platform designed to promote environmental awareness and sustainability through interactive challenges, educational resources, and community engagement. Built primarily in Python, EcoQuest

Notifications You must be signed in to change notification settings

SatyamPote/EcoQuest

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

EcoQuest

EcoQuest is a comprehensive platform designed to promote environmental awareness and sustainability through interactive challenges, educational resources, and community engagement. Built primarily in Python, EcoQuest aims to gamify eco-friendly habits and empower users to make a positive impact on the planet.


🌱 Table of Contents


📖 About

EcoQuest is an open-source project focused on encouraging sustainable living. Users participate in eco-challenges, track their progress, learn about environmental issues, and collaborate with a like-minded community. The platform is ideal for individuals, schools, and organizations looking to gamify green habits and environmental education.


🚀 Features

  • Interactive Eco-Challenges: Participate in daily, weekly, or custom challenges to promote eco-friendly actions (e.g., recycling, reducing water usage).
  • Progress Tracking: Visualize your environmental impact and achievements over time.
  • Educational Resources: Access articles, videos, and quizzes on environmental topics.
  • Community Leaderboards: Compete and collaborate with friends, classmates, or coworkers.
  • Rewards & Badges: Earn digital badges and rewards for completing challenges.
  • Customizable Profiles: Personalize your avatar and share your progress.
  • Notifications: Stay informed about new challenges and community milestones.
  • Admin Dashboard: Tools for moderators to create challenges and manage content.

📷 Screenshots

Add screenshots or GIFs to demonstrate the app. (You can add images to a /assets folder and reference them here)

Dashboard Screenshot Challenge Example


🛠️ Installation

Prerequisites

  • Python 3.8+
  • Pip (Python package manager)
  • (Optional) Node.js & npm (if frontend is in JavaScript)
  • Git

Clone the Repository

git clone https://github.com/SatyamPote/EcoQuest.git
cd EcoQuest

Set Up a Virtual Environment (Recommended)

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install Dependencies

pip install -r requirements.txt

If the project has a frontend:

cd frontend
npm install

Database Setup

  • Configure your database settings in config.py or .env as needed.
  • Run migrations or initialize the database:
# Example for Flask-Migrate
flask db upgrade

▶️ Usage

Start the development server:

python app.py

Or, if using a framework:

flask run
# or
uvicorn main:app --reload  # For FastAPI

Access the app at http://localhost:5000 (or the relevant port).


🗂 Project Structure

EcoQuest/
│
├── app.py                  # Entry point for the backend server
├── requirements.txt        # Python dependencies
├── README.md               # Project documentation
├── config.py               # Configuration settings
├── /static                 # Static files (images, CSS, JS)
├── /templates              # HTML templates (if using Flask/Django)
├── /frontend               # Frontend code (if applicable)
├── /assets                 # Screenshots and demo images
├── /docs                   # Additional documentation
├── /tests                  # Test cases
└── ...                     # Other source files and modules

🧑‍💻 Technologies Used

  • Backend: Python (Flask / Django / FastAPI)
  • Frontend: (If applicable) JavaScript (React / Vue.js), HTML, CSS
  • Database: SQLite / PostgreSQL / MongoDB (customize as per your setup)
  • Other: C++, C (for performance-critical features), Cython, PowerShell scripts

🤝 Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository.
  2. Create your feature branch: git checkout -b feature/YourFeature
  3. Commit your changes: git commit -m 'Add some feature'
  4. Push to the branch: git push origin feature/YourFeature
  5. Open a Pull Request.

Please read CONTRIBUTING.md if available, or open an issue for discussion.


📄 License

This project is licensed under the MIT License. See the LICENSE file for details.


📬 Contact


"Be the change you wish to see in the world. Start your EcoQuest today!"

About

EcoQuest is a comprehensive platform designed to promote environmental awareness and sustainability through interactive challenges, educational resources, and community engagement. Built primarily in Python, EcoQuest

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •