Getting started :: Website

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

The SolidStart package (site-solidstart/) is on hold — kept in the monorepo for reference only.

Prerequisites

Node.js — use the version expected by the repo (see root or site-nextjs tooling).
pnpm — the monorepo uses pnpm at the root; Corepack is recommended to match the project’s packageManager field.
Accounts for Square, Radar, and Convex for the full production feature set.

Run the Next.js app

Clone the repository and install dependencies at the monorepo root:
```
git clone <repo_url>
cd ftn-site
pnpm install
```
Copy environment files and configure secrets (see Environment variables):
```
cd site-nextjs
copy .env.example .env
copy .env.example .env.local
```
Start Convex (separate terminal, from site-nextjs/):
```
pnpm exec convex dev
```
Start the Next.js dev server:
```
pnpm dev
```
Open http://localhost:3000.

Deeper setup

Next.js: Getting started — end-to-end dev loop with Convex and Vercel-oriented notes.
Convex setup — shared database behavior.

SolidStart (on hold)

If you need to run the archived SolidStart shell for comparison:

cd site-solidstart
pnpm dev

Do not add new product features to SolidStart unless the port is officially revived.