FlexPoint Docs

Deployment & Access

How the FlexPoint docs hub is deployed to Vercel and locked down to internal users via SSO.

The hub is a standard Next.js app and deploys to Vercel. For v1 it is internal-only, gated by Vercel Authentication.

Deploy to Vercel

  1. Create a new Vercel project from the flexpoint-docs repository.
  2. Framework preset: Next.js (auto-detected).
  3. Build settings (defaults work):
    • Install command: pnpm install
    • Build command: pnpm build
    • Output: .next
  4. Set a project domain, e.g. docs.<your-domain>.

The fumadocs-mdx postinstall regenerates the .source index on every install, so no extra build step is needed.

Lock it down: internal-only SSO

Use Vercel Deployment Protection → Vercel Authentication to require a logged-in Vercel team member for every request:

  1. Vercel project → Settings → Deployment Protection.
  2. Enable Vercel Authentication (Standard Protection) for Production (and Preview).
  3. Invite the people who should have access to the Vercel team.

This gives SSO-style access control with no application code — anonymous visitors are bounced to Vercel's login. It satisfies the v1 "internal-only" requirement.

Why not a custom auth gate?

We intentionally rely on Vercel Authentication rather than building a custom login. It is zero-maintenance, integrates with the Vercel team, and keeps the hub a pure static/SSG docs site. A public carve-out (some docs public, some private) can be added later if the business needs it.

Cutover from the in-app /docs

The Loan Portal currently serves docs from apps/flex-hub/src/app/docs. Retire it only after this hub is live:

  1. Deploy the hub and confirm parity (all migrated pages render).
  2. In FlexPointPortal/apps/flex-hub, set DOCS_HUB_URL to the hub's URL. The next.config.ts redirect (already wired, env-gated) then sends /docs → the hub. With the env var unset, the in-app docs keep working — so this is a safe, reversible switch.
  3. Once the redirect is verified in production, delete the in-app docs route and remove the fumadocs dependencies from apps/flex-hub.

Don't delete the in-app docs early

Removing apps/flex-hub/src/app/docs before the hub is live and the redirect is verified would break the product team's current docs link. Keep both until cutover is confirmed.

Authoring Guide

How to write and structure documentation in the FlexPoint hub so it stays a trusted reference, not a change log.

On this page

Deploy to VercelLock it down: internal-only SSOCutover from the in-app /docs