🚌 SwiftCommute

Streamline your bus management operations with SwiftCommute

📋 Overview

SwiftCommute is a comprehensive bus management system designed to optimize route planning, bus assignments, and passenger bookings. With an intuitive dashboard and powerful features, SwiftCommute empowers transport companies to enhance their operations and improve customer satisfaction.

✨ Features

Feature	Description
🗺️ Route Management	Create, edit, and delete bus routes
🚍 Bus Assignment	Assign and reassign buses to routes with conflict checks
👥 Staff Management	Track driver availability and assignments
🎟️ Booking System	Allow users to book seats on scheduled routes
📊 Real-time Dashboard	Monitor key performance indicators
📈 Analytics	Calculate profitability index for route performance

🛠️ Tech Stack

Category	Technologies
Frontend	React, Next.js, TypeScript
Backend	Next.js API Routes
Database	PostgreSQL
Styling	Tailwind CSS, shadcn/ui
Charts	Recharts

🚀 Getting Started

Prerequisites

• Node.js (v14.0+)
• npm or yarn
• PostgreSQL (v14.0+)

Installation

1. Clone the repository

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

2. Install dependencies

   npm install
   # or
   yarn install
   # or
   pnpm install

3. Set up environment variables: Create a .env.local file in the root directory and add the following: Go to Neon Serverless Postgres, create your project, copy your connection string(pooled) and paste it in your .env

   DATABASE_URL=postgresql://neondb_owner:[email protected]/neondb?sslmode=require
   

4. Set up the database: Make sure to see the SQL files uploaded and create the database, tables, functions, and triggers accordingly before running your application

5. Start the development server

   npm run dev
   # or
   yarn dev

6. Open http://localhost:3000 in your browser.

🔮 Future Improvements

• PDF report generation for dashboard data
• Email notification system for booking reminders and updates
• Mobile application for on-the-go management
• Integration with real-time GPS tracking for buses
• Advanced analytics and machine learning for route optimization

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📝 License

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

🙏 Acknowledgements

• v0 by Vercel

Made with ❤️ by SwiftCommute Team