Install

Install gform, get a browser ready, then run your first form.

Requirements

Requirement	Notes
Node.js ≥ 20	From package engines
Chromium-family browser	Playwright Chromium for runs; prefer system Chrome for Google sign-in
Network	Live inspect / verify --check / run need access to Google Forms

Published package

pnpm add -g gform
# or
npm i -g gform

pnpm exec playwright install chromium

Confirm:

gform version
# or
gform -V

From this repository

pnpm install
pnpm exec playwright install chromium
pnpm build
pnpm i -g .

Dev without a global install:

pnpm gform -- --help
pnpm gform -- list

Data home

Default library and artifacts:

~/.local/share/gform/

Overrides:

export GFORM_HOME=/custom/gform
# or
export XDG_DATA_HOME=/custom/xdg   # → $XDG_DATA_HOME/gform

See portable paths · platforms.

Browsers and WSL

• gform browsers list — discovery and readiness
• gform browsers setup chrome — host-aware install plan (Linux/WSL .deb)
• gform doctor — disk + inventory; add --browser / --auth for live probes

On WSL, Windows Chrome under /mnt/c/… may show as found but is usually not CDP-controllable. Install Linux Chrome for auth and headed runs. Details: browsers · platform.

Next

1. Guide — first form
2. Concepts
3. Schema