Skip to content
AceBoss1Public

About

#NotesApp fuses a publishing journal, a native booking calendar, and inline Naira payments into one workspace — so coaches, consultants, and therapists stop stitching together WhatsApp, a booking link, and a blog just to run their practice.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

574 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

#NotesApp

Where African creators, professionals and businesses publish, take bookings, sell and get paid in their local currency. 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. The owner's set-up steps outside the code are in docs/OWNER_SETUP.md.

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/OWNER_SETUP.md The owner's set-up guide: every step outside the code (Firebase, Cloudflare, Cloud Run, cron-job.org, domains, counsel, tests), in order, with costs and troubleshooting
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 naapp.tech
docs/STAGING.md The staging copy and how a release goes
docs/GROWTH.md Growth measurement (step 1 of the growth plan, v0.175.0): channels, first value, returns, Admin → Growth, the invite link, privacy
docs/REFERRALS.md Discount codes (#NotesApp and every publisher), referral links and affiliates: the owner's decisions, how plans are billed, what was built
docs/FUNDING.md Funding applications (internal drafts): the .tech startup programme for naapp.tech, the pitch.tech answers (due 20 Nov 2026), Emergent Ventures, and a reusable company summary
docs/NOTES-LIFE-LOOKS.md Notes Life's two looks (plan): a pixel look (what Low res becomes) and an HD look with your own avatar, chat beside the scene, jobs on screen and a city map with properties; the build steps
docs/BUSINESS-BOOKS.md Business books (plan, for the owner's approval): walk-in sales, expenses, stock, money owed and profit for sellers, Nana entries, offline entry, what can be imported today and how we'd import from Excel, Tralo, Shopify, Paystack and the rest, pricing options
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/NANA_PORTRAIT_STUDIO.md Nana AI, the portrait studio on nana.: moved into the main app from its v0 project, sign-in on its own address, the avatar maker's engine, owner steps (move the domains)
docs/NOTES_LIVE_STUDIO.md Notes Live Studio: broadcast graphics over a live (logo, lower third, ticker, subtitles, comments on air, clips, sponsor spot), the roles, the gate, and what comes next (LinkedIn Live)
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/CONTENT_CHECKS.md AI content checks: the owner's decisions (15 Nov 2026), the mockups, how the gate, strikes, appeals and the re-check work, owner steps (rules, the CSAM scanning tool, NCMEC)
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 2 Nov 2026, v0.117.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 (the lead invites with Can view or Can view and edit; the invitee agrees to the terms on /invites/journal/<id>, lib/invite-terms.ts), 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"
My Calendar One calendar for sessions, calls, hotel stays, tickets, events, interviews and money due (v0.166.0): /calendar (month with dots per kind, the day's agenda, Add to my calendar), /calendar/sync (a private webcal:// link, titles and times only, choose what goes out), /calendar/settings (bells, Monday week-ahead email), explainer /my-calendar docs/MY_CALENDAR.md, help "My Calendar"
Notes Planner A personal planner inside My Calendar (v0.178.0; docs/NOTES_PLANNER.md): /calendar/planner (Nana's interview one question at a time, "Did I get you right?", then the plan: one goal, three numbers, a project a month, daily moves, a Sunday review; or write it by hand), /calendar/planner/review, /calendar/planner/settings. The plan is the calendar's Plan kind, with tick boxes on the day. Encrypted with ACCOUNT_DATA_KEY, server-only collections, an optional passkey lock, a teen version. lib/planner.ts, lib/planner-nana.ts, lib/planner-server.ts; npm run test:planner, npm run test:planner-server.
Moments: tidy up and captions Trim the pauses and word-by-word captions on video moments and voice-overs (v0.179.0; docs/MOMENTS_TIDY.md). Off until NEXT_PUBLIC_MOMENT_TIDY_LIVE=true; captions also need CLOUDFLARE_AI_TOKEN. The trim is found on the device and kept as stretches to play (spans) that the viewer skips between; captions are timed words drawn by the viewer. lib/moments-tidy.ts, lib/moments-tidy-client.ts, lib/moments-captions-server.ts, components/moments/TidyPanel.tsx, CaptionOverlay.tsx; npm run test:moments-tidy.
My Cycle A private cycle and wellness companion (v0.163.0): /cycle (locked with a passkey, user verification every time; privacy shield), explainer /my-cycle, teen version without fertility, Nana advice, encrypted server-only data docs/MY_CYCLE.md, help "My Cycle"
Content checks AI checks before publishing (v0.174.0): every photo, video frame and text others can see (journals, community posts and comments, Moments, Media, shop items, events, profiles; never private messages); blocked posts stay drafts with a strike, borderline ones go to a person, appeals, posting pauses and bans, the Legal team's child-safety queue; lib/content-checks*.ts, /api/content-checks, Admin → Reports → Content checks, /content-rules docs/CONTENT_CHECKS.md, help "content-checks"
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"
Free trials 15 days, no card, from Pricing (/api/billing/trial, lib/trials.ts rules, lib/trials-server.ts): Pro and Business each once, a paid plan between two trials, only plans above the one paid for; expiry returns to the paid plan or Free Basic (lib/tier-billing.ts); add-on trials capped at 15 days help → "Plans and prices"
Inventory /profile/inventory (lib/inventory.ts pure, lib/inventory-server.ts, /api/inventory): stock per item and option, SKUs, cost prices and alert levels in inventory/{itemId}, every change in inventoryMoves (sales from lib/payments.ts, refunds, restocks, corrections), low-stock bells, CSV in and out; Business+ included, Free Basic and Pro the inventory_addon (₦1,500/month, 15-day trial) help → "Inventory"
Hotel kit /profile/hotel (lib/hotel.ts rules, lib/hotel-server.ts, lib/hotel-pay-server.ts money, /api/hotel, /api/public/hotel): the hotel's site page /hotel with rooms, holds and booking, orders from every department, staff board, kitchen screen, tills at /till, the room bill, branches, Nana ordering and add-ons; Starter, Standard and Grand on Pro, Business and Enterprise docs/HOTEL_KIT.md, help "hotel-kit"
Business books /profile/books (lib/books.ts money maths, P&L, caps, WhatsApp messages; lib/books-import.ts CSV matching, presets, dedupe; lib/books-server.ts; /api/books): walk-in sales and expenses, paid store orders flowing in (bookOnlineOrder, idempotent), money owed both ways with reminders (email and bell for members, wa.me click-to-send for others), receipts at /receipt/<code> and statements at /statement/<code>, P&L day/week/month, CSV import with undo and export (presets for Tralo, Shopify, WooCommerce, Selar, Bumpa and Paystack, and bank statements by CSV or text PDF, chosen line by line; source told from the headings); server-only book* collections; Free Basic caps in lib/pricing.ts books; Tell Nana (draft entries from a sentence, lib/books-nana*.ts), offline entry (an IndexedDB outbox synced once per clientId, lib/books-outbox.ts, public/sw.js), Cashier and Manager staff on Business and Enterprise (lib/books-staff-server.ts, accept at /invites/books/<id>), Pay now on statements (payment kind debt, lib/books-debt-server.ts), purchases (restock), and the monthly summary email on the 1st (lib/books-report-server.ts) help → "Business books"
Community and Events Audio rooms (lib/rooms.ts, host + 4 on stage, live chat; phone to phone, or through the Cloudflare relay once CLOUDFLARE_REALTIME_APP_ID/_TOKEN are set: lib/rooms-relay-server.ts, sizes in Admin → Limits; live mode video lib/rooms-live*.ts; the stage's modes (Solo, Approve, Open), empty seats with +, invitations and moderators with per-moderator permissions and a log (lib/rooms.ts "Stage seats", components/community/StageControls.tsx); in big relay rooms the chat, count and raised hands go over a WebSocket to a Cloudflare Durable Object per room once NEXT_PUBLIC_LIVE_ROOMS_URL and LIVE_ROOMS_SECRET are set: workers/live-rooms, lib/live-rooms*.ts, deployed by the "Deploy live rooms" workflow), a group-style feed, /community (directory, Start a community), /c/<id> (lib/community.ts rules, lib/community-server.ts, /api/community): roles owner/admin/moderator/member, open/approval/invite joining with questions, General (admins post), public and members-only Spaces, Circles (group chats, Business), admin tools, insights, View as, and what non-members see (admins choose); /events and /events/<id> (lib/events.ts, lib/events-server.ts, /api/events, .ics): RSVP, repeats, Join live, reminders in the cron docs/COMMUNITY.md, help → "Community", "Events"
Giving and paid event tickets Giving in a community (lib/giving.ts charges and cap, lib/giving-server.ts, /api/giving, payment kind giving, receipts at /giving, admins' Giving section with totals per fund); paid tickets on events (lib/tickets.ts, lib/tickets-server.ts, /api/tickets, payment kind ticket, QR tickets at /tickets, check-in at /events/<id>/checkin). Both have no commission: giving's bands (₦10/₦25/₦50), per gift or per ticket (quoteTickets reuses lib/giving.ts), plus the card charge at cost docs/COMMUNITY.md, help → "Giving to a community", "Paid event tickets and check-in"
Paid lives A member's own scheduled, ticketed live (lib/live-tickets.ts bands, discount, commission; lib/live-tickets-server.ts; /api/lives; payment kind live_ticket; /lives, /lives/new, /lives/<id>): early bird / normal / late prices, who can buy (everyone, Premium and up, VIP and up), each tier's ticket discount on Rates & payouts → Subscriptions, the recording choice (off, safety only, replay), the door checked by the server (mayEnter in lib/rooms-server.ts: ticket holders, the host and the moderators the host names), reminders and no-show refunds in the cron, money held until the live ends + PAYOUT_HOLD_HOURS, refunds to NotesApp Credit. The room is a member-hosted audio room (paid on the room doc, no community). Admin: Pricing liveTicketUpliftPct; Limits → Audio rooms → Paid lives docs/LIVE_ECONOMY.md (1a), help → "Paid lives"
Pay-per-minute sessions One-to-one voice and video calls with a publisher, paid by the minute (lib/ppm.ts the meter, holds and commission; lib/ppm-server.ts; /api/ppm; ppmOffers/{uid}, ppmSessions/{id}; /ppm, /ppm/<id>; Book · per minute on the profile, components/ppm/): a price per minute for voice and video and who may book (everyone, or the publisher's Premium/VIP/VVIP subscribers), the publisher's session times and slot locks, the minutes HELD from NotesApp Credit (walletHolds/{id}, placeHold/settleHold in lib/wallet-server.ts), the server's meter from both phones' beats (per started minute after the grace, top-up prompt, end after the wait), the charge as payment kind ppm with a ledger entry paid out PAYOUT_HOLD_HOURS after the call, the sweep in the cron. Admin: Pricing ppmUpliftPct; Limits → Pay-per-minute sessions docs/LIVE_ECONOMY.md (1b), help → "Pay-per-minute sessions"
Booking & money Native calendar, Paystack checkout, escrow-style holds, automatic payouts, client rescheduling/cancellation + problem reports "Payments, payouts, rates, reminders", "Money flow"
NotesApp Credit wallet Top up ₦1,000 to ₦500,000 through Paystack (bonus credits on larger top-ups), pay with wallet or card or both, statement with filters, refunds to the wallet; switch: NEXT_PUBLIC_WALLET_LIVE lib/wallet.ts, lib/wallet-server.ts, /help
Stores Physical goods (managed stock, categories, "ships from", parcel IDs, rider links, tracking), digital downloads (private bucket, short-lived links), saved items ♡, featured item, store boosts, reviews from buyers who received the item (with seller replies), official merch pre-orders; organisation admins can add and edit items "Seller checkout and parcel tracking", "Boosts & gifts", /store-selling
Analytics /profile/analytics (lib/analytics.ts pure, lib/analytics-server.ts reads, /api/analytics): earnings, orders and checkouts, average order, best sellers, low stock, bookings, visits, boosts and adverts; 7 days for all, 30/90 days + customers + CSV on Pro, visits by page and source on Business; organisation teammates with store access. Visits roll up per owner per day in ownerViews/{uid}_{yyyymmdd} (lib/visits-server.ts) docs/SITES.md, help → "Your analytics"
Sites Every member from Free Basic has a site at /s/<username> (app/(site)), set up on Your site (/profile/site): kits (lib/site-kits.ts: Personal and Academics on Free Basic; Fashion, Food & baking, Services, Healthcare, Beauty and wellness (spa, massage, hair, nails), Fitness, Events, Electronics, Motor parts, Solar, Real estate on Pro; School and Church/NGO on Business), a cover photo on every look, team members tagged by @username, the looks Legacy, Clean, Scholar with dark mode (Free Basic), Luxe (full-photo opening), Aurora and Maroon (Pro); Home leads with the shop, services, courses, notes or a mix (focus) with colour sets and a Pro brand colour (lib/site-themes.ts, CSS variables behind the crimson colours), content sections (banner with buttons, hours and contacts, services, gallery, testimonials, team, answers, and the academic Publications, Awards, Talks on a canvas globe (components/site/TalksGlobe.tsx, lib/places.ts, lib/globe-land.ts) and In the news, with imports from BibTeX/Google Scholar, DOI (Crossref) and ORCID with a daily sync, lib/publications-import.ts) in sites/{uid} written by lib/site-server.ts, an announcement bar (sites/{uid}.announce), a basket (lib/cart.ts, lib/cart-client.ts, components/site/SiteBasket.tsx; one card payment, kind store_cart, settled as one ordinary store order per item), no WhatsApp order buttons, pages Journals, Shop (a storefront borrowed from Shopify's collection pages: collection links, featured piece, product count, search, sorting, grid size and product tiles shaped by kit, components/site/Storefront.tsx; a full-width cover banner on shop-first homes) and Courses (each course opens inside the site, courses/[slug]) (Free Basic), Track (Business), About and Contact; the "Powered by #NotesApp" link follows the domain being viewed, or the primary address on an own domain (mainSiteUrl in lib/host.ts) docs/SITES.md, help → "Your own site"
Nana sets up your site, Review my site On Your site (v0.185.0; docs/SITE_NANA.md): /profile/site/nana (fixed questions, then one Nana call chooses kit, look, colours and buttons and drafts the words; code drops any price, number, phone or email the member didn't give; keep, edit, skip or try another; a preview of what will change; the site before kept 30 days) and /profile/site/review (a free checklist with fix links, and Nana's optional read with banner rewrites and 30 days' numbers). lib/site-nana.ts, lib/site-review.ts, lib/site-nana-server.ts, /api/site/nana, server-only siteSetups; npm run test:site-nana, npm run test:site-nana-server.
Day, Night and emoji packs lib/theme.ts (Day, Night, Auto by the clock; THEME_SCRIPT in the root layout's head; per device, notesapp:theme), Night colours in app/globals.css (maroon --c-*; sites, Exam Prep, the Life game and print pages pinned to Day with [data-site-theme] / [data-theme-off]), switch in Account settings and both menus (components/theme/). African pattern: drawings in lib/africa-drawings.ts, tile from npx -y tsx scripts/african-pattern.ts → public/images/patterns/africa-{day,night}.svg, used by .na-pattern (chats, empty covers). Emoji packs lib/emoji-packs.ts (:x-…: codes; Noto Emoji and Noto Color Emoji fonts; paid packs checked on send), countries lib/countries.ts, suggestions as you type lib/country-suggest.ts + components/CountrySuggest.tsx. Header ☀/☽/◐ button components/theme/ThemeQuick.tsx. Own chat background on Pro+ lib/chat-background.ts (saved in userPrefs.chatBackground via /api/messages/prefs, plan checked on save and read; pictures upload with purpose chat to chatbg/<uid>/), picker components/messages/ChatBackgroundPicker.tsx "Day and night…" in /help
Discount codes lib/discounts.ts (rules: targets, limits, discountFor, spreadDiscount), lib/discounts-server.ts (applyCode at checkout, readCodeForRedemption/writeRedemption inside fulfillPayment), discountCodes/{owner}_{CODE} and discountRedemptions/{reference} (server-only). Applied in app/api/paystack/initialize for store, basket, digital, course, booking, boost, Nana credit, merch and the add-ons; owners at /profile/discounts, #NotesApp's at /admin/discounts; buyers' field components/DiscountCodeField.tsx; #NotesApp codes on plans take the first payment off (couponFirst), and a code that isn't #NotesApp's is tried as a member's referral code (referralByCode) "Discount codes" in /help
Coupons lib/discounts.ts (couponOpen, publicCoupon, affiliateCodeSplits, couponPath), lib/discounts-server.ts (shopCoupons, couponCard, saveCoupon/myCoupons/removeCoupon, bestCoupon = Nana's pick, affiliate codes inside applyCode, the "another store" message), /api/coupons, /api/coupons/best, /api/coupons/card (the card picture); pages /coupon/<username>/<CODE>, /profile/coupons; components/CouponStrip.tsx on shop and product pages; reminders for saved coupons ending within 3 days (remindExpiringCoupons in the cron, components/CouponReminder.tsx once a day and after sign-in); savedCoupons, couponReminders (server-only); test test:coupons-server
Growth measurement lib/growth.ts (rules: channels from first touch, return tags, first value per kind of member, weeks, cohorts, the funnel), lib/growth-server.ts (sign-up source, first values, visits, installs, returns, the hourly snapshot, invite numbers), middleware.ts (firstTouch), components/GrowthBeat.tsx, /admin/growth, components/InviteLinkCard.tsx; tests test:growth, test:growth-server; docs/GROWTH.md
Referrals and affiliates lib/referrals.ts (rules: link, 20% for 12 months, the friend's first period, holds, cash or Credit + 10%, jump alerts), lib/referrals-server.ts (claimReferral, recordPlanEarning, affiliateFor/writeProductEarning inside fulfillPayment, withdraw, startReferralSubscription, setOffer/listOffers, alertIfJump), /r/<username> sets the na_ref cookie; pages /profile/referrals, /affiliates, /admin/referrals; collections referrals, referralEarnings, referralWithdrawals, affiliateOffers, referralAlerts (server-only); the monthly report lib/referral-report.ts (template) and lib/referral-report-server.ts (monthlyReferralReports, in the reminders cron on the 1st from 08:00 Lagos; markers referralReports/{uid}_{YYYY-MM}, runs referralReportRuns; emailPrefs.referralReport); tests test:referrals, test:referrals-server, test:referral-report-server
Share to Moments and Journals lib/share-targets.ts (pure: what can be shared, the card, the journal draft), lib/share-targets-server.ts (resolveShareCard: public items only), components/share/ShareToNotesApp.tsx (the buttons, sign-in prompt, Moment compose sheet, ShareMenu), shareToMoment in lib/moments-server.ts (moment kind: "link"), /share (finishes after sign-in or from a member's domain), GET /api/share; on journals, feed cards, courses, shop items and Market cards, services (1:1 sessions, site services), public events, certificates, coupons and public community posts; tests test:share, test:share-server
Payout OTP Paystack "Transfers OTP": a release answered status: "otp" waits as Awaiting OTP on /admin/payments (components/admin/PayoutOtpPanel.tsx), finished with POST /api/admin/payouts/otp (lib/payout-otp-server.ts: /transfer/finalize_transfer, /transfer/resend_otp, tries capped, payoutOtpLog audit, never the code); test test:payout-otp
Public pages Each live feature is described where a visitor looks for it: home and About (FEATURES, LIVE), /pricing (ROWS), the feature's own page (/store-selling, /community, /community/<part> from lib/community-features.ts, /events, /organisations, /boost), /roadmap, /status (lib/status.ts), the footer columns in app/(main)/layout.tsx, lib/site.ts (WHAT_YOU_CAN_DO) and the help articles (lib/kb-articles.ts). The rule: they change in the same push as the feature (HANDOVER §3) HANDOVER item 77
Frame (Moda redesign) Phones: one light header and a bottom tab bar (Feed, Explore, Market, Academy, Messages, Profile) for members and on the app address, full-screen conversations and calls; computers: the app header and left menu on the feed pages and the app address (lib/chrome.ts, components/shell/*) docs/ARCHITECTURE.md "The frame"
Promotion & discovery The journal feed (For you, Following, Latest, Top · 7d) with Most read, Who to follow, Promoted boosts and ads between posts; Explore (/explore) with Communities, Events (public, upcoming), Market and Academy tabs; Saved (journals, store items, courses, messages kept from chats); Notes Market (/shop) and Notes Academy (/academy) in one order: For you, Most viewed this week, Recent (lib/discovery.ts); profile tabs Notes, Store, Courses; Trending tabs Notes, Store, Courses, Events (tickets, RSVPs and visits in the period, trendingEvents), Communities, Publishers; post/item boosts (cancel any time, half of what's left refunded; strips rotate 3/1 per set every 45 s, Admin → Ads), gifts (animated gifts from a catalogue in Admin → Pricing → Gifts, lib/gift-catalogue.ts, components/GiftArt.tsx; "Top gifted today" at the top of Trending and Explore from daily totals in giftDaily, lib/gifts-server.ts; since v0.140.0 gift anyone from the ⋯ beside a name, several at once, weekly Top gifted / Top gifters, gift points, and the profile's Gifts tab with archive and Withdraw, lib/gift-earnings-server.ts), self-serve banner ads in a fixed 1200 × 628 frame across 12 spots incl. the weekly digest and Notes Life billboards (lib/ad-config.ts, /advertise/specifications) and ad share, recommendations on profiles and organisations "Boosts & gifts", "Advertiser campaigns"
Plans & badges Free Standard/Basic, Pro, Business (Paystack plans), Enterprise (custom); prices set by the owner in Admin → Pricing, including the two Enterprise course packages (Enterprise Courses ₦100,000/month, Enterprise Academy API from ₦250,000/month + usage; coursePackages in lib/pricing.ts); maroon ✔, gold ✔ (endorsed; identity-checked is built but Dojah is still on the sandbox) "Pro / Business plans", "Verified badge", "Dojah webhook"
Notes Academy Free and paid courses (/academy: a product page — hero, feature blocks, Teach/Sell/Grow/Learn tabs, live numbers, audiences, help articles, learners' and teachers' FAQ — around the course catalogue at #courses; components/academy/AcademyLanding.tsx): any publisher teaches free courses with lessons from their own YouTube, played inside #NotesApp, plus text lessons; paid courses on Pro (text, PDFs on private R2, YouTube) and Business/Enterprise (uploaded video on Cloudflare Stream, signed playback, a drifting @username + email watermark), sold through kind: "course" payments at the digital-item fee, paid out 7 days after the sale, two devices per learner, refunds within 7 days if not started; paid lessons only through POST /api/academy/lesson. Up to 4 co-tutors (Can view, or Can view and edit; each agrees to the terms on /invites/course/<id>) split each sale at their own plan's fee; organisations teach as themselves, crediting the team member who made the course ("Taught by"). Prepared courses (Emmanuel's two, LWB Academy's seven on AI) are seeded from Admin → Academy → Seed courses (lib/course-seeds.ts). Modules, course details, a private class link and a course group on #NotesApp (a Space in the teacher's community, or a new invite-only one in one tap, createCourseGroup; outside WhatsApp/Telegram links saved before still show, new ones are refused), likes, saves, reviews with teacher replies, and certificates (/certificates: ID + QR verification, PNG/PDF, LinkedIn; can be included in a paid course's price). Quiz lessons (multiple choice, a pass mark, unlimited retakes): answers kept in server-only quizKeys, marked by POST /api/academy/quiz (submitQuiz), attempts in quizAttempts; a quiz is ticked off only once passed. Nana's suggestions (topics, Market categories, course lines) are swiped in or out (components/SwipeChip.tsx). Covers made with Nana (components/academy/CoverMaker.tsx, POST /api/academy/covers, lib/covers*.ts, lib/cover-render.tsx): Pearl picks a design (8 templates, 8 palettes, our own African patterns and icons), our server draws it at 1600 × 900 as WebP; Free Basic 3 a day, Pro 10, Business 25, Enterprise 50 (Admin → Pricing), each edit counting one, paid from the Nana allowance; samples in public/images/academy/covers/ docs/COURSES.md
Naija Exam Prep JAMB, WAEC and NECO practice at prep.notesapp.name.ng (app/exam-prep, lib/exam-prep.ts rules, lib/exam-prep-server.ts, /api/exam-prep/*): free questions with explanations, server-timed mocks, a pack per exam (₦1,000, 12 months, Paystack, platform revenue, 7-day refund rule), pay links, offline packs with a signed pass (EXAM_PREP_PASS_KEY), progress and a nickname-only weekly board, teen mode with parent confirmation; reviewers by subject invite links (one person or open volunteer links), Admin → Naija Exam Prep; 4,090 starter questions (scripts/exam-prep-starter.mjs): JAMB 70 in each of seven subjects, WAEC and NECO 100 each in 18 subjects (scripts/exam-prep-questions/; WAEC/NECO first batch in ssce/, the second batch for every exam in batch2/, each with its check.mjs) HANDOVER.md items 41–42, 51, 56, 61, docs/YOUNG_MEMBERS.md, help articles "Naija Exam Prep"
Announcements, feedback and Exam Prep reviewers Admin → Announcements (lib/announcements.ts, lib/announcements-server.ts, /api/admin/announcements): a bell to every member and an email to those whose choices allow it, preview, test, batched and once per member (announcementSends), signed unsubscribe (/api/announcements/unsubscribe), page at /announcements/[id]; the one-month draft is seeded. Feedback form /contact?topic=feedback (lib/feedback.ts, /api/feedback) and reviewer sign-up prep.<domain>/reviewers (lib/prep-reviewers.ts, /api/exam-prep/reviewers) land in Leads (lib/leads-server.ts: approve → reviewer access or an invite link; the private Naija Exam Prep Reviewers community, seeded with one tap) HANDOVER.md item 83, help articles "Give us feedback", "News and announcements", "Reviewing questions"
Kiswahili Journals and voice notes in Kiswahili with NKENNEAi (lib/nkenne.ts, lib/kiswahili-server.ts), Admin → Kiswahili (NKENNEAi); public repo AceBoss1/notesapp-swahili help article "Journals and voice notes in Kiswahili"
Enterprise Server-to-server API (/api/v1: posts, image uploads /v1/uploads, bookings, orders, earnings), Console, signed webhooks, /docs, own domain (subdomain or root); own domain for Business and Enterprise (the site itself is on every plan from Free Basic; see Sites above) "API, Console, Docs and custom domains"
App address app.notesapp.name.ng: welcome screen with sign-up and sign-in, a Download button that knows the device, then the journal feed middleware.ts
Careers, Nana-HR and the staff library /careers (roles opened in the team hub, apply with a NotesApp account), Nana-HR at /admin/team/hr (answers from the handbook, SOPs, briefs and the person's own records; hiring with screening summaries and onboarding drafts), the library's seeded handbook, SOPs and briefs (lib/staff-library-seed.ts, content/staff-library/) help → "Nana-HR and hiring"
Nana Jobs (v0.162.0) /jobs/nana: members 18+ connect their own AI (Gemini, Groq, Claude or OpenAI-compatible), start from their CV (an honest review and a profile to start from), and get a daily shortlist from Notes Jobs, open feeds and watched company boards, scored with a reason and the strongest risk; statuses, bell and email, a cover-note helper; never applies. Explainer /nana-jobs docs/NANA_JOBS.md, THIRD_PARTY_NOTICES
Google and LinkedIn sign-in Continue with Google (Firebase) and Continue with LinkedIn (our own OpenID Connect flow) on sign-in and sign-up; first-time accounts take the usual new-account steps; Account settings → Sign-in methods links and unlinks them, never the last way in; no silent account merging (lib/social-auth*.ts, lib/social-oidc.ts, /api/auth/{google,linkedin,methods}) help → "Signing in with Google or LinkedIn"
Passkeys Sign in with a fingerprint, face, screen lock or security key on every account and at the team hub's Staff login (lib/passkeys*.ts, /api/passkeys/*, Account settings → Passkeys) help → "Signing in with a passkey"
Trust & ops /security, /status (+ incidents, response times, email subscribers, calls and their relay, the audio rooms relay, the live room chat worker, Claude), /changelog, account export/deletion, error monitoring, traction snapshot (stored hourly), admin by custom claims and departments "Where to look when something's wrong" below
Media (phase M1) A Media tab on every profile (/u/{username}, /u/{username}/media) and the studio (/profile/media): videos on Cloudflare Stream (public playback), up to 10 WebP pictures a post, everyone / followers / subscribers, pinned posts and pinned Moments (kept past expiry while pinned), site-kit pictures with Hide switches, the profile picture album, the permanent NotesApp mark on every picture and video (also replays, shop, service and journal pictures; only the marked copy kept, lib/media-mark.ts, re-marking job in Admin → Limits), Admin → Limits "Media", teen rules. Plan: docs/MEDIA.md lib/media-rules.ts, lib/media-server.ts, lib/media-watermark.tsx, lib/media-replays.ts, /api/media/*, components/media/*; flag NEXT_PUBLIC_MEDIA_LIVE (on unless "false"); tests test:media, test:media-server, test:marks-server
Subscriptions and fans Premium (🌄 Starter), VIP (🛡 Army) and VVIP (🏆 VVIP) subscriptions, each priced by the creator within the Admin range (VIP and VVIP carry the rate plus 10% / 20% of it), posts for Everyone / Premium+ / VIP+ / VVIP only; fan points (money, shares, comments, reactions, daily caps), the top 99 badges on comments and reviews, the Top fans page (/u/{username}/fans) with your fan level, and live entrances for the top three (yacht/jet, SUV/sports car, e-bike/bicycle). Admin → Limits "Subscriptions and fans" lib/fans.ts, lib/fans-server.ts, /api/fans/*, components/fans/*; tests test:fans, test:fans-server
Messaging Direct messages and group chats (up to 50, admin moderation), voice notes, stickers, emoji, bold/italic/underline, replies, pin 3 messages and 3 chats, typing indicator, edit/delete with reader consent once read, link previews, moments, block/report, device and email notifications Flags NEXT_PUBLIC_MESSAGES_LIVE, NEXT_PUBLIC_MOMENTS_LIVE
Calls Free 1:1 voice and video calls between people who follow each other (WebRTC), a safety code from both DTLS fingerprints (lib/calls.ts), screen sharing on computers (with a data-channel flag so the other side shows the whole screen), group calls in group chats (mesh: up to 6 voice / 4 video; lib/group-calls.ts, lib/group-calls-server.ts, groupCalls/{id}/links), call back from the call line, drag/swap self view, front/back camera, ringing on the installed app even when closed; relay through Cloudflare TURN or our own TURN; mid-call ICE restarts when the network changes, direct first and the relay forced only after two failed restarts (lib/ice-recovery.ts, components/calls/ice-recovery-client.ts, v0.136.0) lib/calls-server.ts, flag NEXT_PUBLIC_CALLS_LIVE
Followers and presence Followers and Following lists on every profile, online now and last seen (only for people who follow you), two privacy switches /help → "Followers, following and online status"
Nana AI and help centre Chat on every page, pinned in /messages, /nana, /help articles (built-in + staff, Admin → Help & Nana), writing help in drafts, sharing and messages, member-connected Anthropic key, Ask Nana in the team hub, help-centre-only answers when the AI is off; gems Pearl/Emerald/Ruby by plan (lib/nana-gems.ts), a weekly free allowance and Nana credit (lib/nana-meter.ts), the shared answer bank (lib/nana-bank.ts), topic/subtopic/category suggestions from a title, chat Summarise and Translate "Nana AI and the help centre"
MCP server (phase 1) mcp.notesapp.name.ng (/api/mcp): read-only tools for AI assistants to find creators, journals, Market items and courses, open session times and booking links; with an API key, the member's own profile, posts, bookings, orders and earnings; every call logged lib/mcp/*, /docs
Notes Life A free life game at life.notesapp.name.ng (and /life) played with the NotesApp account: needs, jobs and shifts, food (Chef Adams delivery, takeaway, dine-in, cooking), a fridge and microwave, NEPA blackouts with Power GO / generators / solar, Abuja (Lagos coming), partners Chef Adams, itel Energy, Candellux Imperial (suites with an 11 AM checkout, room service, the pool, swimming lessons, the VIP bar with a 360° view, gym) and Digital Witch (courses, certificates for tech jobs, Cynthia Okeh as #1 and her Saturday giveaway), Paylony CardTap (every N$ payment at a counter is a tap of the player's CardTap card; lib/life/cardtap.ts), partner outlets players can own, residents 🤖 and real players at the same place, chat with friends, invites (₦250 each), Billionaires List, sound. Game money (Notesville Naira) bought with the wallet or a card, never cashed out; two more Wuse streets (Wuse Market Zone 4, Aminu Kano Crescent Wuse II) with errands, and Emerald Ezurukam (#1, the convoy gift at the bus stand); restrooms away from home (hotel, partners, Wuse Market mobile WC); LUXNAS (partner: academy, jobs, studio) README "Notes Life" section, /help → "How Notes Life works", /life/partners, flag NEXT_PUBLIC_LIFE_LIVE
Social publishing Publish a post to a connected LinkedIn or X account (LINKEDIN_*, X_* variables) "Publish to LinkedIn and X" in /changelog
Team hub (internal) Team access (super admins, admins by department, and a Chief of Staff who assigns departments until there is an HR team), work board (views by person, departments, due dates), milestones, daily/weekly summaries, meetings with Granola (each member connects their own account), money ledger, Grants & subscriptions, Expenses due, payment assignee and deadlines, time tracker and weekly timesheets (check-ins, attendance, leave, billable projects, team leads who approve), payroll by the hour, staff library with "I have read this" and who has read it, team message hub, legal team access, Admin → Pricing, the AI agent-layer backlog (15 items with owners and due dates). In internal testing; it will be a paid add-on for Business and Enterprise once testing is done (/teams) "Money ledger", lib/admin-access.ts
Public site Home and About with the owner's description, Trusted by and Partners marquees (lib/partners.ts), With thanks (programmes that back us), /pricing (plans, course pricing, the Enterprise course packages, the paid add-ons to come), /teams, /roadmap, /domains, the #1MillionNairaNotesAppChallenge; the standard description lives in lib/site.ts lib/partners.ts, lib/site.ts
Company NOTESAPP TECHNOLOGIES LTD (RC and TIN in lib/site.ts; SMEDAN number pending) "Company identity"

Not built yet

Payments across Africa (docs/PAYMENTS.md: Paylony virtual accounts, the one payment layer, Flutterwave for Kenya, then Ghana) · 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: 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:ai-seeds              # LWB Academy's seven AI courses: shape, limits, credits
npm run test:course-seeds-server   # Seed courses on the emulator: drafts, in-place rewrite, an organisation owner, no copies
npm run test:covers                # Course covers: the design check, daily limits, Lagos days, every template's words fit
npm run test:covers-server         # Course covers on the emulator: who may, the daily count, the Nana allowance, history
npm run test:quizzes-server        # Quiz lessons on the emulator: answers kept apart, fail then pass, no ticking an unpassed quiz
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).

About

#NotesApp fuses a publishing journal, a native booking calendar, and inline Naira payments into one workspace — so coaches, consultants, and therapists stop stitching together WhatsApp, a booking link, and a blog just to run their practice.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages