https://github.com/vinulays/recychamp

RecyChamp is a mobile application promoting environmental sustainability by encouraging users to participate in recycling challenges. The app provides a platform for users to discover, join, and compete in various recycling challenges, earn badges, and contribute to a greener planet.
https://github.com/vinulays/recychamp

firebase flutter

Last synced: 3 months ago
JSON representation

RecyChamp is a mobile application promoting environmental sustainability by encouraging users to participate in recycling challenges. The app provides a platform for users to discover, join, and compete in various recycling challenges, earn badges, and contribute to a greener planet.

• Host: GitHub
• URL: https://github.com/vinulays/recychamp
• Owner: vinulays
• Created: 2024-01-15T14:55:01.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-04-01T05:14:21.000Z (about 1 year ago)
• Last Synced: 2025-01-10T16:42:03.549Z (4 months ago)
• Topics: firebase, flutter
• Language: Dart
• Homepage:
• Size: 2.58 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        

# RecyChamp

RecyChamp is a mobile application promoting environmental sustainability by encouraging users to participate in recycling challenges. The app provides a platform for users to discover, join, and compete in various recycling challenges, earn badges, and contribute to a greener planet.

[![Build & Release](https://github.com/vinulays/recychamp/actions/workflows/main.yml/badge.svg)](https://github.com/vinulays/recychamp/actions/workflows/main.yml)

## Features

- Discover and join recycling challenges organized by location, category, and difficulty.

- Participate in challenges by submitting evidence of recycling activities such as photos or videos.

- Earn badges and rewards based on participation and achievements.

- Buy environmentally friendly products.

## Technologies

- Flutter: The frontend framework used to build the cross-platform mobile app.

- Firebase: Provides backend services such as authentication, database, and storage for user data and challenge information.

- flutter_bloc: Utilized for managing complex application state and data flow.

## Authors

- [@MZ-MUZNI](https://github.com/MZ-MUZNI)

- [@ChamothMendis](https://github.com/ChamothMendis)

- [@vinulays](https://github.com/vinulays)

- [@rashmiNimesha](https://github.com/rashmiNimesha)

- [@Mezurh](https://github.com/Mezurh)

## Run Locally

Clone the project

```bash

  git clone https://github.com/vinulays/recychamp

```

Go to the project directory

```bash

  cd recychamp

```

Install dependencies

```bash

  flutter pub get

```

Run the app

```bash

  flutter run

```

## Screenshots

![App Screenshot](https://firebasestorage.googleapis.com/v0/b/recychamp.appspot.com/o/screenshots%2FScreenshot_1710901170.png?alt=media&token=2173216e-db58-4c28-a147-746889b1b13c)

![App Screenshot](https://firebasestorage.googleapis.com/v0/b/recychamp.appspot.com/o/screenshots%2FScreenshot_1710901396.png?alt=media&token=e1901c99-3a3b-4e61-b88d-5a273f78c262)

## Contributing

Contributions are always welcome!

- Fork the repository.

- Create a new branch (git checkout -b feature/your-feature).

- Make your changes.

- Commit your changes (git commit -am 'Add new feature').

- Push to the branch (git push origin feature/your-feature).

- Create a new Pull Request.

## Feedback

If you have any feedback, please reach out to us at [email protected]