apps-devkit-remote-file-picker-foundation.md

apps-devkit-remote-file-picker-foundation

Scope

• Project/component: remote-file-picker web mini app scaffold contract
• Canonical path: apps/devkit/src/apps/remote-file-picker

Runtime and Language

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

Users and Operators

• Developers navigating reserved Devkit mini app routes
• Maintainers sequencing remote-file-picker feature rollout

Interfaces and Contracts

• Stable mini app identifier: remote-file-picker.
• Route contract: /apps/remote-file-picker.
• Page contract: renders the RemoteFilePickerApp component with file input (drag-and-drop + camera), upload progress, and result view with public URL.

Storage

• No feature-specific persistence in scaffold mode.

Security

• Placeholder rendering must not expose signed URL data, callback tokens, or 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 upload orchestration or remote-source adapters in scaffold mode.

Change Triggers

• Update docs/project-devkit-remote-file-picker.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-remote-file-picker.md
• docs/apps-devkit-foundation.md
• docs/domain-template.md