create-powerapp 1.0.0

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: Bug report
+about: Something didn't work as expected
+title: "[Bug] "
+labels: bug
+assignees: ''
+---
+
+## What happened?
+
+<!-- Describe what went wrong. What did you expect to happen instead? -->
+
+## Steps to reproduce
+
+1. Ran `npx create-powerapp`
+2. Selected app type: <!-- Canvas App / Model-Driven App / PCF / Power Pages / Code App -->
+3. Selected AI assistant: <!-- GitHub Copilot / Claude Code -->
+4. ...
+
+## Error message
+
+<!-- Paste the full error output here -->
+```
+paste error here
+```
+
+## Environment
+
+- **OS:** <!-- Windows 11 / macOS 14 / Ubuntu 22.04 -->
+- **Node.js version:** <!-- run: node --version -->
+- **npm version:** <!-- run: npm --version -->
+- **PAC CLI version:** <!-- run: pac --version -->
+
+## Additional context
+
+<!-- Anything else that might help — screenshots, partial output, etc. -->

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest an improvement or new app type
+title: "[Feature] "
+labels: enhancement
+assignees: ''
+---
+
+## What would you like?
+
+<!-- Describe the feature clearly. What should it do? -->
+
+## Why would this be useful?
+
+<!-- Who benefits and how? -->
+
+## What app type does this relate to?
+
+<!-- Canvas App / Model-Driven App / PCF / Power Pages / Code App / All / New type -->
+
+## Any ideas on how to implement it?
+
+<!-- Optional — rough ideas, links to docs, examples -->

package/.github/workflows/ci.yml

