Skip to content

Repository documents

The complete list of important project documents: policies, license, technical and process documents.

DocumentContents
PRIVACY.mdLocal data, optional telemetry (disabled by default), third-party services, contact for privacy requests.
SECURITY.mdPrivate vulnerability reporting, security scope, threat model, credential storage, supported versions.
CODE_SIGNING_POLICY.mdCurrent Windows signing status, release provenance, and artifact verification.

The same policies in a readable form: Privacy, Security, Code signing.

DocumentContents
LICENSEGNU GPL v3.0: you may use, study, modify, and redistribute under the terms of GPLv3.
NOTICECopyright (© 2026 AmadoMuerte), redistribution obligations, third-party component notices (go-keyring, dbus, wincred — MIT/permissive).
DocumentContents
README.mdProject overview, features, download, first steps, building from source. Russian version: docs/README.ru.md.
AGENTS.mdProject rules for agents and contributors: workflow, layer structure, data safety, branching (main/dev), PR requirements.
DocumentContents
authentication.mdVintage Story authentication protocol, network boundary, session storage, transactions, legacy-secret migration, launch credential lifetime.
game-versions.mdThe official version feed, platform selection, installation pipeline, MD5/SHA-256, known boundaries.
modpack.mdThe mod update analysis library: Catalog contract, statuses, candidate selection, compatibility, dependencies.
operations-page.mdOperations page contract: statuses, cancellation as rollback, history deletion, required regression tests.
windows-updater.mdWindows auto-update architecture: SHA256SUMS vs Authenticode, trust model, and installation modes.
DocumentContents
CONTRIBUTING.mdEnvironment setup, required checks before a PR, localization, architecture expectations, commit workflow.

A developer summary is on the Development page.