Personal projectFull-stack product2026Live

Whisperly

A real-time one-to-one messenger with presence, unread tracking, photos and a polished dark and light interface.

messages through Firestore listeners
Livemessages through Firestore listeners
themes that follow your system
2themes that follow your system
click to explore a seeded demo account
1click to explore a seeded demo account
01Overview

Sign up, set up a profile, find people by username and chat instantly, with photos, “active now” presence, unread tracking and a shared-media panel.

OriginWhisperly 2.0 is a redesign and fix-up of a course chat app.

02Why I built it

Chat apps are judged on small details: the dot that says someone is online, the badge that says you missed something, the way messages group. I used this project to get those details right.

Questions I had to answer
  • Q1

    How do I keep usernames unique without a server?

  • Q2

    How do I keep conversations private with only Firestore rules?

  • Q3

    What makes a chat feel alive?

03Before → after
  • DesignBeforeCourse templateAfterGlass panels on an aurora background, Geist, design tokens, dark and light themes
  • Chat listBeforePlain listAfterLive username search, All/Unread filters, relative times, presence dots
  • ConversationsBeforeOne bubble per messageAfterGrouped bubbles, day separators, image lightbox, auto-growing composer, upload progress
  • FixesBeforePresence stopped updating after login; new accounts erroredAfterPresence keeps updating, timers cleaned up, first load works
04Key decisions
  1. A usernames collection

    A username → uid lookup lets sign-up check that a name is free before creating the account.

  2. Security rules as the backend

    Production Firestore rules keep each conversation private to its two participants.

  3. Configurable image uploads

    Cloudinary, Firebase Storage or inline, chosen by environment.

05Screens
Conversation in dark mode with the details panel
Conversation in light mode
Profile page with live preview
Sign-in page
Whisperly on a phone
06Features
Messaging
  • Real-time messages with Firestore onSnapshot
  • Photo messages with upload progress
  • Unread badge, highlight and filter
  • Presence from last-seen time
Profile
  • Unique usernames
  • Profile page with live preview and drag-and-drop photo
  • Details panel with shared media
07Under the hood
01
Private by rules

Firestore rules restrict messages to their two participants.

02
Seeded demo

npm run seed creates a demo account with realistic conversations.

08Tech stack
ReactViteFirebase AuthCloud FirestoreCloudinary
09Looking back
The hard part

Presence: “Active now” must keep updating after login and background timers must be cleaned up, or the app slowly lies.

What I learned

With a serverless backend, the security rules are the API. They deserve the same care as server code.