Skip to content

TrashMob-eco/TrashMob

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5,627 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

TrashMob.eco

Meet up. Clean up. Feel good.

Build Status

What is TrashMob?

TrashMob.eco is a platform dedicated to organizing groups of people to clean up the world we live in. Users create cleanup events, publicize them, and recruit people to join up, as well as ask for assistance from communities and partners to help haul away the garbage once it is gathered.

The idea is to turn what can be an intimidating process for event organizers into a few clicks and simple forms. And once the process is simple, events will spring up all over the world, and the cleanup of the world can begin.

Live Sites

Environment URL
Production www.trashmob.eco
Development dev.trashmob.eco
Dev Swagger dev.trashmob.eco/swagger

Mobile Apps

Platform Link
Android Google Play Store
iOS Apple App Store

Quick Start

For detailed development setup instructions, see CLAUDE.md.

Prerequisites

Build & Run

See CLAUDE.md for full build commands, local URLs, and development setup.


Documentation

For Developers

Document Description
CLAUDE.md Development guide, architecture, coding standards
CONTRIBUTING.md How to contribute
CODE_OF_CONDUCT.md Community guidelines

Product & Planning

Document Description
2026 Planning Hub Roadmap, projects, and milestones
TrashMob.prd Web API product requirements
TrashMobMobile.prd Mobile app product requirements

Support & Operations

Document Description
Troubleshooting Guide Common issues and solutions by feature area
Community Admin Onboarding Step-by-step setup guide for new community partners
Event Day Playbook What to do when things break during a live event
Support Channels & Triage Support channels, SLA targets, triage workflow
Product Support Role Role definition and responsibilities

Technical Reference

Document Description
Domain Model Core data concepts, business rules, entity relationships
Test Scenarios Manual testing checklist
Deploy Guide Infrastructure deployment
Container Deployment Docker/ACA deployment

Project-Specific

Project README
TrashMob (Web API) TrashMob/README.md
TrashMob.Shared TrashMob.Shared/README.md
TrashMob.Models TrashMob.Models/README.md
TrashMobMobile TrashMobMobile/readme.md
Mobile Analysis TrashMobMobile/docs/PROJECT_ANALYSIS.md

Project Structure

TrashMob/
├── TrashMob/              # ASP.NET Core Web API + React SPA
│   └── client-app/        # React frontend (Vite + TypeScript)
├── TrashMob.Shared/       # Business logic, managers, EF Core
├── TrashMob.Models/       # Domain entities
├── TrashMob.Shared.Tests/ # Unit tests
├── TrashMobMobile/        # .NET MAUI mobile app
├── TrashMobDailyJobs/     # Background jobs (daily)
├── TrashMobHourlyJobs/    # Background jobs (hourly)
├── Deploy/                # Bicep templates, deployment scripts
└── Support/               # Product support docs, troubleshooting, playbooks

Contributing

We're actively looking for contributors! All skill levels welcome:

  • Frontend: React, TypeScript, Tailwind CSS
  • Backend: ASP.NET Core, Entity Framework Core
  • Mobile: .NET MAUI
  • DevOps: GitHub Actions, Azure, Bicep

Getting Started

  1. Check Good First Issues
  2. Read CONTRIBUTING.md
  3. Set up your dev environment using CLAUDE.md
  4. Contact info@trashmob.eco to be added as a contributor

Feature Ideas

Before starting work on a new feature, please check:


Development Environment Setup

See CLAUDE.md for full development setup, troubleshooting, and local URLs.

Quick start: Email info@trashmob.eco to request contributor access, then:

az login
.\setupdev.ps1 -environment dev -region westus2 -subscription <guid>

Mobile App Development

See TrashMobMobile/readme.md for mobile setup, test builds, and store links.


Deployment

Automatic Deployments

Branch Environment Trigger
main Development Push
release Production Manual workflow

Manual Deployment

See Deploy/CONTAINER_DEPLOYMENT_GUIDE.md for container deployment instructions.


Background & History

Years ago, Scott Hanselman (and others at Microsoft) built NerdDinner.com as a demo of ASP.NET MVC. Those nerd dinners were fantastic and had a huge role in many careers, including leading the founder to join Microsoft.

This site is based on both that code and the idea that getting people together to do small good things results in larger good things in the long term.

The inspiration came from Edgar McGregor, who spent over 1100 days cleaning up a park in his community, two pails of litter at a time. His actions inspired others to do the same, and TrashMob.eco was born—a platform to help people organize "mobs" to tackle cleanup together.


Status

TrashMob.eco is a 501(c)(3) non-profit in the United States, launched in production on May 15, 2022. We're actively developing new features to help communities clean up the world!


Contact

About

Source Code for TrashMob.eco

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors