Forse Growth Agent Monorepo

This repository is a pnpm + Turborepo monorepo with the following workspaces:

• backend: Express + TypeScript API server
• frontend: Next.js 14 app
• packages/tsconfig: Shared TypeScript configs
• packages/types: Shared TypeScript types (@forse/types)

Prerequisites

• Node.js 18+ (LTS recommended)
• pnpm (this repo uses the root pnpm-lock.yaml)

Install

pnpm install

Develop

Runs dev servers in parallel via Turborepo:

pnpm dev

Typical dev URLs:

• Backend API: http://localhost:3001 (check server config)
• Frontend: http://localhost:3000

Build

pnpm build

Notes:

• build depends on codegen in the Turbo pipeline.
• Backend generates backend/openapi.json during codegen.

Codegen

Run all code generation tasks across the monorepo:

pnpm codegen

• Backend: generates OpenAPI spec (backend/openapi.json).
• Frontend and shared packages provide no-op codegen scripts to keep the pipeline consistent.

Lint and Test

pnpm lint
pnpm test

Workspaces

• backend depends on @forse/types for shared TypeScript types.
• frontend imports types from @forse/types directly. The legacy shim frontend/lib/types/dynamic-form.ts has been removed.

Turborepo

The Turbo pipeline is defined in turbo.json:

• dev: non-cached, persistent processes
• codegen: writes **/openapi.json
• build: depends on ^build and codegen, outputs dist/**, .next/**, and OpenAPI artifacts

Common scripts at the repo root:

pnpm dev        # turbo run dev --parallel
pnpm build      # turbo run build
pnpm codegen    # turbo run codegen
pnpm lint       # turbo run lint
pnpm test       # turbo run test

Backend

Key scripts:

pnpm --filter ./backend dev
pnpm --filter ./backend codegen
pnpm --filter ./backend build
pnpm --filter ./backend start

OpenAPI:

• Generate: pnpm --filter ./backend codegen
• Served at /docs when openapi.json exists (generated at build/codegen)

Database:

• Migrations via Knex CLI
• Per-organisation schemas: we use schema-per-org (e.g. org_polygon, org_rootstock). Org schemas are created automatically when organizations are seeded.

Local dev setup:

# Run migrations
pnpm --filter ./backend run migrate:dev

# Seed dev data
pnpm --filter ./backend run seed:dev:ts

Reset database (keeps Docker running):

pnpm --filter ./backend run seed:reset:dev
pnpm --filter ./backend run migrate:dev
pnpm --filter ./backend run seed:dev:ts

Verify in psql:

\dn                    -- list schemas
\dt org_polygon.*      -- list tables in org_polygon schema
SELECT table_schema, table_name FROM information_schema.tables WHERE table_schema='org_polygon';

Frontend

Key scripts:

pnpm --filter ./frontend dev
pnpm --filter ./frontend build
pnpm --filter ./frontend start

Imports:

• Use @forse/types for shared types.

Conventions

• One lockfile at repo root only. No nested pnpm-lock.yaml in packages.
• Prefer workspace protocol workspace:* for internal deps.
• Keep packages/types as type-only exports; no runtime side effects.

Troubleshooting

• If the docs at /docs 404, run pnpm --filter ./backend codegen.
• If builds don’t see generated artifacts, ensure pnpm codegen runs and check turbo.json outputs include openapi.json.

:) :)