NUTRISYNCBuilders Hub
🏠 🛠
NUTRISYNC · Docs

NutriSync — Team Testing & Access Guide

A practical guide for the team — including the testers in Madrid — to try NutriSync across all three surfaces: the live web app, the marketing site, and the native mobile app on real phones. Everything is shared over the internet, so it works no matter where each person sits; nobody needs to be on the same Wi-Fi or hold a copy of the code.

As of July 2026, the web surfaces are live and public on Cloudflare Pages, and the mobile app is ready to distribute as a shareable Android APK (or via iOS TestFlight once Apple enrollment is done). This document tells you exactly where to click and what to run.

Analogy for the two mobile paths: a shareable build (APK / TestFlight) is a sealed product sample — a tester taps an icon and it just runs, no laptop involved. Expo Go is screen-sharing your running app — great while a developer is actively building, but it depends on that developer's machine being on. For the Madrid testers, send a build.


1. The fastest thing to try: the live web apps

There is nothing to install. The whole product is already online as one Cloudflare Pages deployment (project nutrisync-collective):

The web app is the Claude Design build stitched to the same Supabase backend the mobile app uses — real sign-up and log-in, real cycle onboarding, real logging, and the same Cycle Alignment Score. It reads and writes all eight core tables and supports in-app JSON export and account deletion. So a tester who signs up on the web and a tester who signs up on Android are hitting the exact same database.

How a tester uses it

  1. Open https://nutrisync-collective.pages.dev/app.html.
  2. Sign up with an email and password. (Email confirmation is turned off, so sign-up completes immediately — see the note below.)
  3. Complete the short cycle onboarding. Session routing does the rest: no session → login, a session with no cycle yet → onboarding, otherwise → home.
  4. Log a day, watch the Sync Score update, explore Progress and the Calendar.

Ops note for whoever administers Supabase: "Confirm email" must stay OFF in Supabase Auth for self-serve sign-up to complete without a mailbox round-trip. The anon key baked into the web bundle is public and safe — Row-Level Security scopes every row to the signed-in user, so one tester can never see another's data.

The site is currently public (the old Cloudflare Access email whitelist was removed). If you ever need to lock it down for an external audience, it can be re-added via Cloudflare Zero Trust → Access.


2. Testing the mobile app — pick a path

There are three ways to get NutriSync onto a phone. For non-developers such as the Madrid testers, use A (Android APK) first; it is the least friction and needs no paid account.

Path Best for Paid account needed? Gets OTA updates?
A. Android APK (EAS Build, preview) Any Android tester, distributed team No Yes — after install
B. iOS TestFlight iPhone testers Yes — Apple Developer Program ($99/yr) Yes
C. Expo Go (dev) Developers iterating live No No

The APK and TestFlight paths install a real build of the app, which is what receives over-the-air (OTA) updates when the team pushes code. Expo Go does not receive OTA — it only ever runs whatever a developer's machine is currently serving.


A. Android APK — recommended for the Madrid testers

This is the sealed-sample path: one cloud build produces a downloadable .apk with a share link and QR, and no Apple or Google paid account is required.

A1. One-time developer setup

npm install -g eas-cli
eas login                          # use the shared Expo account
git clone https://github.com/githubjuanjose/nutrisync-app
cd nutrisync-app
npm install

A2. Build the shareable APK

eas build --profile preview --platform android

The preview profile is configured for internal distribution with buildType: apk. When the cloud build finishes, EAS returns a download page with a link and QR code.

A3. Send it to the testers

  1. Forward the EAS link (or QR) to the Madrid testers.
  2. On their Android phone they tap the link → download the APK → when prompted, allow "install from unknown sources" for their browser or Files app → install.
  3. Done. The app runs standalone — no laptop, no Wi-Fi pairing.

After a tester has the APK installed once, every push to the nutrisync-app repo reaches them over the air (Section D). They just reopen the app to get the latest JS/UI.


B. iOS TestFlight — needs paid Apple enrollment

iOS cannot sideload the way Android can, so Apple's TestFlight is the route for iPhone testers. The blocker today is enrollment: a free Apple account has no "team" and cannot sign or distribute a build. You need the Apple Developer Program ($99/year) first.

Once the org is enrolled:

eas build --platform ios --profile production
eas submit --platform ios --latest      # uploads to App Store Connect → TestFlight

Until Apple enrollment is complete, point iPhone-only testers at the web app (Section 1) so they can still try the product.


C. Expo Go — for developers iterating live

Expo Go is for the people actively building, not for stakeholder testing.

cd nutrisync-app
npx expo start                     # same Wi-Fi: scan the QR with Expo Go
npx expo start --tunnel            # remote: routes through Expo's servers (ngrok)

D. Instant updates without rebuilding — OTA (already wired)

The mobile OTA pipeline is live. Think of the GitHub Action as a conveyor belt: push code → the app updates itself on every installed build, no rebuild, no store review.

eas update --branch production --message "tweak Home screen"

0. Prerequisites (developers only)

Testers need nothing but a phone and the link you send. Developers building the app need:

  1. Node.js ≥ 20.19.4 — https://nodejs.org (the project is on Expo SDK 54, which requires Node 20.19.4 or newer; older Node 18 will not work).
  2. Git — https://git-scm.com
  3. A free Expo account — https://expo.dev/signup (use the shared org account so builds and OTA go to one place).
  4. EAS CLInpm install -g eas-cli.

The two repos: - githubjuanjose/nutrisync-app — the Expo mobile app + OTA pipeline. - githubjuanjose/nutrisync-web — the marketing site + wired web app + gated hub + Cloudflare deploy pipeline.


E. "Send to the Madrid team" checklist


F. Costs to be aware of


G. Troubleshooting