Skip to main content

Deployment Guide

This guide stitches together the deployment story for both the main Infowebplus application and the documentation site.

For focused, detailed docs, see:

What gets deployed where​

  • Main application
    • Hosted on Vercel.
    • Uses optional Upstash Redis integration for caching.
  • Documentation
    • Hosted on Cloudflare Pages.
    • Built with Docusaurus (this repo).

Main application (Vercel)​

Key steps (see the Vercel guide for full details):

  1. Connect the main Infowebplus repository to Vercel.
  2. Configure build and output settings according to the Next.js app.
  3. Optionally install Upstash from the Vercel Marketplace for Redis:
    • Automatically provisions a Redis database.
    • Sets the REDIS_URL environment variable.
  4. Ensure required environment variables are configured for Production, Preview, and Development.

Related docs:

Documentation (Cloudflare Pages)​

For the docs in this repository:

  1. Connect the docs.infowebplus.com repo to Cloudflare Pages (GitLab integration).

  2. Use the build command:

    cd docs && npm install && npm run build

  3. Set the output directory to docs/build.

  4. Configure the custom domain docs.infowebplus.com with a CNAME pointing to your *.pages.dev host.

See:

Environments and variables​

Environment variables are documented in:

At a high level:

  • Vercel
    • App-related secrets (Sanity, Redis, HubSpot, email, etc.).
    • GTM or analytics IDs for the main app.
  • Cloudflare Pages
    • Usually minimal; optional GTAG_ID for analytics on the docs site.
TODO

Cross-check actual environment variables in Vercel and Cloudflare dashboards against the configuration guide and update the docs if there are discrepancies.