Ride — Campus Ride Coordination

A simple, private ride-pooling platform for trusted campuses — web-first PWA backed by a centralized API.

Quick visuals: see the Diagrams section below for links and thumbnails.

Diagrams

• 
• 
• 

What

Backend-driven ride coordination for campuses (Users, Rides, Bookings, Payments, Ratings). Web-first PWA for fast iteration.

Quickstart

• Prereqs: Node.js (LTS), npm

Install and run:

npm install
npm run dev

Tech & Principles

• Next.js PWA frontend; centralized REST API + relational DB as the single source of truth; realtime updates via WebSocket/SSE; college-only access via SSO/allowlist.

Project Issues & Roadmap

This project uses GitHub Issues for tracking development. A complete issue set with dependencies is available in .github/issues.json.

Create All Issues at Once

To create all 30 issues with dependencies in your repo:

1. Go to Actions → Create Project Issues workflow
2. Click Run workflow → Run workflow (or use dry-run mode to preview)
3. Issues are created with:
   • Categories (Foundation, Authentication, RideManagement, Booking, Payment, Notification, Frontend, Quality, DevOps)
   • Priority labels (High, Medium, Low)
   • Acceptance criteria for each issue
   • Dependency references for build order

Note: The workflow checks for duplicates before creating, so it's safe to run multiple times.

Next steps

• Want me to export these Miro frames as images into public/digrams/ and add thumbnails here?

---

Built by the Openverse-IIITK community. This is a Next.js project bootstrapped with create-next-app.

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Geist, a new font family for Vercel.

Learn More

To learn more about Next.js, take a look at the following resources:

• Next.js Documentation - learn about Next.js features and API.
• Learn Next.js - an interactive Next.js tutorial.

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.