Nommo

It is said that in the first age of Earth, the Nommo descended from the stars into the sea.

It is said that the Nommo came to impart unto man his first wisdom:

that in order to truly live, one must do more than survive; he must know.

Ship from anywhere

CI / CD

GitHub Actions checks every PR. Vercel ships main. A Deploy workflow is the phone-tap backup when secrets exist.

PathWhatWhere
CIprisma generate, tsc, vitest, lint, next build.github/workflows/ci.yml
Vercel GitPreview on PR, production on mainVercel dashboard → Git
Deploy Actionvercel pull/build/deploy --prod.github/workflows/deploy.yml
Env exampleKnobs, no secrets.env.example

First production

  1. Create the GitHub repo. Push main.
  2. Import the repo in Vercel (Next.js). Set NEXT_PUBLIC_SITE_URL to the prod host.
  3. Add DATABASE_URL when state must survive. Add Stripe/Supabase when you want live auth/money — still leave GO_LIVE=false until counsel.
  4. Optional GitHub secrets VERCEL_TOKEN, VERCEL_ORG_ID, VERCEL_PROJECT_ID so Actions → Deploy works from a phone.

Namecheap DNS → Vercel (no env yet)

  1. GitHub: new repo, git remote add origin …, git push -u origin main.
  2. vercel.com → Add New → Project → import that repo. Framework: Next.js. Do not add env vars. Deploy.
  3. Wait for the *.vercel.app URL. Open it on your phone. Demo logins still work (owner@ / driver@ / admin@ + any 8+ character password).
  4. Vercel → Project → Settings → Domains → Add yourdomain.com and www.yourdomain.com. Copy the A / CNAME values Vercel shows (they can change; do not guess).
  5. Namecheap → Domain List → Manage → Advanced DNS. Delete Namecheap parking/URL-redirect records that conflict. Add the records Vercel listed. Typical shape: A @ → Vercel IPv4 (dashboard), CNAME www → the vercel-dns host they print. TTL automatic.
  6. Optional: Namecheap → Nameservers → Custom, paste Vercel’s ns1/ns2 if you would rather hand the whole zone to Vercel. Then you do not maintain A/CNAME at Namecheap.
  7. Back in Vercel, wait until the domain is Valid and the certificate is Issued (often a few minutes, sometimes up to an hour). HTTPS is automatic.
  8. Later (not now): Vercel → Settings → Environment Variables → NEXT_PUBLIC_SITE_URL=https://yourdomain.com and anything else. Redeploy.

GO_LIVE remains a legal switch, not a deploy switch. You can host the demo on Vercel at $0 vendor APIs.