Shelfmate

An invite-only book club for people who actually read.

Side project — 2025 — Next.js · Supabase

Shelfmate

Live site GitHub

An invite-only book club for people who actually read.

Borges
Calvino
Sebald
Woolf
Pessoa
Camus
Proust
Achebe
Kafka
Pamuk

About

Most book-tracking apps feel like inventory systems. Shelfmate is something smaller and more deliberate — a shared shelf for a circle of people who read, built to feel like the conversation that happens after the last page.

The invite-only model is a constraint by design. The list stays short, the shelves stay personal, and nobody is performing for an audience.

myshelfmate.vercel.app
Your shelf
The Rings of Saturn
read
If on a winter's night
reading
The Waves
read
The Book of Disquiet
want to read
The Stranger
read
Reading stats
24
books read
1
reading now
8
on the list
Friends reading now
A
aisha Pachinko — Lee
D
randy Stoner — Williams
M
marco Austerlitz — Sebald

Features

🔒
Invite-only
New members join via shareable codes. No open registration, no strangers.
📚
Personal shelf
Three reading states per book: want to read, reading, read. Backed by the Google Books API.
👥
Friend system
Mutual and quiet. See what friends are reading. No feeds, no likes, no noise.
📊
Reading stats
A lightweight dashboard tracking books read, in progress, and queued.
◐
Dark mode
Proper dark mode via next-themes. Most reading happens at night.
☁
One-click deploy
Deployable to Vercel in minutes. Run your own instance for your own circle.

Stack

Built on Next.js 15 with the App Router and TypeScript throughout. Data lives in Supabase — PostgreSQL with row-level security so each user can only touch their own records. Styled with Tailwind CSS v4.

Next.js 15 TypeScript Supabase Tailwind v4 App Router PostgreSQL + RLS next-themes Google Books API Vercel

Shelfmate is invite-only and actively used by a small group of readers. The code is open if you want to run your own circle.

→ myshelfmate.vercel.app