apps-devkit-commit-tracker-web-app-foundation.md

apps-devkit-commit-tracker-web-app-foundation

Scope

• Project/component: commit-tracker web mini app scaffold contract
• Canonical path: apps/devkit/src/apps/commit-tracker

Runtime and Language

• Runtime: Next.js mini app module
• Primary language: TypeScript

Users and Operators

• Developers navigating reserved Devkit mini app routes
• Maintainers controlling rollout sequencing for commit-tracker features

Interfaces and Contracts

• Stable mini app identifier: commit-tracker.
• Route contract: /apps/commit-tracker.
• Page contract: renders the CommitTrackerApp component with repo selector, metric series chart, and PR comparison table.

Storage

• No feature-specific persistence in scaffold mode.

Security

• Placeholder rendering must not expose secrets or backend credentials.

Logging

• Route render diagnostics should remain available through shared Devkit shell logging.

Build and Test

• Local validation: pnpm --filter devkit... test
• Build validation: pnpm --filter devkit... build

Dependencies and Integrations

• Integrates with Devkit host routing and mini app registration contracts.
• Does not depend on active commit-tracker API or collector components in scaffold mode.

Change Triggers

• Update docs/project-devkit-commit-tracker.md and this file for route, status, or placeholder behavior changes.
• Synchronize host-level registration behavior with docs/apps-devkit-foundation.md.

References

• docs/project-devkit-commit-tracker.md
• docs/apps-devkit-foundation.md
• docs/domain-template.md