Manual Setup

Prerequisites

  • Node.js 22+

  • PowerShell 7+ on Windows (or Bash on macOS/Linux)

  • Accounts: Square Developer, Radar SDK, Convex

Steps

  1. Clone and enter the repo

git clone <repo_url>
cd ftn-site-vercel/ftn-nextjs

  1. Enable Corepack and pnpm

corepack enable
corepack install

  1. Install dependencies

pnpm install

If prompted about ignored build scripts, approve them:

pnpm approve-builds

  1. Configure environment variables

Create .env and .env.local using the templates, then add values. See Environment Variables.

  1. Start Convex dev server (separate terminal, from ftn-nextjs directory)

cd ftn-nextjs
npx convex dev

  1. Start the Next.js dev server

cd ftn-nextjs
./run.ps1

Open http://localhost:3000