初めてのサイト
GitHub リポジトリに接続し、最初の公開を行います。
このガイドでは、クイックスタート より詳しく手順を説明します。リポジトリを接続し、Showly が生成したサイトマニフェストを確認し、エディターで変更して公開します。
リポジトリに接続する
ワークスペースのホームから、[サイトに接続] をクリックします。 GitHub アプリダイアログが開きます。選ぶ：
- リポジトリを所有する組織または個人のアカウント
- 接続するリポジトリ
GitHub アプリは、選択したリポジトリで コンテンツ: 読み取りと書き込み をリクエストします。 GitHub は、これをブランチごとではなくリポジトリ レベルで許可します。製品ポリシーとして、Showly は showly/* プレフィックスの下にあるブランチにのみコミットします。デフォルトのブランチにはプッシュされません。
承認後、ワークスペースにリポジトリが インポート中 のステータスで表示されます。
サイトマニフェストを確認する
インポート ステップでは、インポートされたワークスペースに showly.json マニフェストを書き込みます。これは自動検出された開始点です。Showly はリポジトリを検査し、値を提案します。後で任意のフィールドを確認して上書きできます。次のようになります。
{
"rootDirectory": ".",
"runtime": "node",
"runtimeVersion": "22",
"packageManager": "pnpm",
"installCommand": "pnpm install",
"buildCommand": "pnpm build",
"output": {
"directory": ".next"
}
}フレームワークは自動的に検出されるため (Showly は Astro、Vite、Next.js エクスポート、およびプレーンな静的 HTML を認識します)、マニフェストで設定するフィールドではありません。
マニフェストは、Showly がすべてのビルドとエージェントのコンテキスト取得に使用する信頼できる情報源です。リポジトリのビルド手順を変更したら、マニフェストも更新してください。完全なスキーマとフィールド一覧はサイトマニフェストを参照してください。
環境変数を設定する
サイトの 環境 パネルを開き、ビルドとランタイムに必要な変数を設定します。 Showly はリポジトリからシークレットを読み取ることはありません。環境ごとに設定するため (preview、production)、プレビュー ビルドでは運用環境とは異なる値を使用できます。
エディターで変更を加える
Showly エディタは、ファイル ツリーの横にチャット パネルを開きます。試す：
短い略歴を含む新しいルート /about を追加します。
エージェントは、作成するファイルをリストした変更計画で応答します。 [プランの適用] をクリックして、分離されたワークスペースでパッチを具体化し、ビルドし、プレビューを生成します。
ビルドは queued → building を経て、ready に到達します (通常の小さな変更には 1 分もかかりません)。 ready に達すると、プレビュー URL が [プレビュー] パネルに表示されます。これを開いて、分離されたプレビュー展開で変更がライブであることを確認します。ビルドが failed で終了する場合は、デプロイメントを展開してビルド ログを読み取り、問題 (多くの場合、マニフェスト内のビルド コマンドまたはランタイム設定) を修正して、再度適用します。
公開
[リリース] パネルで、出荷する ready プレビューを選択します。公開には OTP/MFA 登録は必要ありません。
誰が承認できるかはあなたの計画によって異なります。承認ワークフローが有効になっているプランでは、公開リクエストには owner または admin からの 1 つの承認が必要であり、リクエスト者は自己承認できません。 Free と Pro には 2 人目のレビュー担当者はいません。[公開] をクリックするか、エージェントの 2 段階の publish_site 確認を使用します。
今練習したこと
- GitHub インポート → サイトマニフェスト
- 環境ごとの環境変数
- チャット → 計画変更 → パッチ → プレビュー
- 承認→本番公開
これがパブリッシュ ループ全体です。 Showly の後のすべてのワークフローは、これと同じパスのバリエーションです。