A sticky-note wall for your thoughts: drop notes anywhere on a freeform canvas, group them into columns, add reminders, and sync across devices with your Google account.
- Freeform canvas: drag, resize, rotate and layer notes and title cards
- Columns: create, rename and reorder columns, and drag notes in and out
- Reminders: due date with upcoming/today/overdue status
- Colors and star ratings per note
- Local-first: works signed-out with
localStorage. Sign in with Google to sync to Firestore. - Online/offline indicator
- Match: connect with one other person through a 5-digit code and view their wall read-only
- Letters: short sealed messages to your match that expire automatically
- Backup: export and restore your notes as JSON
- Admin tools (custom claim): user list, ban/unban, match reset, broadcast letters
- Note content is sanitized with DOMPurify before rendering and saving
| Layer | Technology |
|---|---|
| UI | React 19 + TypeScript |
| Build | Vite 6 |
| Auth / database | Firebase Authentication (Google), Cloud Firestore |
| Animation | Framer Motion |
| Styling | Tailwind CSS 4 |
| Icons | Lucide |
| Hosting | Vercel (static SPA) |
Requirements: Node.js 20+, Yarn, and a Firebase project with Google sign-in and Firestore enabled.
yarn install
cp .env.example .env # fill in your Firebase web app config
yarn dev.env variables (Firebase web config; these are exposed to the client by design):
VITE_FIREBASE_API_KEY=
VITE_FIREBASE_AUTH_DOMAIN=
VITE_FIREBASE_PROJECT_ID=
VITE_FIREBASE_STORAGE_BUCKET=
VITE_FIREBASE_MESSAGING_SENDER_ID=
VITE_FIREBASE_APP_ID=
VITE_FIREBASE_MEASUREMENT_ID=
# optional
VITE_APP_BASE=/Production builds fail if the required VITE_FIREBASE_* values are missing.
| Script | What it does |
|---|---|
yarn dev |
Start the Vite dev server |
yarn build / yarn preview |
Production build / preview it locally |
yarn typecheck |
TypeScript check without emitting |
yarn check:unused |
Report unused locals and parameters |
yarn test:rules |
Run the Firestore security rules tests in the emulator (needs Java 11+) |
yarn security:secrets |
Scan tracked files for leaked secrets |
yarn security:audit |
Dependency vulnerability audit |
yarn check:prepublish |
All of the above in sequence |
yarn admin:claim <UID> <true|false> --confirm |
Grant or revoke the admin claim (needs a service account via GOOGLE_APPLICATION_CREDENTIALS) |
firestore.rules keeps profiles private to their owner (and the other side of a match), gives a matched partner read-only access to notes and columns, validates every payload, and reserves moderation fields for admins (custom claim). Match codes resolve through a separate matchCodes lookup, so no one can list users. Deploy them with:
firebase deploy --only firestore:rules- Import the repo into Vercel and set the
VITE_FIREBASE_*variables. - Add your production domain to Firebase Auth → Authorized domains.
- Deploy.
vercel.jsonrewrites all routes toindex.html.
| Path | Content |
|---|---|
users/{uid} |
Profile, avatar, match state, preferences, moderation flags |
users/{uid}/notes/{noteId} |
Notes and title cards |
users/{uid}/columns/{columnId} |
Columns |
users/{uid}/letters/{letterId} |
Expiring letters |
matchCodes/{code} |
Match code → user ID lookup |
Signed-in data lives in Firestore under your user ID. Other users can't see your profile or email; your matched partner can read your notes and columns. Accounts with the admin claim can view any user's wall for moderation purposes, as enforced by firestore.rules.
App.tsx App shell: canvas, columns, sync orchestration
components/ Note, NoteEditor, columns, letters, admin panel, modals
contexts/ Language provider
hooks/ useOnlineStatus
services/firebase.ts Auth, Firestore reads/writes, match and letters
utils/ Sanitization, reminders, colors, avatars, audio
scripts/ Admin-claim and tracked-secret scan scripts
tests/ Firestore security rules tests
public/ Favicon, logo and notification sounds
firestore.rules Firestore security rules
