v1.0.0 - General Availability 🎉

Documentation

• docs: add official SWA CLI docs website (#460) d51b72f
• docs: add API language runtime version instruction 9c7db82
• docs: add build step for swa deploy 29a23ef
• docs: add instruction how to create a SWA instance e7dd681
• docs: add local auth 81d4e2b
• docs: update env variables 7731464
• docs: fix docs deploy 3435404
• docs: fix npx example 3d5b6c1
• docs: fix option description 0c93433
• docs: removes preview mentions 9aa4a5b
• docs: rename env vars files e142136
• docs: update announcement bar color a48e037
• docs: update blazor docs a959c51
• docs: update CLI options documentation f568df4
• docs: update command help 88cca56
• docs: update contributions guidelines f69d850
• docs: update docs styling + add logo + build hash 140dbaa
• docs: update swa logo color palette d0d8694

Features

• feat(start): set a random port if --port is already taken 1810590
• feat(login): add --clear-credentials a602988
• feat(deploy): add --dry-run mode 2000ef9
• feat(login): add custom persistence cache options 34b70d2
• feat(login): add encryption when persisting tokens (wip) 8694b4d
• feat(start): add env vars support for dev server options 1227d0a
• feat(init): add init command 941ef19
• feat(login): add swa login f205ed6
• feat(core): add runtime node version check 89e292c
• feat(deploy): add support for deployment environments a509c89
• feat(core): add support for dotenv 0147f80
• feat(build): add swa build command (closes #380) 4c3150b
• feat(swa): add swa command 615562e
• feat(deploy): add swa deploy 23d8a5c
• feat(docs): add swa docs be48e69
• feat(init): allow overriding config file with CLI flags (closes #419) (#420) e8ab4ae
• feat(core): implement frameword detection 4c82eab
• feat(login): add encryption logic e088622
• feat(core): improve staticwebapp.config.json validation 8a5041c
• feat(deploy): introduce SWA_CLI_DEPLOY_BINARY_VERSION d792805
• feat(core): provide complete devcontainer with support for e2e tests (#426) c69726a
• feat(start): support self-generating ssl certificates (#441) 4fcb87f
• feat(core): support Azure env variables d1b8b80
• feat(deploy): support swa deploy c7f6dc8
• feat(core): validate staticwebapp.config.json 8ef826d
• feat(cli): add option alias flags f5464db
• feat(deploy): support printing deployment token bf7e511
• feat(deploy): support project creation if none found 7a1a3fc
• feat(detect): add more frameworks and fix some a87ec63
• feat(init): add proper config generation 8eb93a6
• feat(login): add support for service principal and env variables 91be123

Fixes

• fix(core): make positional arguments explicit c01e512
• fix(core): add missing --output-location flag 185da83
• fix(core): add missing githubActionWorkflowLocation type f03d1ed
• fix(core): allow overriding config file with cli flags (closes #419) f06d70c
• fix(core): avoid blocking tests f726d0b
• fix(core): check staticwebapp.config.json max filesize c93a125
• fix(login): check X11 config only on WSL 5636307
• fix(core): clean outputLocation detection logic 548139d
• fix(core): cli default context comparison and unwanted warning d210568
• fix(core): colors and duplicate message in command passthrough c40d6a4
• fix(core): default paths 538d57a
• fix(core): default positional argument overriding config options c29ee6d
• fix(deploy): deploy print-token even if app has provider (#480) f27f68e
• fix(deploy): deployment paths 6f6e1d0
• fix(deploy): detect if project has an existing provider c2ed6f3
• fix(init): detection with some frameworks when run at root path 17b5426
• fix(core): downgrade deps to avoid breaking changes cc1c403
• fix(deploy): emphasize warning message if dry-run is used 6b650a7
• fix(init): flutter detection 3e6403b
• fix(core): fs/promises loading with Node 12 dfcfc90
• fix(deploy): handle errors in dry-run mode a2985f1
• fix(core): hide sensitive values from logger c4c0e56
• fix(start): allow query params logic when connecting to a dev server (#430) 46de071
• fix(start): improve query params logic when connecting to a dev server d5b171b
• fix(core): log display inconsistencies ec26381
• fix(core): log when verbose is not set 47529c3
• fix(deploy): make --api-location optional on depoy 8bb82c3
• fix(core): make apiLocation independant of appLocation 5fb4ab0
• fix(deploy): missing --app-location option on swa deploy 108b2fd
• fix(start): missing global options in start command a8a5943
• fix(core): move the runtime config file under appLocation (#471) 372f57d
• fix(start): multiple config issues (#434) 140f2d2
• fix(init): outputLocation from config d3dfeb2
• fix(init): package.json search with path ending with / 9f18bf6
• fix(core): positional arg default value overriding user options c7ed571
• fix(start): prevent browser from opening on react dev server 1819306
• fix(core): printing undefined values bf6a99f
• fix(login): properly log in into specified tenant 012a67d
• fix(deploy): remove --output-location from swa deploy 8d6549b
• fix(core): remove unused templates 538a571
• fix(start): resolve config flags to absolute paths 3bc508d
• fix(core): stuck progress bar 1236f81
• fix(login): stuck with corrupted credentials ae1f1ae
  e99785f)
• fix(core): swa config file path not properly handled with start/deploy a3a84fc
• fix(start): swa start not waiting for ports to be available cc98c8f
• fix(start): swa start startup command path bd1eb00
• fix(swa): swa version display c782a43
• fix(core): swaCliConfigLocation should not be in DEFAULT_CONFIG bb055df
• fix(start): try to use correct path for swa start run commands ee4d627
• fix(swa): uncaught promise in swa command d8bd344
• fix(core): unwanted warning acdcc42
• fix(deploy): update deploy manifest signature ee16481
• fix(core): update jest snapshots 421b40c
• fix(deploy): use .exe binary on windows 6634e5a
• fix(deploy): use buildId when fetching deploy binary d3aa2f0
• fix(core): use config root folder when a config is loaded (closes #409) (#413) f529cc8
• fix(docs): use dotnet publish instead of dotnet build 866035a
• fix(docs): use GIT_PASS to deploy docs to GH dd5d7aa
• fix(init): use project name argument 5b56785
• fix(core): verbose flag value when prefix is omitted 07467ed
• fix(deploy): warn only if StaticSiteClient is outdated d6f436a
• fix(login): X11 should be availble if accessing keychain 95227b7
• fix(build): use app folder instead of output 23da346
• fix(cli): config loading and relative paths 8b66b31
• fix(deploy): don't call login during dry-run 198bc52
• fix(deploy): print actual api fodlder being deployed 1c8ecfb
• fix(detect): api path computation bbb128b
• fix(detect): filter out lonely childs 2c504d9
• fix(detect): windows path not matched 84817dc
• fix(init): outputLocation path generation 205481d
• fix(login): filter SWAs by resource group 3008f8e
• fix(start): add isHttpUrl check for start context ca994cd
• fix(start): kill CLI if subcommands crashed 176418d
• fix(start): resolve swa config location path correctly db6a7f7
• fix(start): use correct appLocation for user config 2a51504

Breaking changes

--devserver-timeout

Flag --devserver-timeout now accepts seconds instead of ms.

Before:

--devserver-timeout=5000

After:

--devserver-timeout=5

Validating staticwebapp.config.json

If your project contains a staticwebapp.config.json, this file will now be validated against the official schema. If the file contains is not valid or has errors, it will not be processed by the SWA CLI.

Dropping support for Node.js 12

The SWA CLI does not support Node.js v12 anymore. Please upgrade to Node v14 or LTS

New swa-cli.config.json format

We've introduced a new format for swa-cli.config.json. We recommend backing up or deleting your old configuration file, and run swa init to generate a new one.

New Contributors 🎉

• @Devansu-Yadav
• @GeekTrainer
• @nitya
• @sinedied