Skip to content

ROADMAP.md

Latest commit

 

History

History
71 lines (59 loc) · 5.21 KB

ROADMAP.md

File metadata and controls

71 lines (59 loc) · 5.21 KB
Raw

Amper for VS Code - Roadmap

This document outlines the development plan for the Amper VS Code extension.

🚩 Phase 1: Core Infrastructure (Completed)

  • DDD Architecture: Established domain, application, infrastructure, and presentation layers.
  • Process Executor: Cross-platform wrapper for ./amper and amper.bat.
  • Version Check: Basic command to verify Amper installation.

🚩 Phase 2: Task Integration (Completed)

  • Project Discovery: Automatic detection of Amper projects and module.yaml files.
  • YAML Parsing: Extraction of module types and metadata.
  • Task Provider: Integration with VS Code Task system (Build, Run, Test).

🚩 Phase 3: IDE Experience (Completed)

  • Project Explorer: Custom TreeView in the Activity Bar to visualize project structure.
  • Module Commands: Inline actions in the TreeView (Run, Test, Build).
  • Output Highlighting: Problem matchers for Kotlin compiler errors.
  • Schema Support: JSON Schema for module.yaml to provide IntelliSense.
  • Advanced Task Support: Support for amper show tasks and module-specific task execution.
  • Smart Schema Generation: Rust-based tool (tools/schema-extractor) that automatically extracts JSON Schema from Amper's Kotlin source code. No more manual schema maintenance!

🚩 Phase 4: Advanced Tooling & Migration (The "Power User" Update)

  • Project Initialization Wizard: A user-friendly UI for amper init with template selection.
  • Global Maintenance: Commands for update and clean-shared-caches.
  • Maven Migration Assistant: CodeLens and command integration for amper convert-project.
  • JDK & Toolchain Management: Visual manager for Amper-provisioned JDKs in the Activity Bar.
  • Android Keystore Wizard: UI for generating signing keys (via amper tool keystore).
  • Dynamic Template Discovery: Templates extracted from Amper source code with rich UI display.

🎨 Phase 4.5: UI Polish (The "Quality of Life" Update)

  • Enhanced Welcome View: Rich welcome screen with quick actions when no project is open.
  • Smart Status Bar: Dynamic status bar showing project info and module count.
  • Theme-Aware Branding: Professional custom SVG logo integrated into Activity Bar and Extension icon.
  • Product-Specific Icons: Theme-integrated icons for different module types (Android, iOS, Server, etc.) using ThemeColor.
  • Module Details Panel: Integrated into the Visual Config Editor, providing a high-level overview of module settings.

🚩 Phase 5: Observability & Diagnostics (The "Performance" Update)

  • Build Performance Profiler: Integration with Jaeger UI (via amper tool jaeger) to visualize build traces.
  • Dependency Tree View: Interactive tree view for amper show dependencies with conflict highlighting.
  • Interactive Diagnostic View: Webview-based build reports with structured error parsing and "Explain Error" capabilities.
  • Task Graph Visualization: Interactive view of the task dependency graph using Mermaid.js.

🚩 Phase 6: Extensibility & Mobile (The "Ecosystem" Update)

  • Mobile Device Manager: Native ADB integration with Activity Bar tree view and Status Bar selector.
  • Plugin Discovery: Integrated gallery to browse and add Amper plugins.
  • Module Details Panel: Interactive Webview panel (Visual Config Editor) showing detailed configurations, used platforms, and artifacts.
  • Live Device Logs: Integrated log viewer for connected mobile devices.

🚩 Phase 7: Productivity & Intelligence (The "Smart" Update)

  • Visual Config Editor: A GUI-based editor for module.yaml with real-time validation, tooltips, and support for Android/Kotlin settings.
  • AI Build Assistant: "Explain this Error" feature powered by LLMs, integrating build logs and source code.
  • Migration Wizard: Step-by-step UI to transition projects from Gradle/Maven to Amper.
  • Refactoring Engine: Automatic dependency updates when renaming or moving modules.

🚩 Phase 8: Ecosystem & Scale (The "Community" Update)

  • Amper Hub: Community-driven template and plugin repository integration.
  • CLI Version Manager: Easy switching and auto-updating of the local Amper CLI wrapper.
  • Remote Build Support: Integration with various CI/CD providers for remote task execution.

🚀 Future Optimizations & Polish

  • Drag-and-Drop Operations: Move files between modules to automatically update module.yaml.
  • Performance Dashboard: Real-time stats on build times and success rates across project history.
  • Dependency Search & Filter: Search within the dependency tree to find specific artifacts and filter by conflicts.
  • Version Update Insights: Highlight dependencies that have newer versions available.
  • Conflict Resolution UI: Interactive actions to exclude or force versions in module.yaml.
  • Performance Overlay: Real-time build status and performance metrics in a status bar overlay.
  • Multi-root Optimization: Better handling of complex multi-root workspaces with cross-project dependencies.

Last Updated: December 28, 2025