Getting started :: Website

The Next.js package under site-nextjs/ is the official (and only active) web application. Run and develop against that package for auth, Convex, maps, POS, and management flows.

The SolidStart package (site-solidstart/) is retired — archive only; not deployed. It remains a pnpm workspace member so the lockfile stays coherent.

Prerequisites

Node.js 24.x — required (native addons and Vercel).
pnpm 11.17.0 — pinned in the root packageManager field; use Corepack (do not npm install -g pnpm).
Accounts for Square, Radar, and Convex for the full production feature set.

Full mental model (workspace members, allowBuilds, version fights): Tooling: Node, pnpm, and the monorepo.

Run the Next.js app

Clone the repository, enable Corepack, and install at the monorepo root:

git clone <repo_url>
cd ftn-site
corepack enable
corepack prepare pnpm@11.17.0 --activate
pnpm install

Copy environment files and configure secrets (see Environment variables):
```
cd site-nextjs
copy .env.example .env.local
```
Start Convex (separate terminal, from site-nextjs/):
```
pnpm exec convex dev
```
Start the Next.js dev server (from site-nextjs/):
```
pnpm dev
```
Open http://localhost:3000.

Deeper setup

Tooling: Node / pnpm — workspace layout and Corepack.
Next.js: Getting started — end-to-end nextjs module notes.
Convex setup — shared database behavior.

SolidStart (retired)

The SolidStart package is archive-only. Do not add product features. See site-solidstart/README.adoc.