Yours Sincerely

🚀 Website | App Store | Play Store

Anonymous love letters 💌 written in disappearing ink.

Get Started

The application is built on a modified version of the T3 Turbo stack (to include Supabase).

The native apps are built with Expo and live in apps/expo.

.vscode
  └─ Recommended extensions and settings for VSCode users

apps
  ├─ web
  |  └─ Web client and server (Next.js)
  ├─ expo
  |  └─ iOS & Android apps (Expo / React Native) — the ones that ship
  └─ mobile
     └─ Legacy Capacitor shell — superseded by apps/expo, pending removal

packages
  ├─ api
  |  └─ tRPC router definitions and session/auth
  ├─ contracts
  |  └─ Shared domain: zod schemas and pure rules used by both web and expo
  ├─ db
  |  └─ Drizzle schema and Postgres client
  └─ ui
     └─ UI package for the webapp using shadcn-ui

Install dependencies

• Node.js - LTS version recommended (>= 24)
• Docker - Used for running the database

Local Development

# Copy .env.example to .env and update variables
cp .env.example .env

# Set COOKIE_SECRET in .env — sessions are signed with it. The server throws
# without it in production, and falls back to an insecure dev constant locally.

# Installing dependencies
pnpm install

# To start the database
pnpm db:start

# To create the schema — `supabase start` brings up an EMPTY database and there
# are no migrations to replay, so this step is not optional
pnpm db:push

# To start the web app
pnpm dev:web

# To start the native app (Expo)
pnpm dev:expo

You'll be able to view the website at http://localhost:3000

Checks

pnpm verify      # typecheck + lint + format + test — exactly what CI runs

# …or individually
pnpm typecheck
pnpm lint        # oxlint
pnpm format      # oxfmt --check
pnpm test        # node:test

Coding agents should start from AGENTS.md.

Stack

This project uses the following libraries and services:

• Framework - Next.js
• Native - Expo / React Native
• API - tRPC
• Styling - Tailwind
• Database - Postgres (Supabase) + Drizzle
• Hosting - Vercel
• Notifications - Knock