Power Platform Swiss Army Knife

Start Here

Choose your starting point based on what you want to accomplish:

1. 🚀 Run the Dockerized Web App

Launch the Power Fx code generation platform:

cd apps/power-platform-power && docker-compose up -d

Access at: http://localhost:53001 (see DOCKER-QUICK-START.md)

2. 📦 MSAPP Download & Extract Workflow

Download and extract all Power Apps from your tenant:

./pipelines/msapp/scripts/workflow-menu.sh

See QUICK-START-WORKFLOWS.md for details.

3. 🤖 Python Orchestrator CLI

Use the AI orchestration service for task delegation:

cd apps/src && python -m orchestrator --help

See specs/002-ai-orchestration/quickstart.md

4. 📚 Power Fx Snippets Library

Browse code examples and best practices: Open knowledge/PowerFxSnippets/ in your editor.

🚀 Quick Start - Docker Setup

Run the complete development environment with one command:

cd apps/power-platform-power
docker-compose up -d

Access Points (randomly assigned ports 50000-60000):

• Web UI: http://localhost:53001
• API Server: http://localhost:53002
• API Docs: http://localhost:53002/docs
• Email Testing: http://localhost:53006 (Mailhog)
• PostgreSQL: localhost:53003
• Redis: localhost:53004

📖 Setup Guides:

• DOCKER-QUICK-START.md - Get running in 5 minutes
• DOCKER-SETUP.md - Comprehensive setup and troubleshooting
• AGENTS.md - Repository guidelines for contributors

---

📋 Spec-Driven Development with Spec Kit

This repository uses GitHub's Spec Kit to enable spec-driven development workflows. Spec Kit allows AI agents (Claude, Gemini, Qwen, and others) to work from executable specifications, ensuring consistent and high-quality development across all projects.

Available Slash Commands

• /speckit.constitution - View and edit project principles and standards
• /speckit.specify - Create new feature specifications from templates
• /speckit.plan - Generate detailed implementation plans
• /speckit.tasks - Break down specifications into actionable tasks
• /speckit.implement - Execute implementation tasks with AI assistance
• /speckit.analyze - Analyze specifications for ambiguities and gaps

Key Directories

• .specify/ - Spec Kit templates, constitution, and helper scripts
• specs/ - Completed specifications (002-ai-orchestration, 003-msapp-pac-extract)

Integration Status

Spec Kit is already in use in subprojects like PowerFxSnippets and msapp-bulk-download. See AGENTS.md for repository guidelines and contribution workflow.

Typical Workflow

1. Define or update the project constitution with /speckit.constitution
2. Capture new feature requirements with /speckit.specify
3. Generate implementation plans using /speckit.plan
4. Break work into actionable items with /speckit.tasks
5. Implement changes with /speckit.implement and document AI interactions under ai-chats/

---

AI Orchestration System

Multi-agent AI orchestration system for task delegation and workflow automation. Routes coding tasks to appropriate AI agents (Gemini CLI, Qwen CLI, custom APIs) and coordinates complex multi-step workflows.

Quick Start

For detailed setup instructions, see: specs/002-ai-orchestration/quickstart.md

Documentation

• Feature Specification: specs/002-ai-orchestration/spec.md
• Implementation Plan: specs/002-ai-orchestration/plan.md
• Data Model: specs/002-ai-orchestration/data-model.md
• CLI Interface: specs/002-ai-orchestration/contracts/cli-interface.md

Status

Phase 1: Setup (Complete) - Project structure and configuration established. Phase 2: Foundational Infrastructure (Next)

---

Overview

This unified repository consolidates multiple Power Platform development tools, frameworks, and resources into a comprehensive "Swiss Army knife" for Microsoft Power Platform development. Each subfolder represents a specialized tool or framework designed to accelerate Canvas Apps, Power Automate, and Power Fx development.

Repository Structure

🏗️ Core Development Frameworks

JumpStart-Kit

MSAPP Editing Framework

• Purpose: Extract and edit Power Apps .msapp files as YAML source code
• Key Features:
  • PowerShell scripts for MSAPP extraction/compression
  • Workflow automation for iterative development
  • Integration with JSON Crack for visualization
  • Prettier code formatting support
• Credits: Based on Bulb Digital's original work and @iammancat contributions

MSAPP-PAC-Extract

Advanced MSAPP Downloader & Extractor

• Purpose: Interactive PowerShell tool for downloading and extracting Canvas Apps
• Key Features:
  • Interactive authentication management (Interactive/Service Principal)
  • Environment selection and management
  • Batch download capabilities (single app or all apps)
  • Automatic extraction after download
  • Configuration persistence between sessions
  • Bug fixes for PAC CLI parsing issues
• Prerequisites: .NET SDK 8.0, PAC CLI, PowerShell Core 7.5.2

PAC-CLI-CheatSheet

PAC CLI Command Reference

• Purpose: Essential commands for Power Platform CLI operations
• Key Features:
  • Authentication profile management
  • Canvas app download/extract/pack operations
  • Source control operations
  • Power Fx REPL functionality

🤖 AI-Enhanced Development Tools

power-fx-helper

AI-Enhanced Power Platform Development Framework

• Purpose: AI-first development framework for Canvas Apps with Power Fx and YAML
• Key Features:
  • Natural language to Power Fx formula generation
  • AI-powered delegation and performance optimization
  • Multimodal AI processing (image, text, voice)
  • Autonomous Copilot Studio agent integration
  • Complete YAML screen templates
  • Problem-solution library for common Power Fx challenges
• Tech Stack: Claude Code, AI Builder, Copilot Studio, Power Fx, Canvas Apps YAML

power-platform-power

Monorepo Power Fx Code Generation Platform

• Purpose: Docker-based monorepo for Power Fx/YAML code generation
• Key Features:
  • React frontend with Postgres + Prisma backend
  • Docker Compose multi-service architecture
  • AI chat documentation system
  • Template-based code generation with token replacement
  • PAC CLI integration for advanced features
• Requirements:
  • Docker containerization
  • React + TypeScript frontend
  • Postgres database with Prisma ORM
  • PAC CLI integration

📚 Learning & Reference Resources

Power-Fx-Coding

Project Template with Documentation Framework

• Purpose: Template repository with structured documentation and AI chat tracking
• Key Features:
  • Consistent project structure template
  • AI chat documentation protocol
  • Git automation scripts
  • Developer onboarding guidance

PowerFx-Coding

Power Fx Learning Repository

• Purpose: Introduction to Power Platform development
• Resources: Microsoft Learning paths and documentation links

PowerFxSnippets

Comprehensive Power Fx Code Library

• Purpose: Curated collection of Power Fx snippets, patterns, and best practices
• Categories:
  • App Formulas (delegation, error handling, UDTs)
  • Controls (galleries, forms, charts, dialogs)
  • Connectors (Office 365, custom APIs)
  • Algorithms (mass updates, data processing)
  • Best Practices (accessibility, performance)
  • Certification prep (PL-200, PL-900)
  • Design patterns and theming
• Community: Power Platform crash course and support resources

spl-accelerator-lifetime

Power Performance Accelerator Program

• Purpose: Public-facing repository for high-ticket coaching/mentoring program
• Features: Program information and organizational overview

🔄 Automation & Workflow Tools

power-automate

Power Automate Development Resources

• Purpose: Repository for Power Automate development assets
• Status: Currently minimal, planned for expansion

Requirements & Prerequisites

System Requirements

• Operating System: Linux/macOS/Windows
• PowerShell Core: 7.5.2+ (for MSAPP tools)
• .NET SDK: 8.0+ (for PAC CLI)
• PAC CLI: Latest version from Microsoft
• Docker: For containerized development
• Node.js: For web development components

Power Platform Requirements

• Power Apps License: Canvas Apps development
• Power Automate License: Flow development
• AI Builder Credits: For AI-enhanced features
• Environment Access: Development/Test/Production environments

