1
Conventions
Jonathan Miller edited this page 2026-07-20 12:35:40 +00:00

Conventions

Ecosystem-wide conventions for MokoGIT and the repositories it hosts. MokoGIT is a standalone hard-fork of Gitea (see lineage/attribution below); these conventions describe the MokoGIT product and its Moko-standard repo layout, not upstream defaults.

Product Identity

Item Value
Product MokoGIT (do not call it "Gitea" except when describing upstream lineage)
Version 01.00.00
Nature Standalone hard-fork of Gitea (disconnected)
Forge URL https://git.mokoconsulting.tech

License Posture

  • The combined work is GPL-3.0-or-later.
  • The MIT license is retained for the Gitea/Gogs-derived base (Option B: GPL over an MIT-licensed foundation).
  • Legally-required attribution — the original MIT / Gitea Authors / Gogs copyright notices — is preserved unchanged. References to MokoGIT being a "derivative of Gitea" are intentional lineage statements and are kept.

Binary, Data, and Config

Item Value
Binary name mokogit
Data directory /data/mokogit
Config directory /etc/mokogit
Env override prefix MOKOGIT__
Token env var MOKOGIT_TOKEN

Hard cutover: the legacy GITEA__ environment-override prefix and the GITEA_TOKEN variable have been removed. Use MOKOGIT__ and MOKOGIT_TOKEN exclusively — there is no GITEA__ fallback.

Example env override:

MOKOGIT__server__ROOT_URL=https://git.mokoconsulting.tech/
MOKOGIT_TOKEN=<api-token>

Repository Layout

Conventions for repositories managed on this forge:

Item Convention
Repo tooling Lives under .mokogit/ (the former .mokogitea/ tree has been removed)
Source layout source/not src/
Build output No dist/ directory; the MokoGIT release system packages release artifacts from source/ server-side
Versioning Dual-format: Moko XX.YY.ZZ (zero-padded) plus npm semver where applicable

Metadata & Platform Registry

  • Per-repo metadata is API-only via GET/PUT /api/v1/repos/{owner}/{repo}/metadata (the old /manifest route was removed). See Metadata API and Metadata Settings.
  • Platform values are keyed to the platform registry (GET /api/v1/platforms): joomla, dolibarr, go, npm, mcp, generic.
  • Feedless platforms (npm, mcp, go) return N/A from update feeds.

Lineage / Attribution (do not remove)

MokoGIT is a hard-fork of Gitea, which is itself derived from Gogs. The upstream MIT license and the "Gitea Authors" / "Gogs Authors" copyright notices are retained in the source tree as required. This section documents lineage; it is not product branding.


Authored by Jonathan Miller (@jmiller)