🤠 The Homestead

Inspiration

My little brother hates brushing his teeth. He throws clothes everywhere. He takes ages to get ready for school. He's a picky eater who skips lunch. Even as he approaches his pre-teen years, building basic habits feels like a never-ending battle.

I wanted to build something that would actually make him want to do these things — not because he was nagged, but because there was something real at stake.

Want your PlayStation time? Better earn it like a cowboy.

YEE HAW. 🤠

That's The Homestead.

🪶 What It Does

The Homestead is a gamified habit system for families. Parents become Sheriffs, kids become Cowboys, and the home becomes the Wild West.

How it works

Sheriff posts a Bounty — "Brush your teeth by 7:30 AM" or "Make your bed every morning"
Cowboy completes it and submits for review
Sheriff approves via the Ledger — gold and XP are awarded
Cowboy spends gold in the General Store on real rewards the Sheriff set up — extra screen time, choosing dinner, staying up late
Sheriff marks it delivered — or denies it if the deal wasn't held up

Every family gets their own private Homestead with a unique 6-character join code. No two families share data.

🔥 Streak Mechanics (Grit System)

Your rewards dynamically adjust based on consistency:

$$ \text{Gold Earned} = \text{Base Reward} \times \begin{cases} 2 & \text{if 7-day streak (Gold Rush)} \ 0.5 & \text{if streak broken (Cracked Grit)} \ 1 & \text{otherwise} \end{cases} $$

Miss a day → Cracked Grit penalty (0.5× rewards)
Recover with a 3-day rebuild streak
Hit 7 days → Gold Rush bonus (2× rewards)

📅 Smart Scheduling System

Bounties can be:

Daily (specific time with AM/PM picker)
Weekly (selected days)
Monthly (specific date)
Open Range (no deadline)

Overdue tasks are flagged in real-time. You can't fake a streak.

🛠️ How I Built It

I started with a prototype on Replit to get the concept working, then used Claude to help rebuild and expand it into a full Next.js + Django application.

Backend:

Django (Python) — REST API with class-based views
SQLite — simple, zero-config database
Session-based auth with HTTP-only cookies
Every query scoped to the family's homestead

Frontend:

Next.js 14 (App Router) with TypeScript
Tailwind CSS with a custom Wild West design system
Rye + Special Elite fonts for the authentic theme
Role-based routing — /sheriff/* and /cowboy/*

⚠️ Challenges I Faced

Streak Logic — The bonus and penalty system had a lot of moving parts. Making sure everything was calculated correctly on the server and couldn't be cheated took a lot of careful testing.

Running it Locally — As a first timer, setting up Django and Next.js together on localhost took a lot of troubleshooting. Getting the frontend to talk to the backend correctly, dealing with CORS, and figuring out why changes weren't loading was a challenge in itself.

📚 What I Learned

Creating a back end and front end server on my own computer and running an website on it with Django and Next.Js
File organization for for backend and frontend
Using Ai to solve personal problems.