#NotesApp
Where African creators, professionals and businesses publish, take bookings, sell and get paid in Naira. Next.js 14 (App
Router) on Vercel, Firebase (Auth, Firestore), Cloudflare R2 and Stream, Paystack, Resend, Anthropic (Nana).
New here? Read HANDOVER.md first (how the work is done, what's waiting, the map of the code), then this page.
| Doc | What's in it |
|---|
HANDOVER.md | The state of the code, what's waiting on the owner, how the work is done, map of the code, tests, known gaps |
docs/ENVIRONMENT.md | Every setting (environment variable), made from lib/config.ts |
docs/DEPLOY.md | Deploy checklist, where to look when something's wrong, scripts |
docs/ENGINEERING_GUIDE.md | The founder's guide for the engineering team: principles, the Na- names, the stages and their dashboard triggers, recovery from a breach, Nana and the platform at scale |
docs/ARCHITECTURE.md | How the newer pieces work: addresses, bells, digest, server-owned writes, shared limits, settings |
docs/DOMAIN_SWITCH.md | Moving the primary address to notesapp.tech |
docs/STAGING.md | The staging copy and how a release goes |
docs/PAYMENTS.md | Who takes which payment: Paystack (cards, subscriptions, payout backup), Paylony (bank transfers, Tap2Pay), Flutterwave (across Africa, later); the one payment layer to build; NotesApp Inc |
docs/MOBILE-APPS.md | The iOS and Android release plan (Capacitor around the app address, store rules, accounts under NotesApp Inc); scaffold in mobile/ |
docs/SEND-NA.md | Send-Na by NotesApp: email, WhatsApp and SMS priced in Naira (plan only), and the WhatsApp and SMS channel booking reminders need |
docs/COURSES.md | The course platform plan (free YouTube courses, paid courses, certificates) |
docs/BUILD_LOG.md | The full history, in order (what used to be this README) |
lib/changelog.ts | Release notes, shown at /changelog |
Where things stand (updated 22 Oct 2026, v0.80.0)
Live today
| Area | What exists | Where to read more |
|---|
| Publishing | Journals (Markdown composer with toolbar and preview, drafts, premium posts), follow, likes, comments and replies, shares, co-authoring, organisation channels and teams, drag-and-drop or pasted pictures (JPEG and PNG go up as WebP, lib/upload.ts asWebp) | "Who can publish", "Organisation accounts", co-authoring in "Boosts & gifts" |
| Links and @mentions | Web addresses become links wherever members write (lib/linkify.ts, components/LinkedText.tsx, remarkLinkify for journals); link preview cards in Messages and Notes Life chat (/api/link-preview: signed in, public addresses only, every redirect re-checked, 512 KB / 5 s, cached 6 h); the @mention picker (components/MentionPicker.tsx, users by username prefix) in journals, comments, replies, messages, moment captions and Notes Life chat; @username links to /u/username | /help → "Links and @mentions" |
| Video on posts | One MP4/WebM per post (≤ 100 MB, ≤ 3 min, weekly allowance by plan), our own player, cover-image picker, server-verified uploads | "Video on posts" |
| Share previews | Per-post, per-store-item and per-store Open Graph cards | "Share previews (Open Graph)" |
| Shipments (logistics) | Logistics businesses on Business and Enterprise book shipments for their own customers (delivery, waybill, bulk, warehousing, home and office errands; each business picks its services), send receivers their tracking link on WhatsApp or SMS, hand parcels rider to rider with no-login links, and turn on a Track section on Your site (/track on their domain) | lib/shipments.ts, lib/shipments-server.ts, /shipments, /logistics |
| Logistics network | Providers list coverage (states), areas, services and a rate card (zone × weight); stores choose a delivery partner on /logistics/network; buyers pay the partner's price at checkout (a <ref>_ship ledger entry, released with the order); our commission comes only from the provider's earnings; Business/Enterprise included, the add-on (₦4,500/month, 30-day trial) on Free Basic and Pro | lib/logistics.ts, lib/logistics-server.ts, /api/logistics, help → "The logistics network" |
Not built yet
Payments across Africa (docs/PAYMENTS.md: Paylony virtual accounts, the one payment layer, Flutterwave for Ghana and Kenya) · Mobile apps (docs/MOBILE-APPS.md, scaffold in mobile/; waits on NotesApp Inc and its store accounts) · Send-Na (docs/SEND-NA.md: email, WhatsApp and SMS priced in Naira; WhatsApp booking reminders come with its phase 0) · The rest of Courses (docs/COURSES.md: quizzes, Enterprise Courses and the Enterprise Academy API) ·
Paid add-ons for Business and Enterprise, after internal testing: the team hub and team messaging, company finance tools (runway calculator, CAC and MRR, burn and revenue analytics, cap table and vesting), the investor and partner data room, and LinkedIn advertising (Advertising API development tier approved; advertisers boost a post on LinkedIn from their own ad account, with campaign stats) · WhatsApp reminders (plan: Meta WhatsApp Cloud API directly; booking reminders + delivery updates; needs Meta Business
verification and approved templates) · publishing to Facebook, Instagram and TikTok (LinkedIn and X are built) · MCP write tools (drafts from your AI assistant) and the Nana operator
(scoped; the work is on the team hub as the agent-layer backlog; MCP phase 1, read-only, is live) · AI notetaker ·
Paylony virtual accounts and bank payouts (client in lib/paylony.ts; the payout and reserved-account endpoints are not in yet) · domain sales and DNS management (Whogohost / go54) ·
Notes Life: Lagos, the conference hall, real players in the VIP bar · iOS/Android apps · video transcoding/streaming (we cap size and length instead) · Dojah live mode (README "Going live with Dojah") ·
webhook retries (one attempt, manual resend) · OAuth for third-party API apps · checkout and bookings in a popup on custom domains, and a sending address on the member's own domain (sign-in and sign-up in the member's name are live) ·
voice (Listen on journals, Nana reading aloud) · Sentry (we have built-in error monitoring instead).
Run it locally
npm ci
cp .env.local.example .env.local # Firebase web config and a service account at least (docs/ENVIRONMENT.md)
npm run dev # http://localhost:3000
Checks
npx tsc --noEmit # types (there is no ESLint config)
npm run test:rules # Firestore rules (needs Java; starts the emulator)
npm run test:life # Notes Life economy
npm run test:messages # message edits
npm run test:mentions # @mention bells
npm run test:digest # weekly digest
npm run test:authors # journal author backfill
npm run test:shared # shared rate limits and cache
npm run test:topics # topics, hashtags and the topic backfill
npm run test:ops # the stage-trigger numbers' arithmetic
npm run test:ops-server # gathering the stage-trigger numbers (emulator)
npm run test:pii # masked emails and phones in admin pages
npm run test:pii-server # reveal with a reason, the view log (emulators)
npm run test:maintenance # backfills: dry run, plan check, before-images, undo (emulator)
npm run test:backups # Admin → Backups: names, limits and the requests sent to Google
npm run test:discovery # For you, Most viewed and Recent shelves
npm run test:courses # Notes Academy: YouTube ids, slugs, progress
npm run test:courses-server # Notes Academy on the emulator: create, lessons, publish, enrol, progress
npm run test:preview # link-preview safety (listens on port 80)
npm run test:smoke # Playwright smoke test against a running site (SMOKE_BASE_URL)
npx -y tsx scripts/settings-doc.ts --check # settings read only through lib/config.ts; docs/ENVIRONMENT.md current
gitleaks git --config .gitleaks.toml --redact . # no keys or tokens anywhere in the history (CI job "secrets")
CI runs all of them on every pull request (.github/workflows/ci.yml).
