COMMAND REFERENCE

fxcss init

bash

fxcss init                               # PR previews
fxcss init --watch                       # also check Firefox weekly
fxcss init --showcase --previews          # also publish screenshots
fxcss init --watch --showcase --previews  # generate all six workflow files

init writes to .github/workflows/. Existing files are preserved unless you pass --force; review regenerated files before committing, especially if you have customised them. Generation pins the installed fxcss version. The preview publisher validates variant filenames and PNG headers, including options added by later PRs. Updating fxcss locally does not update workflows already in a repository.

Feature	Enable with	When it runs	What readers see
PR previews	`init`	Relevant pull request changes; macOS, Windows and Linux.	A comment showing before/after views and highlighted differences, including optional stylesheets.
Firefox watch	`init --watch`	Weekly on Mondays, or manually; Release, Beta and Nightly on macOS.	Fix PRs or issues for actionable selector findings, plus a separate issue if screenshot capture fails.
README previews	`init --previews`	Matching theme changes on `main`/`master`, or manually; macOS.	Refreshed standard and variant screenshots plus cropped option comparisons on the `previews` branch.
Release showcase	`init --showcase`	A release is published, or manually; macOS.	Light/dark screenshots against live websites on the `showcase` branch.

The workflows download Firefox on their runners. Generated preview triggers cover chrome/, configuration/, custom/, optional/, options/, extras/ and variants/. Review the filters if you keep theme assets elsewhere. Re-run generation and review the changes to update the pinned fxcss version or adopt improvements to the workflow templates. New variants are included automatically.

Getting started Pull request previews