Kredal Docs
How to

Deploy to Vercel

Deploy the Kredal app and the docs site to Vercel.

Kredal is two deployable projects: the app (kredal-app/) and the docs site (docs-site/). Both are Next.js and deploy cleanly to Vercel.

Deploy the app

  1. In Vercel, New Project → import the anilandcode/loanready repo.
  2. Set Root Directory to kredal-app.
  3. Add environment variables (Project Settings → Environment Variables):
    • NEXT_PUBLIC_SUPABASE_URL
    • NEXT_PUBLIC_SUPABASE_ANON_KEY
    • SUPABASE_SERVICE_ROLE_KEY (mark as sensitive; never expose to the browser)
  4. Deploy. Framework preset auto-detects Next.js.
  5. In Supabase → Authentication → URL Configuration:
    • Set Site URL to the production URL.
    • Add https://<your-domain>/auth/callback to Redirect URLs — password-reset and email-confirmation links exchange their code at this route.

Auth email volume (do this before any pilot)

Supabase's built-in auth mailer is rate-limited to roughly two emails per hour — enough for solo testing, guaranteed to break real signups, password resets, and member invites. Connect a custom SMTP provider (Resend has a free tier) in Supabase → Authentication → SMTP Settings, and verify a sender domain there first.

Deploy the docs site

  1. New Project → same repo, Root Directory docs-site.
  2. No secret env vars are required for the public docs.
  3. Deploy. Optionally attach a docs. subdomain.
  4. Confirm /, /llms.txt, and /llms-full.txt all respond.

Verify a deployment

  • App: sign up, create a company, run an assessment against the live database.
  • Docs: search works, a page renders with the Kredal navy theme, Mermaid diagrams draw.

Notes

  • This repo lives on a Google Drive–synced path locally, which makes git operations slow. When committing before a deploy, allow generous timeouts (or run in the background) and check for a stale .git/index.lock before assuming a crash.
  • Preview deployments are created per pull request automatically — useful for reviewing docs changes before they hit main.

On this page