ZIP からデプロイする

ZIP アップロードは、Git リポジトリを使わずに手元のプロジェクトをすぐ公開できるデプロイ方式です。ZIP をアップロードすると、hanamii がビルドから公開まで自動で行います。

ZIP アップロードは Node.js（Next.js を含む）・Python・PHP のプロジェクトに対応しています。Next.js 以外の構成例は Next.js 以外のアプリをデプロイする を参照してください。

ChatGPT や Gemini で作ったアプリを公開する場合は、コピペ用プロンプト付きの専用ガイドが便利です。

デプロイの流れ

1. プロジェクト一覧の プロジェクトを作成 から「ファイルをアップロード」を選ぶ
2. プロジェクトの ZIP ファイルをドラッグ＆ドロップ（または選択）する
3. 自動でファイル検証が実行される（「ファイルを検証中...」）
4. 検証を通過したらデプロイが始まり、完了すると公開 URL が発行される

ZIP ファイルの作り方

プロジェクトのソースコード一式 を ZIP にまとめます。ビルドは hanamii 側で実行されるため、事前のビルドは不要です。

my-app/
├── package.json      ← 必須（scripts.start の定義も必須）
├── next.config.js
├── src/
└── public/

含めてはいけないもの

以下のディレクトリは ZIP に含めないでください（含まれていた場合も自動で除外されますが、ZIP が大きいほど検証に時間がかかります）。

• node_modules/（依存パッケージは hanamii 側でインストールされます）
• .next/、dist/、build/ などのビルド成果物
• .git/
• __MACOSX/（macOS の Finder で圧縮した際に生成されます）

また、.env などのシークレットを含むファイルは必ず除外してください。環境変数はアップロード後に環境変数タブから安全に設定できます。

macOS / Windows での圧縮方法

• macOS: プロジェクトフォルダを右クリック →「圧縮」。またはターミナルで zip -r my-app.zip . -x "node_modules/*" ".next/*" ".git/*" ".env*"
• Windows: プロジェクトフォルダを右クリック →「送る」→「圧縮 (zip 形式) フォルダー」

ZIP の制約

package.json には起動コマンドの定義が必要です。Next.js の場合は次のようになっていれば問題ありません。

{
  "scripts": {
    "build": "next build",
    "start": "next start"
  }
}

検証エラーが出たら

アップロード時の検証で問題が見つかると、エラー内容が表示されます。代表的なもの:

エラー画面では 全エラーをAI用にコピー ボタンでエラー内容をまとめてコピーできます。ChatGPT や Claude などの AI アシスタントに貼り付けて修正方法を相談し、修正版を再アップロードする、という流れで解決できます。

再デプロイ

コードを修正したら、プロジェクト詳細の 再デプロイ ボタンから新しい ZIP をアップロードして再デプロイできます。