Modrinth-plus/.codex/project.md

Modrinth Plus

Modrinth Plus is a fork of the official Modrinth monorepo focused on the desktop app. Its first custom feature is Connected Library: public Git-hosted modpack manifests that can install and update exported .mrpack releases.

Stack

• Monorepo package manager: pnpm
• Desktop app frontend: Vue
• Desktop app shell: Tauri
• Core app logic: Rust crate theseus in packages/app-lib
• Local app storage: SQLite migrations in packages/app-lib/migrations
• CI target: Gitea Actions runner

Connected Library Defaults

• Supports public HTTPS raw manifest URLs and GitHub/GitLab/Gitea repo URLs.
• Manifest filename is modrinth-plus.json.
• Auto-update is disabled by default and can be enabled per connected pack.
• Private repository auth, SSH, and token storage are out of scope for v1.

Verification

Use the cheapest relevant checks first:

pnpm install
pnpm --filter @modrinth/app-frontend run lint
cargo fmt --check
cargo clippy --package theseus

Full app packaging may require platform-specific Tauri dependencies.

Kit Application Notes

• AGENTS.md intentionally preserves the upstream CLAUDE.md handoff while adding Modrinth Plus and Gitea workflow-loop rules.
• README blueprint generation is not enabled because the upstream Modrinth README should remain authoritative.
• Release dry-run automation is deferred until desktop packaging commands and artifact names are finalized.
• Template compliance is enabled on push to keep Codex context files present and placeholder-free.