@@ -0,0 +1,103 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Smoke test — scaffold all app types
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        node-version: [18, 20, 22]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Verify Node and npm versions
+        run: |
+          node --version
+          npm --version
+
+      - name: Scaffold Canvas App (Copilot)
+        run: |
+          printf 'test-canvas\n1\n1\n\n' | node index.js
+        shell: bash
+
+      - name: Check Canvas App files exist
+        run: |
+          test -f test-canvas/.gitignore
+          test -f test-canvas/.env
+          test -f test-canvas/README.md
+          test -f test-canvas/instructions/canvas-instructions.md
+          test -f test-canvas/prompts/starter.md
+          test -f test-canvas/.github/copilot-instructions.md
+          test -d test-canvas/canvas-src/Src
+          test -d test-canvas/canvas-src/Assets
+        shell: bash
+
+      - name: Scaffold Model-Driven App (Claude Code)
+        run: |
+          printf 'test-mda\n2\n2\n\n' | node index.js
+        shell: bash
+
+      - name: Check MDA files exist
+        run: |
+          test -f test-mda/.gitignore
+          test -f test-mda/CLAUDE.md
+          test -f test-mda/instructions/mda-instructions.md
+          test -f test-mda/prompts/starter.md
+        shell: bash
+
+      - name: Scaffold PCF Component
+        run: |
+          printf 'test-pcf\n3\n1\n\n' | node index.js
+        shell: bash
+
+      - name: Scaffold Power Pages
+        run: |
+          printf 'test-pages\n4\n2\n\n' | node index.js
+        shell: bash
+
+      - name: Check Power Pages folder structure
+        run: |
+          test -d test-pages/site/web-files
+          test -d test-pages/site/web-pages
+          test -d test-pages/site/web-templates
+        shell: bash
+
+      - name: Scaffold Code App
+        run: |
+          printf 'test-codeapp\n5\n1\n\n' | node index.js
+        shell: bash
+
+      - name: Check Code App files exist
+        run: |
+          test -f test-codeapp/package.json
+          test -f test-codeapp/tsconfig.json
+          test -f test-codeapp/src/App.tsx
+          node -e "JSON.parse(require('fs').readFileSync('test-codeapp/package.json','utf8'))"
+        shell: bash
+
+  lint:
+    name: Check syntax
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Check index.js parses without errors
+        run: node --check index.js
+      - name: Check package.json is valid JSON
+        run: node -e "JSON.parse(require('fs').readFileSync('package.json','utf8')); console.log('package.json OK')"

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to `create-powerapp` will be documented here.
+
+Format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+Version numbers follow [Semantic Versioning](https://semver.org/) — `MAJOR.MINOR.PATCH`.
+
+---
+
+## [1.0.0] — 2026-05-28
+
+### Added
+- Interactive CLI with four questions: project name, app type, AI assistant, environment URL
+- Scaffold support for five Power Apps types: Canvas App, Model-Driven App, PCF Component, Power Pages, Code App
+- Auto-generated `.gitignore`, `.env`, `README.md` for every project
+- `instructions/` folder with AI context files tailored to each app type
+- `prompts/starter.md` with copy-paste first prompts for each app type
+- `CLAUDE.md` generation for Claude Code users
+- `.github/copilot-instructions.md` generation for GitHub Copilot users
+- Automatic `git init` and first commit
+- Automatic `pac auth create` when environment URL is provided
+- Automatic `code .` to open VS Code after scaffolding
+- `package.json` and `tsconfig.json` for Code App projects
+- Full VS Code setup guide in `docs/setup-guide.md`
+- GitHub Actions CI workflow
+- MIT licence

package/CONTRIBUTING.md

@@ -0,0 +1,130 @@
+# Contributing to create-powerapp
+
+Thank you for wanting to help! This project is designed to be easy to contribute to — even if you are new to open-source.
+
+---
+
+## Ways to contribute
+
+- **Fix a bug** — something doesn't work as described? Open an issue or a pull request
+- **Improve a template** — the scaffolded files for a specific app type could be better
+- **Improve the docs** — the setup guide or README could be clearer for beginners
+- **Add a new app type** — want to support a new Power Platform project type?
+- **Add starter prompts** — better copy-paste first prompts for each app type
+
+---
+
+## Getting started
+
+### 1. Fork and clone the repo
+
+```bash
+# Fork the repo on GitHub (click Fork at the top right), then:
+git clone https://github.com/YOUR-USERNAME/create-powerapp.git
+cd create-powerapp
+```
+
+### 2. Make sure Node.js 18+ is installed
+
+```bash
+node --version   # should print v18 or higher
+```
+
+No other dependencies are needed — this tool uses only Node.js built-ins.
+
+### 3. Test your changes locally
+
+```bash
+# Run the CLI directly from your local clone
+node index.js
+```
+
+Answer the questions as a user would. Check that the files created in the output folder look correct.
+
+### 4. Create a branch
+
+```bash
+git checkout -b fix/canvas-gitignore
+# or
+git checkout -b feat/add-power-automate-template
+```
+
+Use a descriptive branch name that explains what you changed.
+
+### 5. Make your changes
+
+The entire tool lives in `index.js`. It is structured in clearly labelled sections:
+
+```
+// ─── Colour helpers ──────────────────────────────────────────────────────────
+// ─── readline helper ─────────────────────────────────────────────────────────
+// ─── run shell command ────────────────────────────────────────────────────────
+// ─── shared file content ──────────────────────────────────────────────────────
+// ─── App-type scaffolders ─────────────────────────────────────────────────────
+//     scaffoldCanvas()
+//     scaffoldMDA()
+//     scaffoldPCF()
+//     scaffoldPowerPages()
+//     scaffoldCodeApp()
+// ─── AI context file writer ───────────────────────────────────────────────────
+// ─── Main ─────────────────────────────────────────────────────────────────────
+```
+
+To **add a new app type**, you need to:
+1. Add a new `scaffold<AppType>()` function in the "App-type scaffolders" section
+2. Add an entry to the `choose()` call in `main()` under "App type"
+3. Add a `case` for it in the `switch` statement in `main()`
+4. Update `README.md` to document the new app type
+
+To **improve a template** (e.g. better AI instructions for Canvas Apps), find the relevant `scaffold*()` function and edit the file content strings inside it.
+
+To **improve the docs**, edit `docs/setup-guide.md`.
+
+### 6. Commit and push
+
+```bash
+git add .
+git commit -m "fix: improve canvas app gitignore to exclude .msapp files"
+git push origin your-branch-name
+```
+
+**Commit message format** — please use one of these prefixes so the changelog is easy to read:
+
+| Prefix | Use for |
+|---|---|
+| `feat:` | A new feature or app type |
+| `fix:` | A bug fix |
+| `docs:` | Documentation changes only |
+| `chore:` | Maintenance (version bumps, CI tweaks) |
+| `refactor:` | Code restructuring with no behaviour change |
+
+### 7. Open a pull request
+
+Go to GitHub, open a pull request from your branch to `main`. Describe:
+- What you changed
+- Why you changed it
+- How you tested it (which app types did you scaffold and check?)
+
+---
+
+## Code style
+
+- This tool intentionally uses **zero external dependencies** — only Node.js built-ins (`fs`, `path`, `readline`, `child_process`). Please do not add npm dependencies.
+- Keep the file content strings in each `scaffold*()` function **readable and well-commented** — these are the files beginners will see first.
+- Add a plain-English comment above any logic that isn't immediately obvious.
+
+---
+
+## Reporting bugs
+
+Open an issue using the **Bug report** template. Include:
+- Your OS (Windows / macOS / Linux)
+- Node.js version (`node --version`)
+- Which app type you selected
+- The full error message or unexpected output
+
+---
+
+## Questions
+
+Open an issue with the **Question** label or start a GitHub Discussion. There are no stupid questions.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 create-powerapp contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+# create-powerapp ⚡
+
+> One command to scaffold any Power Apps project — ready to vibe-code with GitHub Copilot or Claude Code.
+
+```bash
+npx create-powerapp
+```
+
+No config files to write. No folder structure to figure out. Just answer four questions and your project is ready to open in VS Code with your AI assistant.
+
+---
+
+## What it does
+
+Running `npx create-powerapp` asks you four questions:
+
+```
+▶ Project name:  employee-leave-app
+
+▶ App type:
+  1. Canvas App        — Design every screen. Best for custom employee tools & mobile apps
+  2. Model-Driven App  — Database-first. Great for CRM / record management
+  3. PCF Component     — A reusable custom control to embed inside other Power Apps
+  4. Power Pages       — A public-facing website connected to Dataverse
+  5. Code App          — A full custom web app (React/TypeScript) on Power Platform
+
+▶ AI assistant:
+  1. GitHub Copilot
+  2. Claude Code
+
+▶ Power Platform environment URL (optional):  https://yourorg.crm.dynamics.com
+```
+
+Then it automatically creates everything in under 10 seconds:
+
+| What gets created | Why |
+|---|---|
+| Project folder with correct structure | Right layout for your app type from day one |
+| `.gitignore` | Passwords and generated files never get uploaded by accident |
+| `.env` | Safe place for your environment URL and secrets |
+| `README.md` | Project overview with useful PAC CLI commands |
+| `instructions/` | AI context files that teach your AI how this app type works |
+| `prompts/starter.md` | Copy-paste first prompts to build your first screens immediately |
+| `CLAUDE.md` or `.github/copilot-instructions.md` | Your AI reads this to understand the project |
+| Git initialised + first commit | Version control ready immediately |
+| `pac auth create` (if URL given) | Signs you into your Power Platform environment |
+| VS Code opened automatically | Jump straight into building |
+
+---
+
+## Prerequisites
+
+You need these installed once on your machine. The [VS Code Setup Guide](docs/setup-guide.md) walks through every step in plain English.
+
+| Tool | What it is | Install |
+|---|---|---|
+| **Node.js 18+** | Required to run this tool | [nodejs.org](https://nodejs.org) → download LTS |
+| **Git** | Version control | [git-scm.com](https://git-scm.com) |
+| **PAC CLI** | Connects to Power Apps | `npm install -g pac` |
+| **VS Code** | Your coding editor | [code.visualstudio.com](https://code.visualstudio.com) |
+| **GitHub Copilot** or **Claude Code** | Your AI assistant | See setup guide |
+
+---
+
+## Quick start
+
+```bash
+# Run directly — no install needed, always uses latest version
+npx create-powerapp
+
+# Or install globally so you can run it anytime
+npm install -g create-powerapp
+create-powerapp
+```
+
+After the command finishes:
+
+1. VS Code opens automatically with your project
+2. Open `prompts/starter.md` — copy-paste prompts for your first screens
+3. Open your AI assistant (Copilot Chat icon, or `claude` in the terminal)
+4. Paste a prompt and start building
+
+---
+
+## Full setup guide
+
+New to VS Code, Power Apps, or vibe coding entirely? Read the full step-by-step guide:
+
+**[📖 VS Code Setup Guide for Vibe Coding](docs/setup-guide.md)**
+
+It covers everything from installing VS Code for the first time to writing your first AI prompt — with plain-English explanations and a glossary of every technical term.
+
+---
+
+## Supported app types
+
+| App type | Best for | Key files created |
+|---|---|---|
+| **Canvas App** | Custom employee tools, mobile apps, branded interfaces | `canvas-src/` (unpacked YAML), instructions, starter prompts |
+| **Model-Driven App** | CRM tools, record management, data-heavy apps | `solutions/` placeholder, MDA instructions, starter prompts |
+| **PCF Component** | Custom interactive controls embedded in other Power Apps | PCF instructions, starter prompts with `pac pcf init` command |
+| **Power Pages** | External customer/partner portals | `site/` folder structure, Power Pages instructions |
+| **Code App** | Full custom React/TypeScript web apps on Power Platform | `src/`, `package.json`, `tsconfig.json`, Code App instructions |
+
+---
+
+## Repository structure
+
+```
+create-powerapp/
+├── index.js              ← CLI entry point (the tool itself)
+├── package.json          ← npm package config
+├── LICENSE               ← MIT licence
+├── README.md             ← This file
+├── CONTRIBUTING.md       ← How to contribute
+├── CHANGELOG.md          ← Version history
+├── docs/
+│   └── setup-guide.md   ← Full beginner VS Code + vibe coding guide
+└── .github/
+    ├── workflows/
+    │   └── ci.yml        ← Automated tests on every pull request
+    └── ISSUE_TEMPLATE/
+        ├── bug_report.md
+        └── feature_request.md
+```
+
+---
+
+## Contributing
+
+Contributions are welcome — whether that's fixing a bug, adding a new app type template, or improving the beginner docs. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+## Licence
+
+MIT — see [LICENSE](LICENSE).