microsoft / microsoft/vscode-azurestaticwebapps
"Create Static Web App..." command and icon is confusing for users
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 99
- Forks
- 39
- Avg merge
- 3d 7h
- Merged PRs (30d)
- 2
Description

In multiple user studies we've observed that users are don't understand what this button and the "Create Static Web App..." command does.
- Users have a local static web app in their workspace, and are ready to deploy it to Azure.
- Users see this button and hover over it, but they think that it means to create a new static web app locally, e.g. to scaffold out a basic React, Angular, etc. app
- They end up not clicking it and get stuck on how to deploy
- Some users did come back to it after reading the docs
I think the best thing would be to change the icon and command name to this:
Only downside about making this change is a lot of docs, images, and probably learn modules would suddenly become outdated... We'll have to gauge the priority on this change with that in mind I guess.
cc: @simonaco
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by locating the extension's contribution for the "Create Static Web App..." command and its icon, then review the linked screenshots and proposed wording. Identify documentation, images, and learn modules that reference the current command or icon; done means the UI is clearer and those references are updated or their impact is explicitly accounted for.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure, typescript, vscode
- Domain
- design, developer-experience, tooling
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 30/100