sPARK

Park Smart - Made by students for students.

Smart parking predictions for San Jose State University

If you find this project helpful, please consider giving it a ⭐ on GitHub!

---

Table of Contents

• 📖 About
• ✨ Features
• 🧩 Roadmap
• 🛠️ Technologies Used
• 📚 Getting Started
• ⚙️ Running the Application
• 🔧 Environment Variables
• 🤝 Contributing
• 📜 License

---

📖 About

Coming soon: App demo showcase when UI is done.

sPARK is a web platform that forecasts parking availability for San Jose State University, using both live and historical data.
sPARK’s goal is to help students make more informed parking decisions by knowing which garages will have space before they arrive.

Made by students for students.

---

✨ Features

• Real-time & Forecast Parking:
  View current and predicted garage availability, powered by live and historical data.

• Plan Your Trip:
  Enter your location, class building, and intended arrival time. sPARK calculates the best garage, when to leave, and walking distances.

• Data-driven Predictions:
  Thousands of real-time data points are analyzed to forecast availability, reduce wasted driving, and save time.

• Modern UI:
  Clean interface with seamless Google Maps integration.

---

🧩 Roadmap

• 🚧 In Progress

  • UI Design & Implementation
  • “Plan Your Trip” feature (recommendations for best garage, leave time, and walking distance)

• 🚀 Planned

  • AI Schedule Parser / Planner: Upload a screenshot of your class schedule and sPARK will use AI to extract your classes and buildings, calculate recommended leave times for each day, and prefill the trip planner. Includes multiple schedules, editable plans, and automatic trip planning.
  • Notifications: Receive leave-time reminders and alerts if your preferred garages are nearing capacity or trip conditions change.

---

🛠️ Technologies Used

• Frontend: Next.js, Google Maps API
• Backend: Node.js, Supabase
• Styling: CSS
• Deployment: Vercel

---

📚 Getting Started

Prerequisites

• Node.js (v18+ recommended)
• npm (v10+ recommended)

Installation

1. Clone the Repository

   git clone https://github.com/ItaiHammer/sPARK.git
   cd sPARK

2. Install Dependencies

   npm install

---

⚙️ Running the Application

Coming soon: Instructions for running the application locally will be added as development progresses.

---

🔧 Environment Variables

Coming soon: Details for environment variable setup will be added as development progresses.

---

🤝 Contributing

Contributions are welcome! Open an issue or submit a pull request with features or bug fixes.

---

📜 License

This project is licensed under the MIT License.

Back to top