Practitioners
Bring files in
Record the client’s authorization, then upload documents or connect a GitHub repository, read-only.
How-to video coming soon
- For
- Practitioners
- You need
- The client’s authorization to bring its files into your workspace.
- Result
- Each file listed with its source and its hash at arrival.
Steps
On Files, tick that the client authorized you to bring these files in. It is recorded with your role, the time and the client.
To upload, drop files on Files: PDF, Word, Excel, CSV, Markdown, JSON, YAML and notebooks, up to the size limit the Files page shows, each.
To read from GitHub, choose Connect GitHub on Files and install the GovernanceOS app on the repositories you choose, on GitHub’s own page. For an organization’s repositories, its owner approves the app there.
Check the list on Files: each file shows its source, its hash at arrival and where it is used.
To bring in changed files, choose Move to the latest commit on Files. Reading the pinned commit again changes nothing unless a file is missing.
Good to know
- A file here is not evidence yet. It becomes evidence when a named person attaches it to a gate, in the institution’s own tenant.
- The GitHub app reads files only. It can never write, run anything, or see a repository you did not choose.
- Files that look like secrets, such as keys and .env files, are refused: not read and not stored.
- For a client whose profile is residency-bound, first choose what the workspace keeps: names and hashes only, or the files themselves, stored in Canada.
- At handover the files move to the client. As its consultant you keep each file’s name and hash, not the file.
Where in the product
These open the prototype, on fictional institutions. People are shown as roles.

