Skip to content
FannyDevzPublic

About

Slow Mail: a web app for letters that travel at their own pace. Pick one of 10 animal couriers or regular post, and each letter makes its journey across a map from your saved address to the recipient's @username. Built with Next.js, Supabase, and Leaflet.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Slow Mail

Slow Mail

Web surat yang diantar kurir. Pilih salah satu dari 10 hewan (elang, merpati, angsa, burung hantu, lumba-lumba, kuda, unta, kucing, kura-kura, siput) atau pos biasa. Waktu tiba = jarak ÷ kecepatan hewan. Posisi kurir bisa dilacak di peta, dan isi surat baru bisa dibuka setelah kurir mendarat.

Cara kerja

Tulis, kirim, lacak, buka

  • Tiap pengguna punya @username dan alamat (titik di peta, bisa dideteksi dari lokasi). Surat dikirim ke @username.
  • Tidak ada posisi yang disimpan terus-menerus: progress = (sekarang - sentAt) / durMs, lalu diinterpolasi di garis lurus asal → tujuan.
  • Kejadian acak di perjalanan ditentukan sekali saat kirim, di server.
  • Isi surat hanya keluar lewat fungsi database open_message(id) setelah arrive_at.
  • Fitur lain: balasan, belum dibaca, blokir/laporkan, notifikasi saat mendarat, halaman publik /u/[username], panel super admin /voyager.

Stack

Next.js 15 (App Router) · React 19 · JavaScript · Leaflet + OpenStreetMap · Supabase (Postgres, Auth, Realtime, RLS) · CSS biasa bergaya neo-brutalisme · Deploy di Vercel.

Mulai cepat

Butuh Node.js 22+ dan proyek Supabase.

git clone git@github.com:FannyDevz/slowmail.git
cd slowmail
npm install
cp .env.example .env.local   # isi URL dan key Supabase
npm run dev                  # http://localhost:3000

Panduan lengkap (Supabase, migrasi, Vercel): setup.md.

Perintah

Perintah Fungsi
npm run dev Jalankan dev server
npm test Tes logika perjalanan, kamus, dan RLS (PGlite, tanpa Supabase)
npm run build Build produksi
npm run admin -- list Kelola super admin (grant/revoke <email>)

Di form kirim, kecepatan simulasi 3.600x membuat perjalanan selesai dalam hitungan detik (hanya saat dev, atau ALLOW_SIMULATION=true).

Struktur

app/          halaman, server action, style global
components/   Mailroom, form kirim, peta Leaflet, pengaturan
lib/          rumus perjalanan, geocode, i18n, sesi, klien Supabase
supabase/     migrasi skema, RLS, open_message
tests/        node:test + PGlite

Detail arsitektur dan aturan kode ada di CLAUDE.md.

About

Slow Mail: a web app for letters that travel at their own pace. Pick one of 10 animal couriers or regular post, and each letter makes its journey across a map from your saved address to the recipient's @username. Built with Next.js, Supabase, and Leaflet.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages