Hub Toolkit Server Context

The Hub Toolkit is a set of server-side command-line utilities used to inspect, export, and document the Members Hub Grav site.

These scripts are not part of normal member-facing website content. They do not need to be copied into every local working site unless a developer specifically needs to test or maintain them.

Their documentation is kept in Site Admin so future administrators understand what the toolkit does and why generated exports or reports may exist.

Server Location

The toolkit is intended to run on the VPS that hosts the live Members Hub.

Item Server path
Grav root /var/www/vhosts/coulsdonclubmembers.info/httpdocs
Scripts directory /var/www/vhosts/coulsdonclubmembers.info/scripts
Export directory /var/www/vhosts/coulsdonclubmembers.info/httpdocs/user/data/chatgpt-export
Pages /var/www/vhosts/coulsdonclubmembers.info/httpdocs/user/pages
Members Hub theme /var/www/vhosts/coulsdonclubmembers.info/httpdocs/user/themes/members-hub
Custom plugins /var/www/vhosts/coulsdonclubmembers.info/httpdocs/user/plugins

Launcher

The command launcher is:

hub

On the server, the launcher calls scripts in:

/var/www/vhosts/coulsdonclubmembers.info/scripts

The launcher exists so an administrator can type short commands such as hub tree or hub export instead of remembering full script paths.

What The Toolkit Is For

The toolkit supports:

  • Inspecting the Grav page tree.
  • Listing page routes without numeric folder prefixes.
  • Searching content and file names.
  • Previewing a page folder and its first Markdown file.
  • Creating a full export bundle for Codex or ChatGPT review.
  • Exporting one page branch for targeted review.
  • Cleaning old export bundles.

What The Toolkit Is Not For

The toolkit is not:

  • A deployment system.
  • A replacement for backups.
  • A member-facing feature.
  • An editing interface for ordinary page publishers.
  • A required part of the local website theme.

Export Behaviour

Toolkit exports are written to:

/var/www/vhosts/coulsdonclubmembers.info/httpdocs/user/data/chatgpt-export

Full exports may include:

  • user/pages
  • user/themes/members-hub
  • selected custom plugins
  • selected configuration files
  • a folder tree report
  • a README for review context

Exports intentionally exclude common noise such as cache, logs, temporary files, generated images, and backup folders where practical.

Operational Principle

Keep the scripts server-side unless there is a specific reason to test them locally.

The important thing for the local Grav site is that Site Admin documents:

  • which commands exist;
  • what they are used for;
  • where generated files appear;
  • what should and should not be copied back to live.

Related Pages

  • Hub Info: concise command reference.
  • Backup and Storage: backup and disaster recovery model.
  • Document Sync and Backup: ClubDocs sync and audit model.
  • Codex Hub Sync: generated report for the live-to-Codex copy process, where present.