Boston Sweeper is a premium, real-time web application designed to help Boston residents and visitors avoid parking tickets by providing instant access to official street cleaning schedules.
Built with a focus on user experience and speed, it features an elegant Apple-inspired UI and integrates directly with official municipal data.
- 🎯 Real-time Street Search: Integrated with the official Boston SAM (Street Address Management) API to provide autocomplete for every single street in the city.
- 📍 Precision Geolocation: One-tap "Locate Me" button that uses browser geolocation and Google Geocoding to automatically detect your current street.
- ❄️ Winter Season Intelligence: Automatically detects if a street is currently in cleaning season (e.g., April-Nov for general neighborhoods vs March-Dec for North/South End).
- 📅 Detailed Calendar: Visual breakdown of cleaning days (Mon-Sun) and specific weeks of the month (1st-5th).
- 🗺️ Interactive Route Maps: Visualizes the specific block segments on an interactive map using Google Maps API.
- 📱 Apple Design Pattern: A clean, modern interface following iOS/macOS Human Interface Guidelines, featuring glassmorphism and intuitive segmented controls.
- 🕒 12h Format Support: All cleaning hours are automatically formatted to 12-hour (AM/PM) for easier reading.
- Framework: Next.js 15+ (App Router)
- Language: TypeScript
- Styling: Tailwind CSS (with Glassmorphism)
- Maps/Geocoding: @vis.gl/react-google-maps
- Data Processing: PapaParse
- Icons: Lucide React
- API: Analyze Boston Open Data
- Node.js (Latest LTS recommended)
- A Google Maps API Key (with Maps JavaScript API and Geocoding API enabled)
-
Clone the repository:
git clone https://github.com/robertfrontend/boston-street-cleaning.git cd boston-street-cleaning -
Install dependencies:
npm install
-
Configure Environment Variables: Create a
.env.localfile in the root directory:NEXT_PUBLIC_GOOGLE_MAPS_API_KEY=your_google_maps_api_key_here
-
Run the development server:
npm run dev
-
Open http://localhost:3000 in your browser.
This application uses official data provided by the City of Boston:
- Street Sweeping Schedules: Municipal dataset for cleaning times and rules.
- SAM Street Segments: Master database for all official street names and segments.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature) - Commit your Changes (
git commit -m 'Add some AmazingFeature') - Push to the Branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Robert Frontend
- GitHub: @robertfrontend
Distributed under the MIT License. See LICENSE for more information.
Disclaimer: This app is a tool to help you find schedules. Always check the posted street signs, as they are the final legal authority for parking enforcement in Boston.