Skip to content

README.md

Latest commit

 

History

History
107 lines (75 loc) · 2.29 KB

README.md

File metadata and controls

107 lines (75 loc) · 2.29 KB

#🚗 Vehicle Parking App - V1

A full-stack Flask web application for managing vehicle parking in lots. This app allows Admins to create and manage parking lots and spots, and Users to book, release, and view parking spot history — all through a clean, dark-mode interface.

🛠 Tech Stack

  • Backend: Flask, Flask_SQLAlchemy, Flask_Login
  • Frontend: HTML, CSS, Bootstrap (dark mode only), Jinja2 templating
  • Database: SQLite
  • Other: Python, Jinja2, Bootstrap 5

✨ Features

🔑 User

  • Register & Login
  • View available parking lots
  • Book available parking spots
  • Release booked spots
  • View booking history
  • View payment history (if implemented)

🛠 Admin

  • Create, Edit, Delete parking lots
  • Add and manage parking spots
  • View user details and current bookings
  • Monitor spot status
  • View summary statistics and charts

📁 Project Structure


VehicleParkingApp
├── app.py # Entry point for Flask app
├── config.py             # Configuration settings
├── extensions.py         # DB and Login manager setup
│
├── models/               # SQLAlchemy models
│
├── static/               # CSS, JS, images (dark mode styling)
│
├── templates/            # Jinja2 HTML templates
│   ├── base.html
│   ├── home.html
│   ├── login.html
│   └── ...
│
├── instance/             # Database file and instance configs
│
└── **pycache**/          # Python cache (ignored)

⚙️ How to Run Locally

  1. Clone the repository
git clone https://github.com/your-username/your-repo-name.git
cd your-repo-name
  1. Create virtual environment
python -m venv venv
venv\Scripts\activate    # On Windows
  1. Install dependencies
pip install -r requirements.txt
  1. Run the app
python app.py

App will be available at http://127.0.0.1:5000/

🛡 Dark Mode

The application is fully dark-mode only. All templates and components are styled accordingly using external CSS from /static/css/style.css.

🧾 License

This project is part of a coursework project and is free to use for educational purposes.

🙋‍♀️ Author

Developed by Nishi as part of the MAD1 Project for IITM BS.