DCParkWise

A web application to help drivers in Washington, D.C. find free parking zones based on time of day and street rules.

this is the sample line segment of the parking this green indiactes its free parking

Features

• 🗺 Interactive Google Maps interface centered on Washington, D.C.
• 📊 Parking zone overlays with real-time availability
• 🕒 Smart rule engine for parking restrictions
• 🪧 Detailed parking information popups
• 📱 Responsive design for mobile and desktop

Setup

1. Clone the repository:

git clone https://github.com/yourusername/dcparkwise.git
cd dcparkwise

2. Install dependencies:

npm install

3. Create a .env file in the root directory and add your Google Maps API key:

REACT_APP_GOOGLE_MAPS_API_KEY=your_google_maps_api_key_here

4. Start the development server:

npm start

Environment Variables

• REACT_APP_GOOGLE_MAPS_API_KEY: Your Google Maps JavaScript API key

Technology Stack

• React.js with TypeScript
• Google Maps JavaScript API
• Material-UI for components
• Firebase (coming soon)

Project Structure

src/
  ├── components/     # Reusable components
  │   ├── map/       # Map-related components
  │   └── popup/     # Information popup components
  ├── pages/         # Page components
  ├── utils/         # Utility functions
  └── data/         # Static data and types

Contributing

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

License

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