Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Roomble

Roomble is a centralized household management web app built for university students in shared living. It brings chore tracking, expense splitting, grocery management, and household communication into one place — replacing the chaos of group chats and verbal agreements with a single, transparent system.

Features

Milestone 1

  • User registration and login
  • Protected dashboard with household status
  • Household creation with unique invite code generation
  • Join a household via invite code

Milestone 2

  • Chore Tracker — rotating or assignable schedules with real-time completion status
  • Expense Splitter — log shared purchases and auto-calculate who owes whom

Milestone 3

  • Shared Grocery List - real-time collaborative checklist for any household groceries or shared items that every roommate can view and edit simultaneously
  • Household Noticeboard - a simple, persistent digital feed where roommates can post notes, reminders, and announcements for the whole household to see
  • Unified dashboard view - a more advanced and simpler dashboard to facilitate the needs of busy university students

Tech Stack

Layer Technology
Frontend React + Vite, HTML, CSS, JavaScript
Backend & Database Supabase (Auth, PostgreSQL, Row Level Security)
Deployment Vercel
Version Control Git & GitHub

Getting Started

  1. Clone the repository
    git clone https://github.com/msrmayank/Roomble.git
  2. Navigate to the frontend folder.
    cd frontend
  3. Install the required dependencies.
    npm install 
  4. Start dev server
    npm run dev

NUS Orbital 2026

This project is built as part of NUS Orbital (CP2106).

About

Roomble — a centralized web app for shared living. Manage household chores, split expenses, and coordinate with roommates in one place.

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages