Common Ground

A warm, private roommate hub built with Next.js, React, TypeScript, and Supabase. Designed for Vercel. The home screen is a kitchen noticeboard with warm paper, soft sage, terracotta, and a taped fridge note.

Account and data upgrade (migrations 031–037)

Apply migrations 031–037 before deploying this release. Set SUPABASE_SERVICE_ROLE_KEY and a new HOUSEHOLD_OWNER_SETUP_SECRET of at least 8 characters in the server environment; a longer random secret is recommended. The production build gate waits for migration 037 and these settings. The owner enters the household code, chooses their name, then enters the setup secret and a personal password on first sign-in. In Our household, the owner creates a one-time invitation for each other person. Share the household code and invitation privately. Existing accounts sign in with their own password; choosing another name requires that person's password. The shared-screen option remains read-only. Treat the owner setup secret as an enrollment credential and rotate it after owner enrollment if it was exposed.

Maintenance requests now have due dates, a dated follow-up trail, and morning reminders for due or overdue assigned requests. To-dos and shopping order synchronize across devices. Reservations use the configured household time zone, appear on the in-app and subscribed calendars, and can carry a 30-minute calendar reminder. Shopping purchases can record a partial quantity and actual total price while leaving the remainder open; the ledger posts the purchased portion once. The Budget panel shows six months of grocery and utility totals and remaining target amounts. Expenses can create weekly or monthly rules from an existing charge; each new cycle creates a draft that must be posted or skipped, with possible duplicates flagged. The owner can download a JSON household backup and restore missing records to the same household. The backup includes shared plans, chores, shopping, handbook text, planning records, and the owner's private entries; it excludes other members' private entries and file blobs. Back up handbook files, maintenance photos, and receipts separately from private storage.

Home and display mode

The overview opens with the date and one sentence about what the house needs today: chores that have come due, the nearest unpaid bill within the week — nearest by distance from today, so an old bill nobody ticked off never hides the rent that is actually coming up, and a tie goes to the overdue one — and what is on the shopping list ("One thing to do, rent in 5 days, and olive oil to grab."). Each card is a different piece of paper: a calendar leaf for plans, an index card for chores, receipt paper for shopping, and the taped fridge note; the To-dos, Shopping, and Expenses pages carry the same papers. The homepage and calendar fit the available viewport without page scrolling. Home cards adapt their item count to the space; a "See all" link on each card opens the full tab when more items exist. A repeating chore or plan takes one row on the overview — its next turn, plus anything overdue — while the full tab still lists every occurrence. Complete chores or mark purchases directly, or use the To-do / Item / Plan shortcuts. Calendar rows resize to fit even six-week months; crowded days open a detail dialog. On phones, navigation stays at the bottom and the calendar becomes a paginated monthly agenda.

Choose Display mode in the top bar for a monitor/TV, or bookmark /?display=1. It fills the browser viewport with four cards, a clock, and no scrolling. Each card fits as many rows as its own space allows, measured per row, so a tall entry in one card no longer decides how many the others show and a bigger screen genuinely shows more. Extra items and notes rotate every 20 seconds; the bottom controls let you pause, change pages, enter full screen, or exit. Long titles and notes are shown as concise previews; open the normal app for full details.

Display mode uses the same signed-in household session and refreshes shared records every 15 seconds. It does not create a public sharing link or grant extra access. The URL keeps the display preference across reloads. Set the TV/computer's sleep settings separately if you want an always-on display.

Controls use Radix UI primitives and Motion, styled to match the house: sliding filter highlights, tactile buttons, drawn checkmarks, and gentle entrances. A living windowsill illustration appears across the app: tap the cat to make it stretch, or complete a to-do to get a small reaction. The cat breathes and flicks its tail, the plant sways, and clouds drift past. On phones the cat sits in the top bar; on a TV the scene sits beside the clock. The TV button has a soft idle shimmer, and display mode has slowly drifting background color. Use Motion on/off in display mode or household settings to pause ambient effects; the choice stays on this device. Idle effects stop in hidden tabs, and system reduced-motion preferences are respected.

Tactile motion

Lists and undo notices animate out while writes continue in the background. Surviving rows move into place; dialog closes preserve focus and keyboard dismissal. Notes and expense editors share a transition with their source card or row. Reduced motion removes these transitions.

This is the beginning of the README. Read the rest at the original. Read the full README ↗