create-ampless 0.2.0-alpha.3 → 0.2.0-alpha.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -28,6 +28,42 @@ npm run dev # http://localhost:3000
28
28
 
29
29
  Sign up at `/login` — the first registered user is automatically promoted to the `ampless-admin` Cognito group.
30
30
 
31
+ ## One-shot deploy: `--deploy`
32
+
33
+ The wizard can also take you all the way from `npx` to a live Amplify Hosting URL:
34
+
35
+ ```bash
36
+ npx create-ampless@alpha my-site --deploy
37
+ ```
38
+
39
+ That extra flag, after scaffolding, runs:
40
+
41
+ 1. `git init` + initial commit
42
+ 2. Create a GitHub repo (`gh repo create`) and push
43
+ 3. `aws amplify create-app` linked to the new repo
44
+ 4. `aws amplify create-branch main`
45
+ 5. `aws amplify start-job --job-type RELEASE`
46
+ 6. Optional `aws amplify create-domain-association` if you pass `--domain`
47
+
48
+ Anything missing on the command line gets asked interactively. For CI-friendly fully-flagged usage:
49
+
50
+ ```bash
51
+ npx create-ampless@alpha my-site --deploy \
52
+ --github-owner my-org \
53
+ --github-private \
54
+ --aws-region us-east-1 \
55
+ --domain example.com --subdomain blog \
56
+ --skip-confirm
57
+ ```
58
+
59
+ If the apex domain is hosted in Route 53 in the same AWS account, Amplify will auto-create the DNS records once ACM validates. Otherwise the CLI prints the exact CNAMEs to add at your registrar.
60
+
61
+ ### Deploy requirements
62
+
63
+ - [`gh`](https://cli.github.com/) installed and authenticated (`gh auth login`)
64
+ - [`aws`](https://aws.amazon.com/cli/) installed and configured (`aws configure`)
65
+ - A GitHub token with `repo` scope (resolved via `--github-token` → `GITHUB_TOKEN` env → `gh auth token` → interactive prompt)
66
+
31
67
  ## Requirements
32
68
 
33
69
  - Node.js >= 20