Run-and-Route Hub
Project Overview
Run-and-Route Hub is a web application built to help University of Hawaiʻi at Mānoa students find running partners, log their runs, and stay motivated with small awards and milestones. Students can add details about their runs, search for runs created by others, and see simple awards based on their activity.
The application was built using Next.js, React, Prisma, and PostgreSQL, with deployment handled through Vercel. Our goal was to take the software engineering ideas from ICS 314 and use them in a real, team-based project that felt like a “real” app instead of just a homework assignment.
My Contributions
I worked on several key parts of the project, mostly focused on the user-facing pages and deployment:
- Created the About page template to introduce the app, show our goals, and explain how students can use Run-and-Route Hub.
- Designed the Add Run page layout so users can easily enter information like distance, time, pace, and notes about each run.
- Implemented the Find Run page so students can search for existing runs and browse them in a clean, organized view.
- Styled the Find Run page to match the rest of the site with consistent buttons, spacing, and typography.
- Implemented the Awards feature, which shows simple awards based on user activity and helps make the app more motivating.
- Handled Vercel Pro account and deployment issues so our team could keep the site live and test features online.
- Wrote project documentation and the README, explaining how to install, run, and understand the project for both teammates and future developers.
These tasks helped shape how users interact with the app and also supported the team by keeping deployment and documentation in good shape.
What I Learned
This project helped me understand that building a web application is more than just writing code in isolation. I gained hands-on experience with:
- Working on a shared codebase while using GitHub issues and branches to coordinate work.
- Structuring pages and components in a Next.js app so routing and data flow make sense.
- Connecting frontend pages like Add Run and Find Run to the database through Prisma.
- Debugging layout and styling issues to keep the UI clean and consistent across multiple pages.
- Dealing with real deployment problems on Vercel and learning how to fix them under time pressure.
- Writing documentation that clearly explains how to use and develop the project.
Overall, I learned how important communication, planning, and clear code organization are when working in a team on a real web app.
Source Code
View our GitHub organization repository here:
github.com/run-and-route-hub
This repository contains the full source code, issue history, and project documentation.
Landing Page
Add Run Page
Find Run Page
Awards Page
