explaingit

riley-d-betts/betts-board

Analysis updated 2026-05-18

11TypeScriptAudience · generalComplexity · 3/5LicenseSetup · moderate

TLDR

A self-hosted family organizer app for kitchen tablets, TVs, and phones that includes a shared calendar, chore tracker with kid rewards, meal planner, pantry scanner, and weather, no monthly fees.

Mindmap

mindmap
  root((repo))
    What it does
      Family calendar
      Chore tracker
      Meal planner
      Pantry scanner
    Tech stack
      TypeScript
      Docker
      REST API
    Use cases
      Kitchen tablet display
      Kid chore rewards
      Meal planning
    Audience
      Families
      Self-hosters
    Setup
      Docker command
      Setup wizard
      HTTPS for notifications

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Display a shared family calendar and chore board on a kitchen tablet or TV.

USE CASE 2

Track kids' chores with points and a rewards store where they spend earned stars.

USE CASE 3

Save recipes from links and plan weekly meals with auto-generated shopping lists.

USE CASE 4

Track pantry inventory using your phone's barcode scanner.

What is it built with?

TypeScriptDockerREST API

How does it compare?

riley-d-betts/betts-board1476989162/vue-bill-print1e3pm/knowledge-chatbot
Stars111111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Docker and HTTPS via a reverse proxy or Tailscale for push notifications and barcode scanning to work.

Use and modify freely, but if you run a modified version as a service for others you must share your changes.

In plain English

Betts Board is a family organizer you run on your own computer or server instead of paying a monthly fee to a big tech company. It is designed to be displayed on a kitchen tablet, a TV, and every family member's phone. You install it using Docker, which is a way to package software so it runs the same on any machine, and all your data stays in a single folder on your own hardware. The app covers a lot of ground. There is a color-coded family calendar with recurring events, a chore tracker with points and a leaderboard for kids, and a rewards store where kids can spend earned stars on parent-defined treats. You can paste a recipe link and the app saves it locally, then plan your meals for the week from those saved recipes. The meal planner can put a cooking block on someone's calendar sized to how long the recipe takes. It also generates shopping lists, tracks what is already in your pantry using your phone's barcode scanner, and shows weather and family photos. Setup involves cloning the project, running a single Docker command, and walking through a setup wizard where you name your household, set one shared password, pick your town for weather, and create a profile for each family member. Push notifications and the barcode scanner require a secure HTTPS connection, which you can set up with a reverse proxy or a tool like Tailscale. The developer notes the codebase is organized so each feature has its own self-contained folder, making it easier to add new features without disrupting existing ones. The project exposes a token-authenticated REST API, meaning other software like home automation systems can interact with your family board directly. It is licensed under AGPL-3.0, which means you can use and modify it freely, but if you run a modified version as a service for others you must share your changes. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I want to set up Betts Board on my home server using Docker. Walk me through cloning the repo, running the Docker command, and completing the setup wizard for my family.
Prompt 2
Help me configure Tailscale or a reverse proxy so Betts Board has HTTPS for push notifications and barcode scanning on my phone.
Prompt 3
I have Betts Board running and want to connect my home automation system to it. Show me how to authenticate and call its REST API to read the family calendar.
Prompt 4
I want to add a new feature to Betts Board. Explain how its self-contained folder structure works so I can add a feature without breaking existing ones.

Frequently asked questions

What is betts-board?

A self-hosted family organizer app for kitchen tablets, TVs, and phones that includes a shared calendar, chore tracker with kid rewards, meal planner, pantry scanner, and weather, no monthly fees.

What language is betts-board written in?

Mainly TypeScript. The stack also includes TypeScript, Docker, REST API.

What license does betts-board use?

Use and modify freely, but if you run a modified version as a service for others you must share your changes.

How hard is betts-board to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is betts-board for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.