https://github.com/dheerajcl/swift_commute
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.
https://github.com/dheerajcl/swift_commute
nextjs nextjs14 postgresql react recharts shadcn-ui tailwindcss typescript vercel
Last synced: about 1 month ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/dheerajcl/swift_commute
- Owner: dheerajcl
- License: mit
- Created: 2024-09-11T18:37:53.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-11-29T15:43:13.000Z (6 months ago)
- Last Synced: 2025-03-25T09:21:23.355Z (about 2 months ago)
- Topics: nextjs, nextjs14, postgresql, react, recharts, shadcn-ui, tailwindcss, typescript, vercel
- Language: TypeScript
- Homepage: https://swiftcommute.vercel.app
- Size: 3.93 MB
- Stars: 12
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚌 SwiftCommute
### Streamline your bus management operations with SwiftCommute
[](https://nextjs.org/)
[](https://reactjs.org/)
[](https://www.typescriptlang.org/)
[](https://www.postgresql.org/)
[](https://opensource.org/licenses/MIT)
## 📋 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**
```bash
git clone https://github.com/yourusername/swiftcommute.git
cd swiftcommute
```
2. **Install dependencies**
```bash
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](https://neon.tech), 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
6. **Start the development server**
```bash
npm run dev
# or
yarn dev
```
7. Open [http://localhost:3000](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](LICENSE) file for details.
## 🙏 Acknowledgements
- [v0 by Vercel](https://v0.dev/)
Made with ❤️ by SwiftCommute Team