Development Tools

• VS Code: With Power Platform Tools extension
• Git: Version control
• Claude Code: For AI-enhanced development
• Prettier: Code formatting

Installation & Setup

Quick Start

1. Clone the repository:

   git clone [repository-url]
   cd power-platform
   

2. Set up PAC CLI (for MSAPP tools):

   # Install PAC CLI
   dotnet tool install --global Microsoft.PowerApps.CLI.Tool
   
   # Verify installation
   pac help
   

3. Configure Docker environment (for power-platform-power):

   cd power-platform-power
   docker-compose up -d
   

4. Launch AI-enhanced development (for power-fx-helper):

   cd power-fx-helper
   claude ide . --allowedTools "all" --dangerously-skip-permissions
   

Key Features Across All Repositories

🔧 Development Tools

• MSAPP Extraction/Compression: Edit Power Apps as source code
• Batch Download: Automated app downloading from environments
• Source Control Integration: Git workflows for Power Apps
• Code Generation: AI-powered formula and YAML generation
• Template Systems: Reusable component libraries

🤖 AI Integration

• Natural Language Processing: Convert requirements to code
• Intelligent Code Completion: Context-aware suggestions
• Performance Optimization: AI-powered delegation strategies
• Multimodal Processing: Image/text/voice AI capabilities
• Autonomous Agents: Copilot Studio integration

📚 Learning Resources

• Code Snippets Library: 500+ Power Fx examples
• Best Practices: Performance, accessibility, security
• Certification Prep: PL-200, PL-900 study materials
• Documentation Framework: Structured AI chat tracking
• Community Resources: Courses, support, forums

🔄 Automation Features

• Workflow Automation: PowerShell scripts for common tasks
• Batch Processing: Bulk operations on apps and data
• CI/CD Integration: Automated deployment pipelines
• Configuration Management: Persistent settings and profiles
• Error Handling: Robust error recovery and logging

Roadmap & Future Development

Immediate Priorities

• Monorepo Integration: Unified development experience across all tools
• Web Interface: Browser-based Power Fx editor and generator
• API Integration: RESTful APIs for all tools
• Testing Framework: Automated testing for Power Fx code
• Documentation Automation: AI-powered documentation generation

Long-term Vision

• Enterprise Integration: SAP, Oracle, custom system connectors
• Advanced AI Features: Predictive analytics, automated refactoring
• Mobile Development: Native app generation from Power Fx
• Multi-platform Support: Web, mobile, desktop from single source
• Collaborative Development: Real-time multi-user editing

Contributing

We welcome contributions! Please:

1. Follow AI Documentation Protocol: Document all AI conversations in ai-chats/ folders
2. Maintain Code Quality: Use Prettier formatting and follow Power Fx best practices
3. Test Thoroughly: Validate across different environments and data volumes
4. Update Documentation: Keep README files current with new features
5. Share Knowledge: Contribute to the Power Fx snippets library

Support & Community

Getting Help

• Documentation: Comprehensive guides in each repository
• Community: Power Platform developer forums
• Support: support@superpowerlabs.co
• Resources: https://powerplatformlinks.com

Learning Resources

• Crash Course: https://tinyurl.com/DarrensStuffPower
• Microsoft Learn: https://learn.microsoft.com/power-platform/
• Power Fx Reference: https://docs.microsoft.com/power-platform/power-fx/
• AI Builder: https://docs.microsoft.com/ai-builder/

License

This project is licensed under the MIT License - see individual repository LICENSE files for details.

Acknowledgments

• Microsoft: Power Platform, Power Fx, PAC CLI
• Bulb Digital: Original MSAPP editing concepts
• @iammancat: Power Apps branding template contributions
• Open Source Community: JSON Crack, Prettier, and other tools
• Power Platform Community: Shared knowledge and best practices

---

Built for the Power Platform community with ❤️ | AI-Enhanced Development Tools