create-ampless 0.2.0-alpha.18 → 0.2.0-alpha.19

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.
@@ -0,0 +1,182 @@
1
+ > English: [README.md](./README.md)
2
+ >
3
+ # {{siteName}}
4
+
5
+ このサイトは [ampless](https://github.com/heavymoons/ampless) で構築されています — AWS Amplify Gen 2(Cognito + DynamoDB + S3 + AppSync + Lambda)上で動くサーバーレス CMS、フロントエンドは Next.js 15。
6
+
7
+ この README は、サイト運営者として日常的に知っておくべき内容をまとめたものです。たまにやる運用手順(API キーのローテーション、バックアップ復元など)は [RUNBOOK.ja.md](./RUNBOOK.ja.md) に置いています。テーマごとのカスタマイズ詳細は `themes/<name>/README.ja.md` を参照してください。
8
+
9
+ ## 必要なもの
10
+
11
+ - **Node.js 20+** と **npm**
12
+ - **AWS アカウント**と CLI 認証情報(`aws configure`)— sandbox / 本番ともに実 AWS リソースをデプロイします
13
+ - 本番ホスティング(AWS Amplify Hosting)用の **GitHub アカウント**
14
+
15
+ ## コマンド
16
+
17
+ | コマンド | 内容 |
18
+ | --- | --- |
19
+ | `npm install` | 依存関係をインストール |
20
+ | `npm run sandbox` | 個人用 AWS サンドボックス(Cognito / DynamoDB / S3 など)をプロビジョニング、`amplify_outputs.json` を再生成し、`next dev` を `http://localhost:3000` で起動 |
21
+ | `npm run dev` | Next.js だけを起動(サンドボックスのプロビジョニングはスキップ — 一度 `sandbox` を実行済みなら使える) |
22
+ | `npm run build` | Next.js アプリの本番ビルド(Amplify Hosting のデプロイでも自動実行される) |
23
+ | `npm run start` | ビルド済みアプリをローカルで配信 |
24
+ | `npm run lint` | `next lint` で lint |
25
+ | `npm run update-ampless` | ampless テンプレートの最新ファイルを取り込む(設定やテーマは保持。下記「ampless の更新」参照) |
26
+ | `npm run copy-theme` | 公式テーマを後から追加する |
27
+
28
+ ## 初回セットアップ
29
+
30
+ ```bash
31
+ npm install
32
+ npm run sandbox
33
+ ```
34
+
35
+ 初回 sandbox は 5〜10 分かかります(AWS リソースのプロビジョニング)。`next dev` 起動前に毎回 `amplify_outputs.json` が再生成されます。
36
+
37
+ [http://localhost:3000/login](http://localhost:3000/login) を開き、**Create admin account** をクリック。最初に登録したユーザーが自動的に `ampless-admin` Cognito グループに追加されます。
38
+
39
+ ## 管理画面
40
+
41
+ サインイン後、管理画面は `/admin`:
42
+
43
+ | パス | 役割 |
44
+ | --- | --- |
45
+ | `/admin` | ダッシュボード |
46
+ | `/admin/posts` | 投稿の一覧 / 作成 / 編集(Tiptap、Markdown、生 HTML、または zip アップロードの静的バンドル) |
47
+ | `/admin/media` | 画像 / 動画 / ファイルを S3 にアップロード |
48
+ | `/admin/sites/<siteId>` | サイトレベル設定(名前、URL) |
49
+ | `/admin/sites/<siteId>/theme` | テーマの切り替え + フィールド調整(カラー、フォント、ナビ、ロゴなど) |
50
+ | `/admin/users` | ユーザー一覧と Cognito グループ所属の確認 |
51
+ | `/admin/mcp-tokens` | HTTP MCP エンドポイント用の Bearer トークンを発行 |
52
+
53
+ ユーザーロール(Cognito グループ):
54
+
55
+ - `ampless-admin` — フルアクセス(コンテンツ + 運用 + 破壊的操作)
56
+ - `ampless-editor` — コンテンツの CRUD(破壊的操作はなし)
57
+ - `ampless-reader` — 将来の REST/MCP API クライアント用に予約
58
+
59
+ ロールの付与 / 取り消しは AWS Cognito コンソールで行います — [RUNBOOK.ja.md → ユーザーの昇格 / 降格](./RUNBOOK.ja.md#promote--demote-a-user) を参照。
60
+
61
+ ## コンテンツの執筆
62
+
63
+ 投稿(Post)が唯一のコンテンツタイプです。各投稿には以下があります:
64
+
65
+ - **Format** — `tiptap`(リッチテキスト)/ `markdown` / `html`(生 HTML、サニタイズなし)/ `static`(HTML/CSS/JS の zip アップロード)
66
+ - **No layout** フラグ(`format: 'html'` のときのみ)— 本文をそのまま出力し、Next.js のレイアウトもテーマのクロームも適用しない。URL は `/<slug>` のままで、ルートが `/raw/<slug>` にリダイレクトする
67
+ - **Slug** — 公開 URL
68
+ - **Status** — `draft`(管理者のみ)または `published`
69
+
70
+ 詳細リファレンス: [docs/CONTENT.ja.md(GitHub)](https://github.com/heavymoons/ampless/blob/main/docs/CONTENT.ja.md) ([English](https://github.com/heavymoons/ampless/blob/main/docs/CONTENT.md))
71
+
72
+ ## テーマ
73
+
74
+ インストール済みのテーマはすべて `themes/<name>/` にバンドルされています。**アクティブな**テーマはサイトごとのランタイム設定 — テーマの切り替えに**再デプロイは不要**です。
75
+
76
+ アクティブテーマの切り替え: `/admin/sites/<siteId>/theme` → インストール済みリストから選択 → 保存。
77
+
78
+ アクティブテーマのカスタマイズ(カラー、フォント、ヘッダー / フッターナビなど): 同じ画面 — 各テーマが固有のカスタマイズフィールドを公開しています。各テーマで何が変えられるかは `themes/<name>/README.ja.md` を参照。
79
+
80
+ このプロジェクトに別の公式テーマを追加する:
81
+
82
+ ```bash
83
+ npm run copy-theme
84
+ ```
85
+
86
+ 独自テーマを作る場合: 既存テーマをコピーから始める(`cp -R themes/blog themes/your-theme`)→ `manifest.ts`、`tokens.css`、`pages/*.tsx` を編集 → `themes-registry.ts` に追加。フルガイド: [docs/THEMES.ja.md](https://github.com/heavymoons/ampless/blob/main/docs/THEMES.ja.md) ([English](https://github.com/heavymoons/ampless/blob/main/docs/THEMES.md))
87
+
88
+ ## プラグイン
89
+
90
+ プラグインは CMS にイベント駆動の副作用(SEO メタデータ、RSS フィード、外部 URL への webhook、OG 画像生成など)を追加する仕組みです。[`cms.config.ts`](./cms.config.ts) で宣言し、投稿の publish / update / delete 時に Lambda 上で実行されます。
91
+
92
+ `cms.config.ts` に書けば有効になる、同梱の公式プラグイン:
93
+
94
+ | パッケージ | 役割 |
95
+ | --- | --- |
96
+ | `@ampless/plugin-seo` | 投稿ごとの OGP / Twitter / canonical メタデータ + `sitemap.xml` |
97
+ | `@ampless/plugin-rss` | `/feed.xml` の RSS 2.0 フィード |
98
+ | `@ampless/plugin-webhook` | 外部 URL へのイベント POST(HMAC 署名付き) |
99
+ | `@ampless/plugin-og-image` | `/og/<slug>` での動的 OG 画像生成 |
100
+
101
+ プラグインを追加するには: install(`npm i @ampless/plugin-...`)→ `cms.config.ts` で import → `plugins` 配列に追加:
102
+
103
+ ```ts
104
+ import seoPlugin from '@ampless/plugin-seo'
105
+ import rssPlugin from '@ampless/plugin-rss'
106
+
107
+ export default defineConfig({
108
+ // ...
109
+ plugins: [
110
+ seoPlugin({ twitterSite: '@example' }),
111
+ rssPlugin({ language: 'ja', limit: 20 }),
112
+ ],
113
+ })
114
+ ```
115
+
116
+ プラグイン変更には再デプロイが必要です(プラグインコードは Lambda バンドルに含まれます)。
117
+
118
+ ## 本番デプロイ
119
+
120
+ 同梱の [`amplify.yml`](./amplify.yml) が、connect したブランチへの push のたびに `npx ampx pipeline-deploy`(Amplify バックエンド) + `npm run build`(Next.js)を実行します。
121
+
122
+ 1. **GitHub(または Amplify Hosting が対応する git ホスト)にこのプロジェクトを push**:
123
+ ```bash
124
+ git init && git add . && git commit -m "init"
125
+ git remote add origin <your-repo>
126
+ git push -u origin main
127
+ ```
128
+ 2. **AWS Amplify Hosting コンソール** → **Create new app** → **Host web app** → リポジトリを連携 → ブランチを選択 → 自動検出されたビルド設定(`amplify.yml` の内容になっているはず)を確認 → デプロイ
129
+ 3. 初回デプロイは 10〜20 分。以降は連携ブランチへの push で自動再デプロイ
130
+
131
+ ### 環境変数
132
+
133
+ 環境ごとの値は **Amplify Hosting コンソール → Hosting → Environment variables** で設定。よく使うもの:
134
+
135
+ | 変数 | 利用箇所 |
136
+ | --- | --- |
137
+ | `WEBHOOK_SECRET` | `@ampless/plugin-webhook` の HMAC 署名 |
138
+ | `AMPLESS_MCP_SERVICE_EMAIL` | HTTP MCP サービスユーザーのメール — `/api/mcp` を有効化するのに必須 |
139
+ | `AMPLESS_MCP_SERVICE_PASSWORD` | HTTP MCP サービスユーザーのパスワード |
140
+
141
+ env 変数追加 / 変更後は再デプロイをトリガーしてください。
142
+
143
+ ### カスタムドメイン
144
+
145
+ Amplify Hosting アプリの **Domain management** からドメインをバインドします — ACM 証明書と DNS レコードは Amplify が自動でプロビジョニングします。詳細手順: [RUNBOOK.ja.md → カスタムドメインを Amplify Hosting に追加](./RUNBOOK.ja.md#adding-a-custom-domain-to-amplify-hosting)
146
+
147
+ ### マルチサイト(複数ドメインを 1 デプロイで)
148
+
149
+ ampless は 1 つの Amplify Hosting デプロイで複数のサイトを配信できます。各サイトは独自の `siteId`、ホスト名、サイト名、アクティブテーマを持ちます。有効化するには、`cms.config.ts` の `sites:` ブロック(コメントアウト例あり)を埋めてデプロイ。
150
+
151
+ マルチサイトモードにはキャッシュ周りのトレードオフがあります。詳細: [RUNBOOK.ja.md → マルチサイト / カスタムドメイン](./RUNBOOK.ja.md#multi-site--custom-domains)
152
+
153
+ ## AI 連携(MCP)
154
+
155
+ ampless は MCP(Model Context Protocol)サーバーを同梱しているので、Claude Desktop / Cursor / Claude Code など MCP に対応した AI クライアントから投稿の読み書きができます。
156
+
157
+ - **ローカル / sandbox** — グローバルに 1 度入れる: `npx -y @ampless/mcp-server@alpha` に `amplify_outputs.json` のパスを渡す
158
+ - **本番(HTTP)** — `/admin/mcp-tokens` で Bearer トークンを発行し、MCP クライアントを `https://<your-domain>/api/mcp` に向ける。フルセットアップ: [docs/mcp-http-setup.ja.md](https://github.com/heavymoons/ampless/blob/main/docs/mcp-http-setup.ja.md) ([English](https://github.com/heavymoons/ampless/blob/main/docs/mcp-http-setup.md))
159
+
160
+ ## ampless の更新
161
+
162
+ ampless は `alpha` dist-tag でリリースしています。新機能を取り込むには:
163
+
164
+ ```bash
165
+ npm run update-ampless
166
+ ```
167
+
168
+ これは `npx create-ampless@latest upgrade` を実行し、以下を行います:
169
+
170
+ - `package.json` の `@ampless/*` / `ampless` 依存をバージョンアップ
171
+ - 共有テンプレートファイル(admin アプリの土台、amplify バックエンド、lib/、middleware、テーマ)を再同期 — `cms.config.ts`、`theme.*` 管理画面設定、投稿、テーマ manifest 値などのユーザーカスタマイズは保持されます
172
+ - `update-ampless` / `copy-theme` スクリプトのコマンドが変わっていれば更新
173
+
174
+ commit 前に diff を確認できます。
175
+
176
+ ## 運用
177
+
178
+ 日常以外の運用レシピ — ユーザー昇格、パスワードリセット、バックアップ復元、カスタムドメイン配線、AppSync API キーローテーション、マルチサイト構築 — は [RUNBOOK.ja.md](./RUNBOOK.ja.md) にあります。
179
+
180
+ ## ライセンス
181
+
182
+ このプロジェクト自身のコードはあなたのものです。ampless 本体は MIT ライセンスです。詳細は [ampless リポジトリ](https://github.com/heavymoons/ampless) を参照。
@@ -0,0 +1,182 @@
1
+ > 日本語版: [README.ja.md](./README.ja.md)
2
+ >
3
+ # {{siteName}}
4
+
5
+ Your site is built with [ampless](https://github.com/heavymoons/ampless) — a serverless CMS that runs on AWS Amplify Gen 2 (Cognito + DynamoDB + S3 + AppSync + Lambda) with a Next.js 15 frontend.
6
+
7
+ This README covers what you, the site owner, need to know day-to-day. Operational recipes (rotating keys, restoring backups, etc.) live in [RUNBOOK.md](./RUNBOOK.md). Per-theme customization details live in `themes/<name>/README.md`.
8
+
9
+ ## Requirements
10
+
11
+ - **Node.js 20+** and **npm**
12
+ - **AWS account** with CLI credentials (`aws configure`) — the sandbox + production both deploy real AWS resources
13
+ - **GitHub account** for production hosting via AWS Amplify Hosting
14
+
15
+ ## Commands
16
+
17
+ | Command | What it does |
18
+ | --- | --- |
19
+ | `npm install` | Install dependencies |
20
+ | `npm run sandbox` | Provision a personal AWS sandbox (Cognito / DynamoDB / S3 / etc.), regenerate `amplify_outputs.json`, then start `next dev` on `http://localhost:3000` |
21
+ | `npm run dev` | Start Next.js only (skip sandbox provisioning — use after `sandbox` has already run once) |
22
+ | `npm run build` | Production build of the Next.js app (also runs as part of Amplify Hosting deploy) |
23
+ | `npm run start` | Serve the production build locally |
24
+ | `npm run lint` | Lint with `next lint` |
25
+ | `npm run update-ampless` | Pull the latest ampless template files into this project, preserving your config and themes (see "Updating ampless" below) |
26
+ | `npm run copy-theme` | Add another official theme to this project after-the-fact |
27
+
28
+ ## First time setup
29
+
30
+ ```bash
31
+ npm install
32
+ npm run sandbox
33
+ ```
34
+
35
+ First sandbox run takes 5–10 minutes (AWS resource provisioning). `amplify_outputs.json` is regenerated each time before `next dev` starts.
36
+
37
+ Open [http://localhost:3000/login](http://localhost:3000/login) and click **Create admin account**. The first registered user is automatically added to the `ampless-admin` Cognito group.
38
+
39
+ ## Admin UI
40
+
41
+ After signing in, the admin lives at `/admin`:
42
+
43
+ | Path | Purpose |
44
+ | --- | --- |
45
+ | `/admin` | Dashboard |
46
+ | `/admin/posts` | List / create / edit posts (Tiptap editor, Markdown, raw HTML, or zip-uploaded static bundles) |
47
+ | `/admin/media` | Upload images / videos / files to S3 |
48
+ | `/admin/sites/<siteId>` | Site-level settings (name, URL) |
49
+ | `/admin/sites/<siteId>/theme` | Activate a theme + customize its fields (colors, fonts, nav, logo, etc.) |
50
+ | `/admin/users` | View users + Cognito group memberships |
51
+ | `/admin/mcp-tokens` | Issue Bearer tokens for the HTTP MCP endpoint |
52
+
53
+ User roles (Cognito groups):
54
+
55
+ - `ampless-admin` — full access (content + ops + destructive)
56
+ - `ampless-editor` — content CRUD (no destructive ops)
57
+ - `ampless-reader` — reserved for future REST/MCP API consumers
58
+
59
+ Promotion/demotion is done in the AWS Cognito console — see [RUNBOOK.md → Promote / demote a user](./RUNBOOK.md#promote--demote-a-user).
60
+
61
+ ## Authoring content
62
+
63
+ Posts are the single content type. Each post has:
64
+
65
+ - **Format** — `tiptap` (rich text) / `markdown` / `html` (raw, no sanitization) / `static` (zip-upload of HTML/CSS/JS)
66
+ - **No layout** flag (`format: 'html'` only) — render the body verbatim with no Next.js layout and no theme chrome. URL stays `/<slug>`; the route redirects to `/raw/<slug>`.
67
+ - **Slug** — the public URL
68
+ - **Status** — `draft` (admin only) or `published`
69
+
70
+ Full reference: [docs/CONTENT.md on GitHub](https://github.com/heavymoons/ampless/blob/main/docs/CONTENT.md) ([日本語](https://github.com/heavymoons/ampless/blob/main/docs/CONTENT.ja.md)).
71
+
72
+ ## Themes
73
+
74
+ Every installed theme is bundled in this project under `themes/<name>/`. The **active** theme per site is a runtime setting — switching themes does **not** require a redeploy.
75
+
76
+ To switch the active theme: `/admin/sites/<siteId>/theme` → pick from the installed list → save.
77
+
78
+ To customize the active theme (colors, fonts, header / footer nav, etc.): same page — each theme exposes its own customization fields. See `themes/<name>/README.md` for what's customizable per theme.
79
+
80
+ To install another official theme into this project:
81
+
82
+ ```bash
83
+ npm run copy-theme
84
+ ```
85
+
86
+ To author your own theme: copy an existing one as a starting point (`cp -R themes/blog themes/your-theme`), edit `manifest.ts`, `tokens.css`, and `pages/*.tsx`, then add it to `themes-registry.ts`. Full guide: [docs/THEMES.md](https://github.com/heavymoons/ampless/blob/main/docs/THEMES.md) ([日本語](https://github.com/heavymoons/ampless/blob/main/docs/THEMES.ja.md)).
87
+
88
+ ## Plugins
89
+
90
+ Plugins extend the CMS with event-driven side effects (SEO metadata, RSS feed, webhooks to external URLs, OG image generation, etc.). They're declared in [`cms.config.ts`](./cms.config.ts) and run on Lambda when posts are published / updated / deleted.
91
+
92
+ Bundled and ready to enable in `cms.config.ts`:
93
+
94
+ | Package | Purpose |
95
+ | --- | --- |
96
+ | `@ampless/plugin-seo` | Per-post OGP / Twitter / canonical metadata + `sitemap.xml` |
97
+ | `@ampless/plugin-rss` | RSS 2.0 feed at `/feed.xml` |
98
+ | `@ampless/plugin-webhook` | POST events to external URLs (HMAC-signed) |
99
+ | `@ampless/plugin-og-image` | Dynamic Open Graph image generation at `/og/<slug>` |
100
+
101
+ To add a plugin: install (`npm i @ampless/plugin-...`), import in `cms.config.ts`, and add to the `plugins` array:
102
+
103
+ ```ts
104
+ import seoPlugin from '@ampless/plugin-seo'
105
+ import rssPlugin from '@ampless/plugin-rss'
106
+
107
+ export default defineConfig({
108
+ // ...
109
+ plugins: [
110
+ seoPlugin({ twitterSite: '@example' }),
111
+ rssPlugin({ language: 'en', limit: 20 }),
112
+ ],
113
+ })
114
+ ```
115
+
116
+ A redeploy is required for plugin changes (the plugin code ships in the Lambda bundle).
117
+
118
+ ## Deploying to production
119
+
120
+ The shipped [`amplify.yml`](./amplify.yml) runs `npx ampx pipeline-deploy` (Amplify backend) + `npm run build` (Next.js) on every push to the branch you connect.
121
+
122
+ 1. **Push this project to GitHub** (or another git host Amplify Hosting supports):
123
+ ```bash
124
+ git init && git add . && git commit -m "init"
125
+ git remote add origin <your-repo>
126
+ git push -u origin main
127
+ ```
128
+ 2. **AWS Amplify Hosting console** → **Create new app** → **Host web app** → connect the repo → pick the branch → review the auto-detected build settings (they should match `amplify.yml`) → deploy.
129
+ 3. First deploy takes 10–20 minutes. Subsequent pushes to the connected branch redeploy automatically.
130
+
131
+ ### Environment variables
132
+
133
+ Set per-environment values in **Amplify Hosting console → Hosting → Environment variables**. Common ones:
134
+
135
+ | Variable | Used by |
136
+ | --- | --- |
137
+ | `WEBHOOK_SECRET` | `@ampless/plugin-webhook` HMAC signing |
138
+ | `AMPLESS_MCP_SERVICE_EMAIL` | HTTP MCP service-user email — required to enable `/api/mcp` |
139
+ | `AMPLESS_MCP_SERVICE_PASSWORD` | HTTP MCP service-user password |
140
+
141
+ Trigger a redeploy after adding/changing env vars.
142
+
143
+ ### Custom domains
144
+
145
+ Bind a domain to your Amplify Hosting app in **Domain management** — Amplify provisions an ACM certificate and DNS records automatically. Full step-by-step: [RUNBOOK.md → Adding a custom domain](./RUNBOOK.md#adding-a-custom-domain-to-amplify-hosting).
146
+
147
+ ### Multi-site (multiple domains, one deploy)
148
+
149
+ ampless can serve multiple sites from a single Amplify Hosting deployment. Each site has its own `siteId`, hostname(s), name, and active theme. To enable, fill in the `sites:` block in `cms.config.ts` (it's there as a commented example) and deploy.
150
+
151
+ There's a caching trade-off in multi-site mode; details in [RUNBOOK.md → Multi-site / custom domains](./RUNBOOK.md#multi-site--custom-domains).
152
+
153
+ ## AI integration (MCP)
154
+
155
+ ampless ships an MCP (Model Context Protocol) server so Claude Desktop / Cursor / Claude Code / anything that speaks MCP can read and write your posts.
156
+
157
+ - **Local / sandbox** — install once globally: `npx -y @ampless/mcp-server@alpha` with the path to your `amplify_outputs.json`.
158
+ - **Production (HTTP)** — issue a Bearer token at `/admin/mcp-tokens` and point your MCP client at `https://<your-domain>/api/mcp`. Full setup: [docs/mcp-http-setup.md](https://github.com/heavymoons/ampless/blob/main/docs/mcp-http-setup.md) ([日本語](https://github.com/heavymoons/ampless/blob/main/docs/mcp-http-setup.ja.md)).
159
+
160
+ ## Updating ampless
161
+
162
+ ampless releases on the `alpha` dist-tag. To pick up new features:
163
+
164
+ ```bash
165
+ npm run update-ampless
166
+ ```
167
+
168
+ This runs `npx create-ampless@latest upgrade`, which:
169
+
170
+ - Bumps the `@ampless/*` and `ampless` dependencies in `package.json`
171
+ - Re-syncs the shared template files (admin app shell, amplify backend, lib/, middleware, themes) — your customizations to `cms.config.ts`, `theme.*` admin settings, posts, and theme manifest values are preserved.
172
+ - Updates `update-ampless` and `copy-theme` script entries if their commands change
173
+
174
+ You can review the diff before committing.
175
+
176
+ ## Operations
177
+
178
+ Day-to-day operational recipes — user promotion, password reset, backup restore, custom domain wiring, AppSync API key rotation, multi-site setup — live in [RUNBOOK.md](./RUNBOOK.md).
179
+
180
+ ## License
181
+
182
+ This project's own code is yours. ampless itself is MIT-licensed; see the [ampless repository](https://github.com/heavymoons/ampless) for details.
@@ -3,7 +3,22 @@
3
3
 
4
4
  # ランブック
5
5
 
6
- ampless で構築したサイトの運用手順書です。
6
+ ampless で構築したサイトで、ときどき必要になる運用作業の手順集です。毎日やるわけではないけれど、いざ必要になったときに迷わずに進めるためのものです。
7
+
8
+ 日常的な使い方(コマンド、管理画面、テーマ、プラグイン、デプロイなど)は [README.ja.md](./README.ja.md) を参照してください。
9
+
10
+ ## 目次
11
+
12
+ - [AppSync API キー(自動更新)](#appsync-api-キー自動更新)
13
+ - [よくある運用](#よくある運用)
14
+ - [ユーザーの昇格 / 降格](#promote--demote-a-user)
15
+ - [パスワードリセット(管理者上書き)](#reset-a-users-password-admin-override)
16
+ - [Post テーブルのバックアップから復元](#restore-from-a-post-table-backup)
17
+ - [失敗したプラグインイベントを確認する](#inspect-failed-plugin-events)
18
+ - [マルチサイト / カスタムドメイン](#multi-site--custom-domains)
19
+ - [シングルドメイン運用](#single-domain-operation)
20
+ - [マルチサイト時の注意:SSR キャッシュは強制無効化](#multi-site-mode-caveat-ssr-caching-is-force-disabled)
21
+ - [カスタムドメインを Amplify Hosting に追加する](#adding-a-custom-domain-to-amplify-hosting)
7
22
 
8
23
  ## AppSync API キー(自動更新)
9
24
 
@@ -3,7 +3,22 @@
3
3
 
4
4
  # Runbook
5
5
 
6
- Operational tasks for an ampless-powered site.
6
+ Step-by-step recipes for occasional operations on an ampless-powered site — the things you don't do every day but want a reliable procedure for when you do.
7
+
8
+ For day-to-day usage (commands, admin UI tour, themes, plugins, deploying), start with [README.md](./README.md).
9
+
10
+ ## Contents
11
+
12
+ - [AppSync API key (auto-renewed)](#appsync-api-key-auto-renewed)
13
+ - [Common operations](#common-operations)
14
+ - [Promote / demote a user](#promote--demote-a-user)
15
+ - [Reset a user's password (admin override)](#reset-a-users-password-admin-override)
16
+ - [Restore from a Post-table backup](#restore-from-a-post-table-backup)
17
+ - [Inspect failed plugin events](#inspect-failed-plugin-events)
18
+ - [Multi-site / custom domains](#multi-site--custom-domains)
19
+ - [Single domain operation](#single-domain-operation)
20
+ - [Multi-site mode caveat: SSR caching is force-disabled](#multi-site-mode-caveat-ssr-caching-is-force-disabled)
21
+ - [Adding a custom domain to Amplify Hosting](#adding-a-custom-domain-to-amplify-hosting)
7
22
 
8
23
  ## AppSync API key (auto-renewed)
9
24
 
@@ -26,7 +26,7 @@
26
26
  "@ampless/plugin-rss": "^0.2.0-alpha.6",
27
27
  "@ampless/plugin-seo": "^0.2.0-alpha.6",
28
28
  "@ampless/plugin-webhook": "^0.2.0-alpha.6",
29
- "@ampless/admin": "^0.2.0-alpha.17",
29
+ "@ampless/admin": "^0.2.0-alpha.18",
30
30
  "@ampless/backend": "^0.2.0-alpha.8",
31
31
  "@ampless/runtime": "^0.2.0-alpha.9",
32
32
  "@digital-go-jp/tailwind-theme-plugin": "^0.3.4",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-ampless",
3
- "version": "0.2.0-alpha.18",
3
+ "version": "0.2.0-alpha.19",
4
4
  "description": "Create a new ampless project",
5
5
  "license": "MIT",
6
6
  "type": "module",