Manual Setup

Prerequisites

  • Node.js 24+

  • pnpm 10+

  • PowerShell 5.1+ (Windows) or Bash (macOS/Linux)

    • There might be some scripts that only work in PowerShell 7+. If so, you can install it from the Microsoft Store, and then update this document or inform a leader.

  • Accounts: Square Developer, Radar SDK, Convex

Steps

  1. Clone and enter the repo

    git clone <repo_url>
cd ftn-site

  2. Enable Corepack and pnpm

    Your system is using Corepack to manage package managers. Corepack acts as a wrapper that ensures the version of pnpm used matches what the project expects.

    corepack enable
corepack install

  3. Install dependencies

    Run this in the root directory:

    pnpm install

    If prompted about ignored build scripts, approve them:

    pnpm approve-builds

  4. Configure environment variables

    Navigate to site-nextjs and copy the example environment files:

    cd site-nextjs
cp .env.example .env.local

    Populate .env.local with your personal API keys. See Environment Variables for a detailed breakdown of each variable.

  5. Start Convex dev server (separate terminal, from site-nextjs directory)

    pnpm exec convex dev

  6. Start the Next.js dev server

    pnpm dev

    Open http://localhost:3000

After schema changes (Convex)

If new modules add tables (for example events or host venues), run pnpm exec convex dev from site-nextjs until the deployment syncs, or deploy Convex in your CI step before relying on production builds.

Set NEXT_PUBLIC_APP_URL for correct sitemap and social preview URLs.

See Events & Host Venues for the feature model.