A roommate searching app that ranks possible roommates by how closely they match the questions you answer.

Herder is very much in beta, things will break! When they do, please please please let me know. Contact details can be found on the website.

If you are an incoming or current WPI student, check the Announcement channel on the WPI Class of 2025 Discord server.

1. Login with Discord
2. Go to Profile, and select Edit Profile. Then fill in as many questions as possible and press save changes.
3. Go to Search, select what kind of roommate you are looking for and click Search.
4. That's it! 📈 Now you can see the percentage of how closely you match with other people. You can find a person's discord username and digits on their profile card so you can reach out.

Environment Variables

All API requests require a x-access-token header, with the exception of the oauth2 redirect.

GET /oauth/redirect

Redirects to auth page after converting oauth2 code to access token.

Query Parameters

GET /match

Returns JSON array of matching users with their percent match.

Query Parameters

GET /questions

Returns JSON object of all profile questions.

GET /user/profile

Returns requesting user's full profile.

POST /user/update-profile

Body should contain all profile questions answered by the user.

Returns updated profile.

GET /halls

Returns JSON array of all residence halls.

GET /halls/{hall_id}/rooms

Returns JSON array of all rooms in a specified residence hall.

Parameters

GET /roommates/neighbors

Returns JSON array of all users in the same residence hall.

Made with ❤️ by Daniel Stoiber
Thank you everyone on the WPI Class of 2025 server!