@cside.dev/cli

A CLI tool for injecting cside's script into your static HTML files.

Usage

To run the latest version of this tool, use the following command:

npm_config_yes=true npx @cside.dev/cli@latest

A little breakdown of what this command means:

• npx – Executes the CLI tool without requiring a global install.
• @cside.dev/cli@latest – Ensures you're using the most up-to-date version.
• npm_config_yes=true– Suppresses the installation confirmation prompt, making it CI-friendly.

Available Options

To see a list of available options, simply run:

npx @cside.dev/cli --help

which will return all the available options:

Usage: @cside.dev/cli [options]

Options:
      --version  Show version number                                   [boolean]
  -d, -f, --dir  Directory which include html files to process. By default we'll
                 try to look for a `.next` and `dist` folder. Also a single file
                 can be used.                                           [string]
  -s, --silent   Disable outputting processed html files.
                                                      [boolean] [default: false]
  -t, --team, --team-id
                 Inject a team-scoped cside script host using the provided team
                 ID.                                                     [string]
      --fingerprint
                 Inject cside fingerprint hosts on csidefd.com instead of the
                 default csidetm.com domain.
                                                      [boolean] [default: false]
  -h, --help     Show help                                             [boolean]

Team-Scoped Injection

To inject a team-scoped script host, pass a team ID with --team-id:

npx @cside.dev/cli@latest --team-id 345678765434567890

To switch the injected domain from csidetm.com to csidefd.com, add --fingerprint:

npx @cside.dev/cli@latest --fingerprint

Or combine it with a team-scoped host:

npx @cside.dev/cli@latest --team-id 345678765434567890 --fingerprint